Repository files navigation

AsciiDoc is a text document format for writing notes, documentation,articles, books, ebooks, slideshows, web pages, man pages and blogs.AsciiDoc files can be translated to many formats including HTML, PDF,EPUB, man page.

AsciiDoc.py is a legacy processor for this syntax, handling an olderrendition of AsciiDoc. As such, this will not properly handle thecurrent AsciiDoc specification.It is suggested that unless you specifically require the AsciiDoc.pytoolchain, you should find a processor that handles the modern AsciiDocsyntax.

AsciiDoc.py is highly configurable: both the AsciiDoc source file syntaxand the backend output markups (which can be almost any type ofSGML/XML markup) can be customized and extended by the user.

AsciiDoc.py is written in Python so you need a Python interpreter(version 3.5 or later) to execute asciidoc(1). You can install Python using thepackage manager for your OS or by downloading it from the official Pythonwebsitehttp://www.python.org.

Additionally, you will need:

• DocBook XSL Stylesheets 1.76.1
• xsltproc (libxml 20706, libxslt 10126 and libexslt 815).
• w3m 0.5.2
• dblatex 0.3
• FOP 0.95

to enable the full AsciiDoc.py toolchain.

Documentation and installation instructions are on the AsciiDoc.py websitehttps://asciidoc.org/. Simply, you should use use pip to install it:

pip3 install asciidoc

To contribute and test your changes, you will need to install:

• flake8
• pytest
• pytest-mock

To lint the codebase:python3 -m flake8

AsciiDoc.py has the following types of tests:

1. doctests:python3 -m asciidoc.asciidoc --doctest
2. unit tests:python3 -m pytest
3. integration tests:python3 tests/testasciidoc.py