AsciiDoc

My ideas about good and usable documentation system.

I wrote article about using AsciiDoc for as project documentation system.

asciidoc.cgi - CGI which automatically convert .txt to .html when user request html from website (it handle all asciidoc documents on this website). More details and download on Software page.

Plugins

All plugins listed below require asciidoc 8.6.6+

compact - my theme plugin, similar to default color scheme but more compact. You can compare compact theme with default theme using my cheatsheet as example. Download # Install: asciidoc --theme install compact-1.6.zip # Use: asciidoc -a theme=compact …

9man - my backend plugin to generate man pages (troff) compatible with OS Inferno and Plan9. Download # Install: asciidoc --backend install 9man.zip # Use: asciidoc -d manpage -b 9man your_man_page.txt

habrahabr - my backend plugin to generate Habrahabr friendly HTML. Download # Install: asciidoc --backend install habrahabr.zip # Use: asciidoc -b habrahabrb your_article.txt

graphviz-cmap - my variant of graphviz filter plugin, which add support for client-side imagemap. Download # Install: asciidoc --filter install graphviz-cmap-0.1.zip # Use: just start using [URL="..."] in your graphviz sources.