About Hygiea

Hygiea, named after the asteroid 10 Hygiea, is the tenth iteration of the Gallimaufry of Whits source code.

There is one input directory, drafts/, which holds Markdown files. This contains a .convert-markdown file which emacs uses to automatically convert the Markdown into corresponding HTML files in the articles/ directory. It is from this directory that articles to be published are selected.

The HTML files are dependent on two files: style.css and script.js, so these need to be present in articles/ to preview them. These could be symlinked to the publication directory, which corresponds to the present year. Hygiea was written for 2014, so the publication directory is 2014/.

To publish a file in articles/, a small script is used:

• Move the article file into the publication directory, e.g. from articles/ into 2014/, preserving metadata
• Store the modification time of the file, in unixtime format, in 2014/.published/filename.html
• The publication directory can now be synchronised with the server
• Use the Hygiea generate-feed script to generate the feed. This depends on the files in the publication directory, including the .published metadata
• Use the Hygiea generate-index script to generate the site index. This depends on the Atom file generated by generate-feed
• The feed and index files can now be synchronised with the server