如何在Python中使用AsciiDoc？

Question

如何在Python中使用AsciiDoc？

11

最初的AsciiDoc处理器是用Python编写的，但AsciiDoc以Asciidoctor的形式演变为由Ruby编写。

在我寻找如何处理现代AsciiDoc（即Asciidoctor方言）时，我只发现了一篇文章（https://github.com/asciidoc/asciidoc/issues/83），介绍了一个将AsciiDoc移植到Python 3的旧项目。

但由于AsciiDoc的起源是Python，因此很难通过谷歌找到有用的东西。

那么从Python程序中处理AsciiDoc的最佳方式是什么？调用Ruby版本还是命令行处理器？

- rdmueller

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Berthold Gehrke · Accepted Answer

15

您可以使用Python3继续：您可以在www.asciidoc3.org和gitlab.com/asciidoc3/asciidoc3找到全新的Python3版本的AsciiDoc3。

所有170个AsciiDoc测试用例均已通过！

- Berthold Gehrke

1

很酷也很有趣。我猜这是旧版Python2 Asciidoc的移植，而不是基于Ruby的Asciidoctor？ - rdmueller

3

是的，AsciiDoc3 是“旧 Python2” AsciiDoc 的 100% 纯 Python3 移植版本，并且与 Asciidoctor 没有任何关系... - Berthold Gehrke

它是如何工作的？网站上并没有关于如何从Python中实际使用这个东西的有意义的内容（而不是通过运行可执行文件）。 - The Godfather

要通过另一个（Python）程序使用asciidoc3或a2x3，只需输入类似以下内容的命令（或类似命令-导入子进程模块）：

p = subprocess.Popen(asciidoc3, shell=True, stdin=subprocess.PIPE,
                     stdout=subprocess.PIPE, universal_newlines=True, bufsize=-1)
output = p.communicate(...)
...

- Berthold Gehrke

1

@TheGodfather 刚刚偶然发现了这个。Asciidoc-py3 提供了一个 API 模块：https://github.com/asciidoc/asciidoc-py3/blob/master/asciidocapi.py。据说这也应该在 asciidoc3 中存在，但我在代码库中没有看到它。 - haraldkl

显示剩余2条评论