documentation - 有没有办法从 Sphinx 扩展创建中间输出？

Question

当 sphinx 处理 rst 到 html 的转换时，有没有办法在处理扩展后查看中间格式？

我正在寻找运行 sphinx 扩展后生成的中间 rst 文件。

有任何想法吗？

Answer 1

看看“ReST Builder”扩展：https ://pythonhosted.org/sphinxcontrib-restbuilder/ 。

没什么好说的；该扩展将 reST 作为输入和输出 ...drumroll... reST！

引用：

此扩展特别适用于与 autodoc 扩展结合使用。在这种组合中，autodoc 基于 docstrings 生成文档，restbuilder 输出结果是 reStructuredText (.rst) 文件。生成的文件可以提供给任何 reST 解析器，例如，它们可以自动上传到项目的 GitHub wiki。