8得票1回答
使用特定于Sphinx的指令以编程方式解析.rst文件

我希望能够在Python中解析基于sphinx的rst文件以供后续处理和检查。类似这样的操作: import sphinx p = sphinx.parse("/path/to/file.rst") do_something_with(p) 看起来可以使用docutils.core.pu...

8得票2回答
如何在reSTructuredText中抑制或禁用警告?

我正在使用Python开发一个CMS,它使用reStructuredText(通过docutils)来格式化内容。我的许多内容都是从其他来源导入的,通常以未格式化的文本文档的形式出现。reST非常适合此类情况,因为它默认使一切看起来很清晰。 然而,我遇到了一个问题,就是我在Web服务器上会收...

8得票2回答
如何在指令的节点中添加rst格式?

我该如何在节点中使用rst?例如,我想输出包含文件about.rst。 class Foo(Directive): def run(self): return [ nodes.Text("**adad**"), # <-- Must ...

7得票1回答
如何在reStructuredText中生成表格输出,而不使用RST表格格式?

我正在尝试将我们的API文档及其专有文档生成器模式迁移到reStructuredText。最困难的一部分是,我们在HTML中直接编码了API细节的表格表示方式,例如: --------+------------+--------+-------------------------------...

7得票3回答
解决重组文本中的替换问题

我希望您能翻译以下重构文本片段,其中包含一个替换定义: text = """ |python| .. |python| image:: python.jpg """ 解决定义问题,以便替代文本得到显示: resolved_text = """ .. image:: python.j...

7得票2回答
docutils/sphinx自定义指令创建同级部分而非子部分

考虑一个具有以下框架的reStructuredText文档: Main Title ========== text text text text text Subsection ---------- text text text text text .. my-import-from...

7得票1回答
Sphinx:如何交叉引用自定义指令生成的目标

我在交叉引用自定义指令生成的部分时遇到了困难。 以下是该指令: from docutils import nodes from docutils.parsers import rst class TestDirective(rst.Directive): has_conten...