问题标签 [restructuredtext]

问题：我正在尝试使用reStructuredText编写“并行文本” 。我所说的“平行文本”是指带注释的小说作品，其中文本分为两列。左栏包含正文，右栏包含评论。我将使用sphinx从中生成 HTML 和 Latex 文档。

我有以下要求：

1. 如上所述，我应该能够在两列中排版文本，一列用于正文，一列用于注释。
2. 注释可以是“句子级别”，并不总是“段落级别”。即，我希望能够在一个段落或整个段落中注释不同的句子。
3. 关闭所有注释的模式会很棒，因此输出的 HTML 和 Latex 仅包含正文。在这种情况下，我希望能够使用媒体的整个“房地产”，而不仅仅是一个专栏。
4. 如果可能的话，拥有“注释列表”功能会非常好。

我对 reStructuredText 和 Sphinx 还很陌生，但对 Python 有相当多的经验。我正在寻找一些关于如何做我想做的事情的想法。我一直在阅读有关 reStructuredText 以及编写 Sphinx 扩展的内容，因此为 Sphinx 编写扩展并不是不可能的。

有没有人做过类似的事情？

谢谢！

不确定性 Python 包的文档是用 reStructuredText 编写的，用于Sphinx文档系统。HTML看起来不错。我想创建一个 PDF 版本。目标是为每个网页创建一个“章节”。

但是，发生的情况是，由ReST 文件生成的 PDF将 (HTML)部分转换为index.html单独的章节（我不希望这样：PDF 也应该将它们作为部分）。另一个问题是主页之后的所有 HTML 页面在 PDF 中显示为toctree指令出现的部分的子部分（即，在主页的确认部分中）。

那么，应该如何构造 ReST 文件，以便（1）Web 文档看起来和现在一样，以及（2）每个网页对应一个 PDF 章节。任何帮助将非常感激！

我正在寻找在 reStructured Text 中让图像旁边出现文本的最佳方式。我发现几个网站声称展示了它是如何完成的，但没有一个展示实际运行的示例。有几个显示了似乎失败的例子。我实际上正在使用 Sphinx (v0.6.6) 并希望避免过度使用它附带的“本机”CSS。

我正在尝试在我的网站上使用从 reStructuredText 生成的 jQuery lightBox 实现。灯箱将图像周围链接的标题作为灯箱显示中图像的标题。

但是，我似乎无法在 reStructuredText 中找到在链接上提供标题属性的方法 - 有人知道这样做的方法吗？我的图像定义如下：

所以我可以添加一个alt属性，但不能添加一个标题。一种可能的替代方法是使用目标作为参考，如下所示：

在后一种情况下，我不确定如何向底部定义的链接添加属性（如果可能的话）。

我想根据最后一行使用快捷方式添加所需的=（从 Section/Title reStructuredText syntax ）。

所以，假设（是|光标位置）

并按下映射到函数的特定映射，添加一个=等于最后一行（其中Title是）的数字，变为：

我在目录中有一堆文本文件help_pages/，全部以 reST 格式。我正在尝试向我的 GNU 添加Makefile一些规则：

1. help_pages通过一个应用程序运行扩展名为“.rst”的目录（和子目录）中的每个文件，该应用程序会输出一个有效的 html 文件（现在我只是在使用rst2html）。
2. 将这些输出 html 文件复制到目标目录，再现目录中存在的目录结构help_pages。

因此，例如，help_pages/some/dir/foo.rst首先会被翻译成help_pages/some/dir/foo.html，然后复制到public/help/some/dir/foo.html。

我花了一整天的时间试图学习 Makefile 的内部结构，但最后我放弃了。这是我已经拥有的：

这种工作 - .rst 文件被翻译成 .html 文件，但我不知道如何将它们安装到最终的目标目录中。如果我cp向主构建配方添加命令，如果目标目录中不存在这些文件，则不会重新安装它们。

理想情况下，我想要一个目标来制作帮助文件，一个来安装它们，第三个（称为“帮助”）取决于这两个。我认为这会给我最大的灵活性。

谁能给我一些关于如何实现这一目标的提示？

干杯，

如何在 ReStructured Text 中使用颜色？例如，**hello**翻译成<strong>hello</strong>. 我怎样才能让 ReStructure(rst2html.py) 将某些东西翻译 成<font color="####">text</font>？

我想过..raw :: html，但它引入了空白行。我想插入没有空行的 HTML 标签。

正如本文所问和回答的那样，可以使用SyntaxHighlighter来列出漂亮的代码。

使用 ReStructuredText，我可以按如下方式使用原始指令。

但是，我需要有可以使用的代码指令。

如何将代码指令翻译成以下 HTML 代码？

如何在 reStructuredText 中指定链接中格式化文本？

具体来说，我希望从我的第一个 HTML 中生成以下 HTML：

结果应如下所示：

optparse.OptionParser 文件

其中“optparse.OptionParser”部分是固定宽度的字体。

我试过

然而，这给了

看起来像这样

``optparse.OptionParser documentation <http://docs.python.org/library/optparse.html>\_

HTML 的注释是<!-- .. -->，我怎样才能用重组文本制作这个注释块？换句话说，我怎样才能注释掉重组文本中的一些行？