Skip to main content

AsciiDoc is a text document format for writing things.

Project description

AsciiDoc.py

Test codecov PyPI version

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 older rendition of AsciiDoc. As such, this will not properly handle the current AsciiDoc specification. It is suggested that unless you specifically require the AsciiDoc.py toolchain, you should find a processor that handles the modern AsciiDoc syntax.

AsciiDoc.py is highly configurable: both the AsciiDoc 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

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 the package manager for your OS or by downloading it from the official Python website http://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.

Obtaining AsciiDoc.py

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

pip3 install asciidoc

Contributing

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asciidoc-10.2.1.tar.gz (230.2 kB view details)

Uploaded Source

Built Distribution

asciidoc-10.2.1-py2.py3-none-any.whl (272.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file asciidoc-10.2.1.tar.gz.

File metadata

  • Download URL: asciidoc-10.2.1.tar.gz
  • Upload date:
  • Size: 230.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for asciidoc-10.2.1.tar.gz
Algorithm Hash digest
SHA256 d9f13c285981b3c7eb660d02ca0a2779981e88d48105de81bb40445e60dddb83
MD5 460824075b51381a4b5f478c60a18165
BLAKE2b-256 1de7315a82f2d256e9270977aa3c15e8fe281fd7c40b8e2a0b97e0cb61ca8fa0

See more details on using hashes here.

File details

Details for the file asciidoc-10.2.1-py2.py3-none-any.whl.

File metadata

  • Download URL: asciidoc-10.2.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 272.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for asciidoc-10.2.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3f277a636b617c9ce7e0b87bcaea51f144500e9a5c8a6488421ee24594850d40
MD5 0ef61fed451926b4db88cc745e55ee14
BLAKE2b-256 751f87941eaa96e86aa22086064f67e4187e2710fb76c147312979ea29278dac

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page