“意外的章节标题” Sphinx——numpy 是问题吗？
在我的 doc/ 目录中运行时 sphinx-build . html/ ，我得到以下输出： $ sphinx-build . html/ Running Sphinx v0.6.4 No builder selected, using def…
使用 rst2pdf 可视化第一个差异
有没有一种简单的方法可以使用 rst2pdf 来可视化 rst 文件之间的差异？我知道我可以使用 rst2latex 代替，然后使用 Latexdiff 生成 PDF 文件（这就是…
Python的网站如何生成其在线文档？
使用 Sphinx 0.6.5 创建。 我知道Python的文档使用reStructuredText，但它有不同的部分，例如http://docs.python.org/whatsnew/2.6.html和http:// do…
在 Sphinx 和 reStructuredText 中用数字引用数字
当编写将使用 Sphinx 处理的 RST 时，我无法让 Sphinx LaTeX 输出使用图引用数字时的数字。例如，这段代码： The lemmings are attacking, as can be …
如何在 ReST 中返回到更高的嵌套级别？
在重组文本中，我该如何写： Chapter 1: Section 1: Some section 1 text Section 1.1: An aside Section 1: Back to section 1 …
Sphinx、reStructuredText 显示/隐藏代码片段
我一直在使用 Sphinx 和 reStructuredText。 在我的文档中，有一些很长的代码片段。我希望能够将它们默认隐藏，并使用一个小“显示/隐藏”按钮来展开…
使用 RestructedText 和 Sphinx 包含预格式化文件
我正在尝试使这个片段起作用： Version History --------------- These are the versions over time:: .. include:: ../../CHANGES.txt 也就是说，使…
ReStructuredText 编号标题
首先有没有办法自动进行标题编号？这就像： #. Some Section =============== ... #. Some Subsection ------------------ ... #. Another Subsection…
在 Sphinx 中，有没有办法在声明参数的同时记录参数？
我更喜欢在声明参数的同一行记录每个参数（根据需要），以便应用 DRY 如果我有这样的代码： def foo( flab_nickers, # a series of under garments to…
Sphinx - 生成对 Trac 票证和变更集的自动引用
是Sphinx，有没有办法自动链接文本，如#112或r1023 到 Trac 中相应的票证/变更集？ 例如： #112 -> http://mytracsite/tickets/112 r1023 -> http://m…
PHP 的外部文档，无 DocBook
我需要一个 PHP 项目的文档系统，并且希望它能够将外部文档（用例、项目范围等）与代码注释生成的文档集成。看起来 phpDocumentor 具有完全正确的功能…
如何让 restructedText 添加一个类到每个 html标签？
我正在使用 Django 的标记包将 restructedText 转换为 html。有没有办法自定义 HTML 编写器以向每个 标记添加类属性？ 我可以为每个段落使用 class 指…
