有没有一种方法可以从Sphinx扩展创建中间输出？ [英] Is there a way to create an intermediate output from Sphinx extensions?

问题描述

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

When sphinx processes an rst to html conversion is there a way to see an intermediate format after extensions have been processed?

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

I am looking for an intermediate rst file that is generated after sphinx extensions were run.

有什么想法吗？

推荐答案

看看 ReST构建器扩展名： https://pythonhosted.org/sphinxcontrib-restbuilder/ 。

Take a look at the "ReST Builder" extension: https://pythonhosted.org/sphinxcontrib-restbuilder/.

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

There's not much to say; the extension takes reST as input and outputs ...drumroll... reST!

报价：

此扩展名与autodoc扩展名结合使用特别有用。在这种组合中，autodoc根据文档字符串生成文档，restbuilder输出的结果是reStructuredText（.rst）文件。生成的文件可以馈送到任何reST解析器，例如，它们可以自动上载到项目的GitHub Wiki。

This extension is in particular useful to use in combination with the autodoc extension. In this combination, autodoc generates the documentation based on docstrings, and restbuilder outputs the result are reStructuredText (.rst) files. The resulting files can be fed to any reST parser, for example, they can be automatically uploaded to the GitHub wiki of a project.

这篇关于有没有一种方法可以从Sphinx扩展创建中间输出？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！