问题标签 [docutils]

我正在尝试使用 docutils 包将 ReST 转换为 HTML。这个答案简洁地使用 docutilspublish_*便利功能一步实现这一目标。我要转换的 ReST 文档有多个我想在生成的 HTML 中分隔的部分。因此，我想分解这个过程：

1. 将 ReST 解析为节点树。
2. 根据需要分离节点。
3. 将我想要的节点转换为 HTML。

这是我正在努力的第三步。以下是我如何执行步骤一和二：

我找到了HTMLTranslator班级和Publisher班级。它们似乎相关，但我正在努力寻找好的文档。我应该如何实现该convert_to_html功能？

我有以下简单的代码来解析 reSt 文件并返回相应的 DOM 树。

这很好用，但是当解析器发现输入有问题时，它不会引发异常以便我的程序知道有什么问题，它只是将错误消息打印到标准输出并返回一棵树做。我怎样才能让它引发异常？或者，我怎么知道有什么不对劲？

我尝试在 Sphinx 中进行扩展，其想法是扩展检测部分的标题，然后将它们转换为折叠部分，即 sphinx 呈现带有前缀按钮的标题，该按钮有助于显示或不显示的内容部分。

我开始写这样的扩展：

但这里的问题是： - 我不知道将按钮与 onClick 函数绑定，这会使点击时的主要消失。- 主要内容只是放入原始 html，这不是最佳的，因为如果它们还包含子指令，它们将不会被处理。- 如果我必须选择，那么狮身人面像的文档真的很难理解，因此在这种情况下会调用一些节点。一般实例，但我不知道具体是什么。

谢谢

我想将使用 docutils 完成的所有文档下载为某种格式（html、pdf 等）有没有办法轻松做到这一点？

这是我第一次在 PyCharm 5.0 和 Python 3.5 中使用 Sphinx。

当我sphinx task在 PyCharm 中运行时，出现以下错误：

在此页面上，我发现在 Python 3.xStandardError中现在已替换为Exception. 但是，当我尝试编辑__init__.py文件时，PyCharm 阻止我保存它。

我还注意到它__init__.py基于 docutils 0.8 版。这并不直观，因为我在 virtualenv 中安装了 docutils 0.12 版。这意味着版本 0.12 被忽略。

有谁知道如何解决这一问题？

据我所知，不可能创建以code-block空行开头或结尾的文字文本块（例如，使用指令），因为这对于 reStructuredText 语法来说是模棱两可的。

没关系。

但是现在我想创建一个使用docutils'literal_block()节点的自定义指令，并且我希望（在我的指令的代码中）在指令内容的开头和/或结尾添加空行。

由于这在 reStructuredText 语法中是不可能的，我打算使用指令的选项来指定空行的数量，但这不是我的问题，也不是我的问题的一部分。以防万一你想知道...

这是我想要做的一个最小的例子：

它可以这样使用：

这行得通，但是我在指令中添加的换行符不知何故被 Sphinx 吞噬了（在 HTML 和 LaTeX 输出中）。

我怎样才能避免这种情况？

换行符实际上存储在node对象中（从 的输出中可以看出print()），但它们似乎在稍后的 Sphinx 处理过程中丢失了。

我对狮身人面像机器的了解不够，无法自行追踪，任何帮助将不胜感激！

如何在节点中使用 rst？例如我想输出包含的文件about.rst

有没有办法强制重组文本中的特定项目符号级别？

我在容器中有几个项目符号列表，例如。

每个这样的容器后面都有几段文字。

我的问题是，对于一个这样的容器，我想在每个要点之后用文本“分解”它，所以我会有类似的东西

这种方法有效，但问题是在这种情况下，内部条目的缩进和样式与外部条目相同（因为它们不再是嵌套项目符号列表的一部分）。有没有办法让它们以与先前容器中的内部条目相同的级别呈现（例如，通过强制重组文本以类似于处理部分标题的方式读取项目符号）？

我知道如何使用自定义文本创建外部超链接。

但我想链接到内部参考。

所以我想做类似的事情

但这不起作用。

我正在尝试将带有图像的第一个文档转换为 odt，但 rst2odt 似乎无法从第三个文档中获取图像。

它在一年前起作用，我想一定有一些升级改变了以前的行为。

重现我的问题的简单文档是：

我处理它：

我得到一个只有两张图片的奇怪的东西。第三个不见了。使用 --verbose 选项时，我没有任何抱怨。

顺便说一句，rst2odt 版本是（Docutils 0.12 [release], Python 2.7.9, on linux2）

尝试不同的技巧，我重新安装了 python-imaging 包并升级了枕头，但没有运气

奇怪的是，rst2pdf 能够正确放置三个图像。

任何帮助将不胜感激，因为我有相当多的 rst 和一堆图像，可以翻译成 odt

编辑：我已经从我的系统（Debian Jessie）中清除了 docutils，然后重新安装而没有改进。