How to hack bastiat.org

This is the source code for the bastiat.org website dedicated to the life and works of Frédéric Bastiat.

Installing the toolchain

1. Install sbcl. On Ubuntu and other debian-based distributions, use:

sudo apt-get install sbcl

2. Download Quicklisp:

wget https://beta.quicklisp.org/quicklisp.lisp

3. Install Quicklisp:

sbcl --load quicklisp.lisp --eval '(quicklisp-quickstart:install)'

4. Download and compile Exscribe:

mkdir -p ~/common-lisp/
cd ~/common-lisp/
git clone https://github.com/fare/fare-scripts.git
git clone https://gitlab.common-lisp.net/frideau/exscribe.git
sbcl --eval '(load "~/quicklisp/setup")' --eval '(ql:quickload :exscribe/executable)'

6. Make sure that your system can find the exscribe program:

# One option is to create a symlink at a well-known location:
sudo ln -sf ~/common-lisp/exscribe/exscribe /usr/local/bin/

# Alternatively, just extend your `$PATH` variable:
PATH=$PATH:~/common-lisp/exscribe

Building the website

Once you've properly installed your toolchain, you can build the website with:

make

Repetitive output will follow that lasts a couple of minutes; be patient it's not an error! Then point your browser to the index file and browse:

make && xdg-open file://$PWD/index.html
make && firefox  file://$PWD/index.html
make && chromium file://$PWD/index.html

Adding a new file

If you add a new file, you need to tell the build system about it with:

make dep

Publishing Changes

Either:

1. Fork the official repository on github, and send a pull request, or

2. Have me add you to the official repository on github, and maybe also get an account on bespin.org. Then you can make bespin to rebuild and publish the website.

Please consult a git tutorial for details.

What to do?

See the TODO.md file. Take an item, break it down until you reach an actionable items, act on it. Or add new items.