asciidoc

Compile ASCIIDoc into HTML

Version 0.6

by Roberto Alsina

Supports Nikola v8 or newer

Source code

To install, run nikola plugin -i asciidoc

Compiler plugin to support the AsciiDoc markup via the original asciidoc tool or via asciidoctor.

Example usage of Nikola's path handlers in Asciidoc:

link:link://slug/demo-page[Click here to go to the demo page]

More information about AsciiDoc

More information about Asciidoctor

Suggested Configuration:

# Add the asciidoc compiler to your COMPILERS dict.
COMPILERS["asciidoc"] = ['.asc']

# Add asciidoc files to your POSTS, PAGES
POSTS = POSTS + (("posts/*.asc", "posts", "post.tmpl"),)
PAGES = PAGES + (("pages/*.asc", "pages", "page.tmpl"),)

# You can choose what command to use for processing.
# For example, you can replace asciidoc with asciidoctor
# Or use the full path to the program.
# ASCIIDOC_BINARY = "asciidoc"

# Specify options to the asciidoc compiler (as a string).
# ASCIIDOC_OPTIONS = ""

Requirements:

Issues? Questions?

You can report issues with this plugin and request help via GitHub Issues.