About this site

A demonstration site for anchor, served from a plain Linux box and updated by copying a directory onto it.

anchor produces a directory. Getting that directory onto a host is rsync, git, or a CI job, and is out of scope for the generator. This site is the rsync case, which is the one that needs no infrastructure at all.

What is on show here

Every page is a directory holding an index.adoc, and its path is its URL. There is no permalink configuration and no slug field, because the filesystem already answers the question.

/posts/ is a directory that is both a page and the parent of pages, which is what makes a section a first-class thing without anything declaring one.

This page carries no date. Undated pages are still pages; they are only excluded from listings that are chronological, which is why it does not appear on the front page among the posts.

What anchor will not do

anchor has no plugin system, no theme format, no asset pipeline, no image processing and no deployment step. A theme is a CSS file and optionally a layout function. The stylesheet on this site is one file of ordinary CSS with no build step behind it.

The scope was written down before the code existed and the project is finished at 1.0. That is not a way of saying it is abandoned. A tool that does a known amount and then stops is the point.