11得票3回答
在sphinx/docutils中覆盖默认字段名称限制

我使用sphinx为项目生成html文档,并大量使用字段列表。 生成html时,如果标签长度不超过14个字符,则每个标签/值对将呈现为单个表行具有两个单元格。 如果一个标签的长度超过14个字符,则该标签/值将呈现为两个表行。 我想将换行限制提高到更大的值(例如40)。我发现限制由docu...

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

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

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

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

54得票8回答
ReST删除线

在 Restructured Text 中是否有办法划掉文字? 例如,当转换为 HTML 时,可以呈现为 <strike> 标签的内容,如:ReSTructuredText

12得票3回答
如何通过终端安装Docutils以使Django admindocs正常工作?

Docutils是一个非常好的软件包。如果你正在使用Django,admindocs软件包需要docutils。有关使用Web浏览器安装的说明可用,但如果您远程通过SSH登录终端怎么办?在这种情况下如何安装?如果您只想要一个快速的终端命令来完成此工作,该怎么办呢?

24得票4回答
在reStructuredText中将链接插入粗体文本

我尝试在重要的文本中插入链接,但在reStructuredText中失败了。 这是我的rst源代码:**Lorem ipsum dolor sit amet, `consectetur <http://www.example.com>`_ adipisicing elit, s...

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

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

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

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

14得票3回答
在reST中指定锚点名称

我正在使用docutils自带的rst2html工具将reST转换为HTML。似乎代码已经将id属性分配给了各个部分,这可以用作URL的片段标识符,即锚点,以跳转到页面的特定部分。这些id值基于节标题的文本。当我更改该标题的措辞时,标识符也会更改,从而使旧URL无效。 是否有一种方式指定要用...

11得票4回答
Sphinx中的条件toctree

我希望能够创建多个文档版本,这些版本在包含的章节上有所不同。为了实现这一目标,我通常会使用only指令或ifconfig扩展。然而,我无法将它们与toctree指令结合使用。 基本上,我想要的是这样的东西: .. toctree:: :maxdepth: 2 intro ...