问题标签 [restructuredtext]

例子：

由于Download指向不同的 url，docutilus 给出了这个错误报告：

在 markdown 中，我可以为这两个指定不同的 id Download：

如何在 reStructuredText 中做类似的事情？

我正在使用 reStructuredText 来记录我的代码，以便通过 epydoc 获得漂亮的离线 HTML 页面。

结果是辉煌的。唯一的缺点是，当我使用 Python 交互式 shell 时，help() 函数不会解析文档字符串中的 reST 元数据，而是按原样显示整个内容。

有没有办法让 help() 对文档字符串进行一些最小的解析？

我不希望渲染斜体字体或超链接，但至少要进行一些最小的清理以提高可读性。

这篇文章说以下指令是对齐图像的一种方法。

但是，图像不是居中对齐，而是右对齐，我看到生成的 HTML 如下。

它被定义为 align-center 类，与解释相反：“图像的对齐方式，相当于 HTML 标签的“对齐”属性。”

我什至试图拥有CSS。

而且它也不起作用。

这有什么问题？

我一直都有<form>这样的。

例如，reStructuredText 中是否有任何宏或等效项，以便我可以获得相同的结果？

我正在尝试使用 DocUtils 和 reStructuredText 来注释 SQL 代码。当我在多行注释中包含标记时，我可以让它工作。然后我使用 --Some text:: 来介绍每个代码块。

我无法让内部超链接正常工作。我想写 -- .. Step1_: 但解析器忽略了这一点，因为前面的注释。使用多线样式也失败了。有没有办法让它工作？

这是一个例子：

我想通过 reST 生成文档，但不想手动编写 reST 源代码，而是让 python 脚本来做，然后用 sphinx 生成其他格式（HTML、PDF）。

想象一下，我有一本二进制格式的电话簿。现在我使用 python 脚本来解析它并生成一个包含所有名称和数字的文档：

然后我会继续调用 sphinx 来生成 pdf 和 html：

是否有提供 API 用于生成 reST 的 python 模块（在上面的示例中也称为 restProducer）？还是通过几个打印语句转储 reST 标记的最佳方法？

这是我想做的事情：

要获得：

上下文是一个出版物列表，我希望它们在最后都有一个标记为“DOI”的链接。

但是，这似乎失败了：

确切的错误似乎取决于我使用的 docutils 版本，但它们都失败了。

有没有办法在重组文本中生成具有相同文本的多个链接？

在 RestructuredText 中，您可以像这样在表格中呈现标题行（取自文档：

是否可以对第一列做类似的事情？一个显然不起作用的示例可能如下（注意第 1 列末尾的双倍）：

我正在使用 rst 和 sphinx 编写项目的文档。但早些时候，我已经用乳胶写了一部分，现在想将其转换为 rst 以将其添加到文档中。rst 到 latex 的转换是显而易见的，但是谷歌搜索相反的方式并没有直接产生任何东西。

所以我的问题是：有没有办法将乳胶转换为 rst？

编辑
理想情况下，我想将其转换为专门用于 sphinx 的 rST。因此，如果它可以使用例如 sphinx 的扩展来显示数学，那就太好了。

我正在尝试使用以下代码（遵循Sphinx和docutils文档）创建一个正确嵌套的列表：

我希望这会导致两个OLs 但我得到以下输出：

我究竟做错了什么？是不是不能得到下面的结果？