Auxiliary scripts

This directory contains executables (mostly scripts) that implement special processes, like page rendering, attribute parsing, an HTTP server, and so on.

ignore

Manages the .gitignore file. Some files and directories need to be excluded from tracking to ensure “correct operation.”

markdown

Renders a Markdown document, writing a proper HTML document to disk. It also takes care of templating.

server

Starts a local server for previewing. Uses Python’s http.server.

setup-deploy

It sets up, if they aren’t already, the deploy branch and work tree.

title

Infers the title of a Markdown document. To this script a title is anything at the beginning of the document (minus empty lines). In order of preference:

• An ATX heading (of any level); e.g.

  # Title

  or

  #### Title

• A Setext heading (of 1st or 2nd level); e.g.

  The first Setext
  heading
  ================

  or

  The first Setext
  heading
  ----------------

  (Setext headings can span multiple lines.)

• A run of text (not necessarily a paragraph!) followed by an empty line or EOF.

• The empty title.

It trunctates long runs of text.