A static weblog generator
Simplified static site generation
Quiescent does very little magic and aims only to simplify the annoying or boring parts of site creation, so that the focus remains on content. As such, the only parts of the resulting site that are automatically generated are the Atom feed, an index page, and an archive of all posts.
pip install quiescent
The interface to the program is through the quiescent command, which takes an optional argument -c or --config, to name a configuration .ini file other than the default config.ini.
cd blog-dir/ quiescent --bootstrap # initial configuration quiescent # equivalent to quiescent --config config.ini
In order for the program to run as intended, the config.ini file must be modified to suit the destination site.
The following templates are required and included in the bootstrap command upon initial configuration:
Tips for Writing
All posts written require a title and a date using a specific format at the beginning of the markdown file. The format is as follows:
title: <post title> date: <must match the configured date format> +++
An important note to keep in mind when writing posts, the links used in referencing local media (images, style sheets, etc.) are used directly in the Atom feed, which may break relative URLs. A solution to this (and the author’s recommendation) is to specify a base URL and link relative to that, so that links resolve correctly throughout the generated content of the site.
Due to the design of quiescent, the contents and directory output from the generation process is suitable for any basic web-server capable of serving static files. In the case of the project author, after the site is built, simply rsync-ing the entire build directory is sufficient, for example:
cd build-directory rsync -avz . firstname.lastname@example.org:/static/file/directory
Because of the wide variety of static site generators available this project has a specific focus, with no plans to implement the following:
- a local web-server
- multiple input formats
The project contains some unittests which are runnable using the setup.py command and require no additional dependencies or configuration.
$ python setup.py -q test .................. ---------------------------------------------------------------------- Ran 18 tests in 0.018s OK
GPLv3, see COPYING for more information