AsciiDoc.py
===========
[](https://github.com/asciidoc-py/asciidoc-py/actions/workflows/test.yml)
[](https://codecov.io/gh/asciidoc-py/asciidoc-py)
[](https://badge.fury.io/py/asciidoc)
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](https://projects.eclipse.org/projects/technology.asciidoc).
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`
1. unit tests: `python3 -m pytest`
1. integration tests: `python3 tests/testasciidoc.py`
Raw data
{
"_id": null,
"home_page": "https://github.com/asciidoc/asciidoc-py3",
"name": "asciidoc",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5.0",
"maintainer_email": null,
"keywords": null,
"author": "asciidoc team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/1d/e7/315a82f2d256e9270977aa3c15e8fe281fd7c40b8e2a0b97e0cb61ca8fa0/asciidoc-10.2.1.tar.gz",
"platform": null,
"description": "AsciiDoc.py\n===========\n\n[](https://github.com/asciidoc-py/asciidoc-py/actions/workflows/test.yml)\n[](https://codecov.io/gh/asciidoc-py/asciidoc-py)\n[](https://badge.fury.io/py/asciidoc)\n\nAsciiDoc is a text document format for writing notes, documentation,\narticles, books, ebooks, slideshows, web pages, man pages and blogs.\nAsciiDoc files can be translated to many formats including HTML, PDF,\nEPUB, man page.\n\nAsciiDoc.py is a legacy processor for this syntax, handling an older\nrendition of AsciiDoc. As such, this will not properly handle the\n[current AsciiDoc specification](https://projects.eclipse.org/projects/technology.asciidoc).\nIt is suggested that unless you specifically require the AsciiDoc.py\ntoolchain, you should find a processor that handles the modern AsciiDoc\nsyntax.\n\nAsciiDoc.py is highly configurable: both the AsciiDoc source file syntax\nand the backend output markups (which can be almost any type of\nSGML/XML markup) can be customized and extended by the user.\n\n## Prerequisites\n\nAsciiDoc.py is written in Python so you need a Python interpreter\n(version 3.5 or later) to execute asciidoc(1). You can install Python using the\npackage manager for your OS or by downloading it from the official Python\nwebsite http://www.python.org.\n\nAdditionally, you will need:\n\n* DocBook XSL Stylesheets 1.76.1\n* xsltproc (libxml 20706, libxslt 10126 and libexslt 815).\n* w3m 0.5.2\n* dblatex 0.3\n* FOP 0.95\n\nto enable the full AsciiDoc.py toolchain.\n\n## Obtaining AsciiDoc.py\n\nDocumentation and installation instructions are on the AsciiDoc.py website\nhttps://asciidoc.org/. Simply, you should use use pip to install it:\n\n```\npip3 install asciidoc\n```\n\n## Contributing\n\nTo contribute and test your changes, you will need to install:\n* flake8\n* pytest\n* pytest-mock\n\nTo lint the codebase: `python3 -m flake8`\n\nAsciiDoc.py has the following types of tests:\n1. doctests: `python3 -m asciidoc.asciidoc --doctest`\n1. unit tests: `python3 -m pytest`\n1. integration tests: `python3 tests/testasciidoc.py`\n\n\n",
"bugtrack_url": null,
"license": "GPLv2+",
"summary": "AsciiDoc is a text document format for writing things.",
"version": "10.2.1",
"project_urls": {
"Homepage": "https://github.com/asciidoc/asciidoc-py3"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "751f87941eaa96e86aa22086064f67e4187e2710fb76c147312979ea29278dac",
"md5": "0ef61fed451926b4db88cc745e55ee14",
"sha256": "3f277a636b617c9ce7e0b87bcaea51f144500e9a5c8a6488421ee24594850d40"
},
"downloads": -1,
"filename": "asciidoc-10.2.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "0ef61fed451926b4db88cc745e55ee14",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.5.0",
"size": 272433,
"upload_time": "2024-07-17T03:12:49",
"upload_time_iso_8601": "2024-07-17T03:12:49.012728Z",
"url": "https://files.pythonhosted.org/packages/75/1f/87941eaa96e86aa22086064f67e4187e2710fb76c147312979ea29278dac/asciidoc-10.2.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1de7315a82f2d256e9270977aa3c15e8fe281fd7c40b8e2a0b97e0cb61ca8fa0",
"md5": "460824075b51381a4b5f478c60a18165",
"sha256": "d9f13c285981b3c7eb660d02ca0a2779981e88d48105de81bb40445e60dddb83"
},
"downloads": -1,
"filename": "asciidoc-10.2.1.tar.gz",
"has_sig": false,
"md5_digest": "460824075b51381a4b5f478c60a18165",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5.0",
"size": 230179,
"upload_time": "2024-07-17T03:12:52",
"upload_time_iso_8601": "2024-07-17T03:12:52.681700Z",
"url": "https://files.pythonhosted.org/packages/1d/e7/315a82f2d256e9270977aa3c15e8fe281fd7c40b8e2a0b97e0cb61ca8fa0/asciidoc-10.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-17 03:12:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "asciidoc",
"github_project": "asciidoc-py3",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "asciidoc"
}
JSON
