Installation available either from .deb, Python package or directly from github.


$ wget
$ sudo dpkg -i pagegen_2.1.1_all.deb

Python package

Install into virtual environment.

$ mkdir pagegen_virtualenv
$ virtualenv pagegen_virtualenv
$ source pagegen_virtualenv/bin/activate
$ pip install pagegen

$ git clone pagegen
$ cd pagegen
$ chmod u+x pagegen
$ echo "skel_dir=$PWD/skel" > ~/.config/pagegen.conf

Test installation

Assuming bash shell, create directory for new site, initialise directory, setup site.conf and finally generate site.

$ mkdir my_site
$ cd my_site
$ <path to pagegen>/pagegen --init --pagegen-conf <path to pagegen.conf>
$ echo -e "base_url=file://$PWD/site" > site.conf
$ <path to pagegen>/pagegen --generate


Python does not seem to detect locale on Mac OS X, returning a ValueError, 'unknown locale'. Try running pagegen command as LC_ALL=en_US.UTF-8 pagegen ... To make permanent add export LC_ALL=en_US.UTF-8 to ~/.profile

Open my_site/site/index.html in a browser to view (typically File > Open).

Alternatively test with a web server, this example uses the Python SimpleHTTPServer.

$ mkdir my_site
$ cd my_site
$ <path to pagegen>/pagegen --init
$ echo -e "base_url=http://localhost:8000" > site.conf
$ <path to pagegen>/pagegen --generate
$ cd site
$ python -m SimpleHTTPServer

Open http://localhost:8000 in a browser to view.