Fork Me On GitLab
AsciiDoc3
Text based document generation using Python 3

»Home  »User Guide  »Blog  »Quickstart  »Download  »Install  »PyPI  »Docker  »Windows  »Cheatsheet  »Release Notes  »Contact / Donate  »Imprint / Impressum / Datenschutz / Privacy

AsciiDoc3-3.2.3 is here!

  • Bugfixes

  • More example/template files

1. Current version

1.1. Tarball

The current version of AsciiDoc3 is

AsciiDoc3-3.2.3

Day of release: 2021-12-15

1.2. rpm / deb Packages

AsciiDoc3-3.2.3

Day of release: 2021-12-15

1.3. PyPI

AsciiDoc3 can be found at https://pypi.org/project/asciidoc3

AsciiDoc3-3.2.3

This works with POSIX and also with Windows!
Need more information? See here.

1.4. Gitlab

AsciiDoc3 can be found at https://gitlab.com/asciidoc3/asciidoc3

This is the up-to-date repo.

1.5. Docker

AsciiDoc3 can be found at Docker, see here

2. Release Schedule

  • consecutively: adding/completing documentation, erasing typos etc., adding/completing files at https://gitlab.com/asciidoc3/asciidoc3

  • AsciiDoc3-3.2.3: 2021-12-15

  • AsciiDoc3-3.2.2: 2021-01-17

  • AsciiDoc3-3.2.1: 2020-09-20

  • AsciiDoc3-3.2.0: 2020-04-16

  • AsciiDoc3-3.1.0: 2019-04-19

  • AsciiDoc3-3.0.3: 2019-01-07

  • AsciiDoc3-3.0.2: 2018-06-15

  • AsciiDoc3-3.0.1: 2018-05-16

  • AsciiDoc3-3.0.1rc: 2018-04-13

You find all versions here.
Do not install outdated versions. Use them only when you know what you are doing!

3. Roadmap

Under development:

  • AsciiDoc3 available as a module python3 -m asciidoc3 (beta)

  • GUI (beta)

4. Changelog

3.2.3

  • Python 3.7 required

  • Bugfix: Running under Python 3.10 pip install fails.

  • Files needed for pip on pypi.org are build with build; see asciidoc3.toml in the repos.

3.2.2

  • Python 3.6 required

  • Bugfix: Adding empty [unfloat-blockmacro] in docbook45.conf to prevent the message
    asciidoc3: WARNING: testcases_docbook45.txt: line 614: missing macro section: [unfloat-blockmacro]

  • Bugfix: Adding empty [unfloat-blockmacro] in docbook51.conf to prevent the message
    asciidoc3: WARNING: testcases_docbook45.txt: line 616: missing macro section: [unfloat-blockmacro]

  • Adding asciidoc3 to the tuple of feasible values of __name__. This is necessary since __name__ == asciidoc3 if dockerized:

  if __name__ in ('__main__', 'asciidoc3.asciidoc3', 'asciidoc3'):
      sys.stderr.write('%s: %s%s' % (self.PROG, msg, os.linesep))

3.2.1 (PyPI files only)

  • Bugfix: (Windows) When Python2 and Python3 are installed and not using venv, asciidoc3_postinstall may fail. FIXED
    GNU/Linux systems are not affected.

3.2.0

  • Full support of DocBook v5.1: ./doc/readme_docbook51.txt

  • Add many files regarding DocBook51: ./doc/-.- and ./tests/data/-.-

  • Updated many files in ./doc

  • Python 3.5 required

  • a2x3.py uses argparse instead of optparse

  • a2x3.py tests: ./tests/a2x3_multitest.py and ./tests/testa2x3.py

  • Improve documentation ./doc/userguide.txt = asciidoc3.org/userguide.html

  • Fix misspellings in various files and documents

  • asciidoc3.py: use "with" for handling files instead of older try/finally pattern.

  • New file ./filters/music/example_music-filter.txt to have a pure example for the test of the standalone music converter music2png.py

  • asciidoc3api.py: added a new path to asciidoc3 when loaded via pip/pypi

  • Removed files ./doc/asciidoc3port.txt ./doc/testsyswin.txt ./doc/asciidoc3port.txt

  • Removed files ./tests/data/deprecated-quotes.txt ./tests/data/oldtables.txt

  • Added new image: ./images/logo_asciidoc3.png

  • Added lang-se.conf lang-ja.conf lang-zh-CN.conf and correspondent files in ./tests/data

  • Renamed ./doc/READMEdoc.txt to ./doc/readme.txt

  • Added ./tests/data/nonvalid_docbook51.txt to present a valid AsciiDoc3 txt-source with non-valid Schematron DocBook51 output.

3.1.0 / 3.0.x

  • Add PyPI support (Windows / GNU/Linux)

  • Drop A-A-P based build system and change to Python3 script

Version AsciiDoc 8.6.9 (2013) was written in Python 2.x
This version was our starting point to migrate towards Python3.

5. Contact

Please do not hesitate to let me know any qestions and comments/bug reports about AsciiDoc3,
mail to info att asciidoc3.org (sorry, the contact form was switched off due to spam).