Skip to content

asciidoc3/asciidoc3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 

Repository files navigation

--> Repo has moved to https://gitlab.com/asciidoc3/asciidoc3 <--

Do not fork this repo any more: outdated, insecure ...

asciidoc3

Text based document generation using Python3; Python3 port of AsciiDoc

AsciiDoc3 is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc3 files can be translated to many formats including HTML, PDF, EPUB, man page, and DocBook markup (at your choice v4.5 or v5.1). AsciiDoc3 is highly configurable: both the AsciiDoc3 source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.

Prerequisites

AsciiDoc3 is written in 100% pure Python3. So you need a Python interpreter (version 3.7 or later) to execute asciidoc3.py. Python is installed by default in most Linux distributions. You can download Python from the official website https://www.python.org.

Obtaining AsciiDoc3

deb rpm packages tarball generic installer zip PyPI (GNU/Linux and Windows) Docker Pelican Plugin available! See documentation and installation instructions on the AsciiDoc3 website https://asciidoc3.org/

Tools

Current AsciiDoc3 version tested on Debian Siduction, Ubuntu 22.04 LTS (Jammy Jellyfish), openSUSE Tumbleweed, Ghost BSD, Windows 10/11, ...

Dependencies

AsciiDoc3 comes without dependencies (aside Python3, of course). To exploit all features of AsciiDoc3, you need - where necessary - DocBook XSL Stylesheets, xsltproc, w3m, dblatex, FOP, Pygments, graphviz ... You'll find these packages in the repos of your operating system.

Copying

Copyright © Stuart Rackham (and contributors) for AsciiDoc v8.6.9 (Python2)

Copyright © 2018-2018 Berthold Gehrke berthold.gehrke@gmail.com for AsciiDoc3 (Python3)

Free use of this software is granted under the terms of the GNU General Public License version 2 or later (GPLv2+).