Go to file
muflax 1794b23103 * add old logos (unused for now)
* added milinda story
2011-09-04 23:13:54 +02:00
content * add old logos (unused for now) 2011-09-04 23:13:54 +02:00
drafts * add old logos (unused for now) 2011-09-04 23:13:54 +02:00
layouts improved layout of epistemic status 2011-09-04 23:05:58 +02:00
lib improved layout of epistemic status 2011-09-04 23:05:58 +02:00
tasks rake tasks for deployment 2011-09-04 21:40:45 +02:00
.gitignore basic nanoc setup working 2011-07-31 22:51:41 +02:00
README first commit, builds already 2010-04-28 02:49:23 +02:00
Rakefile rake tasks for deployment 2011-09-04 21:40:45 +02:00
Rules * add kanji so we can always override the deployed site 2011-09-04 21:01:26 +02:00
config.yaml made anything we don't use a 'binary' file 2011-09-04 21:43:56 +02:00

README

Ceci n'est pas un lisez-moi.

Just a few short notes how this stuff works so I don't forget it over time.

Structure
---------
    layout -> templates
    out -> result, upload this
    src -> all content files
    styles -> css files

Each directory in src is a separate (sub-)category. It contains each content
page as a separate text file (*.pdc) of the following form:
    % title
    [content in (pandoc-enhanced) Markdown markup]

Each directory also contains a meta.yaml specifying the necessary metadata, like
the category name, some layout data and so on. Note that each directory inherits
all unset data from its parent.

Any additional data, like images, reside in the same dir as their .pdc and are
just copied with them. (Everything except *.pdc and meta.yaml is.)

Additionally, changelog.pdc is used to build the rss.xml.

Process
-------
webifier.py goes through all directories in src, reads meta.yaml, generates all
necessary metadata out of it and then takes every *.pdc, pipes it through pandoc
and tidy (adding data if necessary) and finally puts the result into out. 

Also, an index.html is generated for every category.

Finally, changelog.html is parsed, transformed into an RSS feed and put at
out/rss.xml.

Done!