title	cuid	trls	lang
Website Publication Files	26e4-a0	nl	en

This describes how I publish selected files from this repository to the Web. Actually, these files are the publication mechanism.

The Engine

The static site is generated with Web Origami.

pipeline.ori contains the main pipeline. site.ori selects some keys from pipeline.ori to create the final site. The reason for this split is: there are a bunch of steps in the pipeline which should not be exposed in the final build, but that do need to be accessible for inspection during development/debugging.

Both files take an argument which specifies whether to build the site in public or private mode. In public mode, only files with a certain tag are included in the output.

Public mode is the default. Run: ori site.ori() or ori pipeline.ori().

For private mode, run: ori 'site.ori("all")' or ori 'pipeline.ori("all")'.

Markup Language

I have developed a text markup format which suits my needs better than Markdown. The parser works and I can render HTML with it, but the feature set is still very limited. For example, I can only render single works in italic. That might seem like an odd sort of limitation, but it's because I've started from somewhat different first principles than the assumptions the HTML/Markdown worfklow is based on. As we all know, the last 10% takes the most work. So to start with, I'm formatting the source files in Markdown.

Markup-taal

Ik heb een formaat ontwikkeld voor tekst die beter bij mijn doelen past dan Markdown.

Internal Links

Internal links need to be absolute from the root of the directory. This SHOULD be fixed in a future version.

Web Origami, Public and Private Site Versions

I want to make only select files public. Files whose name contains the tag pub should be included in the public build. The public build should be the default. To include all files, pass 'all' to the site.ori file. That sort of reduces the risk of accidentally publishing private files.

—private-below—

EXCEPT NOT REALLY! In this case, because this file is hardlinked to README.md inside a publicised git repository. You have been warned!

Organisation

${ada_pubfiles-worklog.md/}