The Trac Wiki that used to hold this site has been converted to a
wiki-like setup using git, Markdown, Pelican, and m.css.
The git repository is configured to generate the web content from the
Markdown automatically upon receiving a git push
.
linkchecker may also be
useful in validating the generated content.
The Makefile
in this directory makes it easy to test out changes to
the content before pushing them, eg:
will generate the content, run the result through linkchecker
, then
start up a web server on the name and port specified in the Makefile
(which you can override with the HTTP_HOST
and HTTP_PORT
variables) to let you browse the result. Feel free to experiment on
your own copy: there are almost certainly things we could do better
within the Pelican framework, maybe you'll figure them out for us.
The upstream repository is configured to run Pelican automatically on
push and install the result, and to refuse the push if something fails
to compile. It is of course possible to mess things up in ways that
won't cause compilation to fail, so don't do that. :)
As with all Cryptech git repositories, all commits to this repository
must be signed by a known key.
The push-to-compile hook may need tweaking once we've had a little
experience with it.