Skip to main content

AsciiDoc is a text document format for writing things.

Project description

[![Build Status](https://travis-ci.com/asciidoc/asciidoc-py3.svg?branch=master)](https://travis-ci.com/asciidoc/asciidoc-py3)

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 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 is written in Python so you need a Python interpreter (version 3.5 or later) to execute asciidoc(1). Python is installed by default in most Linux distributions. You can download Python from the official Python website http://www.python.org.

## Obtaining AsciiDoc

AsciiDoc’s Python 3 port is currently under development. To obtain AsciiDoc, download a copy of the repo from the GitHub project at https://github.com/asciidoc/asciidoc-py3 and follow the instructions in INSTALL.txt to build and install it.

## Tools

Current AsciiDoc version tested on Ubuntu 18.04 with:

  • Python 3.6.5

  • DocBook XSL Stylesheets 1.76.1

  • xsltproc (libxml 20706, libxslt 10126 and libexslt 815).

  • w3m 0.5.2

  • dblatex 0.3

  • FOP 0.95

  • A-A-P 1.091

## Copying

Copyright (C) 2002-2013 Stuart Rackham. Copyright (C) 2013-2020 AsciiDoc Contributors.

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

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.0.0a1.tar.gz (212.5 kB view hashes)

Uploaded Source

Built Distributions

asciidoc-10.0.0a1-py3-none-any.whl (250.5 kB view hashes)

Uploaded Python 3

asciidoc-10.0.0a1-py2.py3-none-any.whl (250.5 kB view hashes)

Uploaded Python 2 Python 3

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