# About Hygiea

[Hygiea](http://inamidst.com/whits/code/hygiea/), named after the asteroid [10 Hygiea](https://en.wikipedia.org/wiki/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](http://inamidst.com/whits/code/hygiea/convert-markdown-drafts) which emacs uses to [automatically convert](http://inamidst.com/whits/2014/emarks) 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](http://inamidst.com/whits/code/hygiea/publish) 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](http://inamidst.com/whits/code/hygiea/generate-feed) to generate the feed. This depends on the files in the publication directory, including the `.published` metadata
* Use the Hygiea [`generate-index` script](http://inamidst.com/whits/code/hygiea/generate-index) 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