AsciiDoc is a (mostly humane) text document format for writing short documents, articles, books and man pages. Its toolchain is capable of producing HTML4, XHTML, DocBook, man, and LaTeX. This page (index.txt) was originally written in AsciiDoc. git(1)'s manual pages and other documentation are written in AsciiDoc.

AsciiDoc generates basically good semantic markup, is styled with external CSS, and includes support for themeing. The default theme included in AsciiDoc is functional but is somewhat lacking in typographic consistencies; it is also quite blue.

This package includes a variety of additional themes and a framework for assembling them (see also: HACKING).

Caution
CAUTION
This project was started on March 4, 2008 and is currently in the very early stages of development. There's not many themes yet and not all themes style the gambit of supported AsciiDoc markup. Also, I have not tested anything in any version of Internet Explorer, yet.

Themes

Serify

Very similar to the bare theme but uses serif faces instead of sans-serif. This theme's manpage style is identical to the bare theme.

Theme Information | Article Sample | Manpage Sample | serify.css | serify-manpage.css

Handbookish

Inspired by The FreeBSD Handbook, one of The FreeBSD Documentation Project's many works of art, this theme is probably most noticeable by its judicious use of daemon red and its fatty bold headings. FreeBSD's sh(1) HTML manpage provided the template for the manpage stylings.

Theme Information | Article Sample | Manpage Sample | handbookish.css | handbookish-manpage.css

Bare

The "bare" theme is meant as a starting point for other themes. It includes a basic level of structural and typographic styling but tries to remain otherwise vanilla in its visual appearance. The manpage styles are based on the default theme included with the Bwana manpage reader for MacOS X.

Theme Information | Article Sample | Manpage Sample | bare.css | bare-manpage.css