Welcome to the first post. This file demonstrates the metadata convention used by the build script:

  • = First Post is the document title. It must be the first line.

  • :revdate: is the publication date. It must be an ISO date, because the index sorts posts lexicographically by that value.

  • :author: and :description: are optional AsciiDoc attributes.

Why AsciiDoc?

AsciiDoc is pleasant to write and produces clean HTML. This site is intentionally small: a shell script runs Asciidoctor over every .adoc file and regenerates the homepage.

./bin/build
./bin/preview

Links and formatting

You can use normal AsciiDoc syntax: bold, italic, inline code, and links such as Asciidoctor.

Note
 The shared stylesheet is linked from every generated post. The post HTML does not embed its own copy of the CSS.

A section

Lists, code blocks, tables, and blockquotes all work without any JavaScript. Add more .adoc files under posts/ and rebuild.