AsciiDoc Themes
===============
Ryan Tomayko <r@tomayko.com>
March 2008

*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 (link:index.txt[`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: link:hacking.html[`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 link:bare.html[bare theme] but uses serif faces instead of
sans-serif. This theme's manpage style is identical to the bare theme.


link:serify.html[Theme Information] |
link:serify-format.html[Article Sample] |
link:serify-manpage.html[Manpage Sample] |
link:src/serify.css[serify.css] |
link:src/serify-manpage.css[serify-manpage.css]

=== Handbookish ===

Inspired by http://freebsd.org/doc/en/books/handbook/[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 http://tinyurl.com/3afcwv[`sh(1)`] HTML manpage
provided the template for the manpage stylings.


link:handbookish.html[Theme Information] |
link:handbookish-format.html[Article Sample] |
link:handbookish-manpage.html[Manpage Sample] |
link:src/handbookish.css[handbookish.css] |
link:src/handbookish-manpage.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 http://bruji.com/bwana/[Bwana] manpage reader
for MacOS X.


link:bare.html[Theme Information] |
link:bare-format.html[Article Sample] |
link:bare-manpage.html[Manpage Sample] |
link:src/bare.css[bare.css] |
link:src/bare-manpage.css[bare-manpage.css]