Website Publication Files

ad pub

How I create web pages from selected files from this repository, with private and public editions.

Quickstart

Prerequisites: install node and git; clone the source with git clone https://git.surfacemarkup.net/hans/ad_pubfiles.

In this repository, npm install dependencies, including Web Origami. The following instructions assume you also have installed the ori command with npm install -g @weborigami/origami. If not, replace ori in commands below with npx @weborigami/origami.
link or copy README.md to the parent directory of this repository, with the name ad_pubfiles_pub.ori.md. Now you have input for testing and development, since the ori template files look in the parent directory for files with this pattern. Optionally add more files with the pattern: [a-p]+_title[_pub-other-tags][.ori].md. That is:

they MUST start with a sequence of characters a-p,
followed by an underscore,
followed by a title which does not contain an underscore,
followed optionally by an underscore and one or more tags separated by hyphens. For testing purposes, only the pub tag is relevant.
followed by the filetype extension .md. If you want to use Origami expressions in the file, use .ori.md.

The reason for this setup step is that on my machine, the parent directory contains my personal wiki. So I can’t share the input with you directly. The filename pattern above is used for the process of selecting which files to include in the build. The figure below shows this arrangement.

Use the following commands to achieve the desired output.

in private mode: ori "serve watch ., =debug ./site.ori('all')"
in public mode: ori "serve watch ., =debug ./site.ori()"

site.ori only exposes the final rendering step from pipeline.ori. Therefore:

To serve the pipeline with all the processing steps available for inspection, replace site.ori with pipeline.ori in the commands above.

a diagram showing a directory called src containing markdown files. The src directory also contains a subdirectory called ad_pubfiles_pub.d. Arrows show that the file README.md inside this subdirectory is hardlinked to a file in the parent src directory, and that the file pipeline.ori in the subdirectory reads markdown files from the parent src directory, and that the subdirectory is a git repository which is synchronized with a remote public repository. — How the site generator files relate to the content

ennl

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 for now, 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. Het werkt, en ik kan er HTML mee genereren, maar er is nog een heleboel dat het nog niet kan. Omdat de laatste 10% altijd het meeste werk is, gebruik ik voor nu Markdown.

Changes and Updates

This section SHALL describe the idea behind the Changelog.

Source files

The scripts and templates used to build this site are available here.

↖index