docgen

Overview ¶

docgen generates a static web site from markdown and other files.

Usage:

go run dev/docgen/docgen.go

The generated web site is placed under website/public. The following types of files can be generated:

1. Copy a file directly (see `staticFile` below).
2. A markdown file can be converted to HTML and the result passed to a Go html/template.
3. An HTML file can be pre-processed and the result passed to a Go html/template. The HTML file can contain embedded markdown formatted as <markdown>...</markdown> regions. Each such region is replaced with the region contents converted markdown to HTML.