AsciiDoc是一种用于编写各种内容的文本文档格式。
项目描述
AsciiDoc.py
AsciiDoc是一种用于编写笔记、文档、文章、书籍、电子书、幻灯片、网页、手册页和博客的文本文档格式。AsciiDoc文件可以转换为包括HTML、PDF、EPUB、手册页在内的多种格式。
AsciiDoc.py 是一种针对这种语法的旧版处理器，用于处理旧版本的 AsciiDoc。因此，它不能正确处理 当前 AsciiDoc 规范。建议除非您特别需要 AsciiDoc.py 工具链，否则您应该寻找能够处理现代 AsciiDoc 语法的处理器。
AsciiDoc.py 具有高度的可配置性：用户可以自定义和扩展 AsciiDoc 源文件语法以及后端输出标记（可以是任何类型的 SGML/XML 标记）。
先决条件
AsciiDoc.py 使用 Python 编写，因此您需要 Python 解释器（版本 3.5 或更高版本）来执行 asciidoc(1)。您可以使用操作系统的包管理器或从官方 Python 网站下载 Python https://pythonlang.cn。
此外，您还需要
- DocBook XSL 样式表 1.76.1
- xsltproc（libxml 20706，libxslt 10126 和 libexslt 815）。
- w3m 0.5.2
- dblatex 0.3
- FOP 0.95
以启用完整的 AsciiDoc.py 工具链。
获取 AsciiDoc.py
文档和安装说明在 AsciiDoc.py 网站上 https://asciidoc.org/。简单来说，您应该使用 pip 来安装它
pip3 install asciidoc
贡献
为了贡献和测试您的更改，您需要安装
- flake8
- pytest
- pytest-mock
要检查代码库： python3 -m flake8
AsciiDoc.py 有以下类型的测试
- doctests：
python3 -m asciidoc.asciidoc --doctest - 单元测试：
python3 -m pytest - 集成测试：
python3 tests/testasciidoc.py
下载文件
下载您平台上的文件。如果您不确定要选择哪个，请了解有关 安装包 的更多信息。
源代码分发
asciidoc-10.2.1.tar.gz (230.2 kB 查看哈希值)
构建分发
asciidoc-10.2.1-py2.py3-none-any.whl (272.4 kB 查看哈希值)
