59 lines
2.4 KiB
Markdown
59 lines
2.4 KiB
Markdown
---
|
|
title: Website Publication Files
|
|
cuid: 26e4-a0
|
|
trls: [ nl ]
|
|
lang: en
|
|
---
|
|
|
|
This describes how I publish selected files from this repository to the Web. Actually, these files _are_ the publication mechanism.
|
|
|
|
<!--summary-above-->
|
|
|
|
|
|
## The Engine
|
|
The static site is generated with [Web Origami](https://weborigami.org).
|
|
|
|
`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")'`.
|
|
|
|
<trl-group>
|
|
<trl-alt lang="en">
|
|
|
|
## 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.
|
|
|
|
</trl-alt>
|
|
<trl-alt lang="nl">
|
|
|
|
## Markup-taal
|
|
Ik heb een formaat ontwikkeld voor tekst die beter bij mijn doelen past dan Markdown.
|
|
</trl-alt>
|
|
|
|
|
|
|
|
</trl-group>
|
|
|
|
## 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.
|
|
|
|
|
|
<p>—private-below—</p>
|
|
|
|
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/}
|