问题标签 [restructuredtext]

跑步时

在我的doc/目录中，我得到以下输出：

这个文件有numpy导入，经过一番研究，似乎 sphinx 使用的 RST 标记的numpy记录方式有问题。当我取出 numpy 导入时，html 构建良好。

解决此问题的最佳方法是什么？

我正在使用重组文本来创建一些简单的网站。所以我有很多 *.rst 文件，我想在其中添加 Google Analytics 代码。但据我所知，不可能添加这样的东西？！

我正在使用 rst2html 将文件转换为 html。

我正在生成一些 PDF，我想禁用首页上的标题。我知道 rst2pdf 中有内置模板，并且调用了一个模板，coverPage但我似乎无法让它工作。

手册说你应该使用

声明，但这将在封面之前插入一个空白，所以我怎样才能有一个没有标题且不使用oddeven指令的封面（我想在所有剩余页面上使用相同的标题）。

感谢您的建议！

在 Emacs 中，我使用的是深色背景和浅色文本的配色方案。使用 .rst 文件时，我有一个使用 rst.el 的模式。但是，rst.el 以浅色背景突出显示标题，这使得在其上阅读浅色文本变得不可能！

我认为这是 rst.el 中负责背景颜色的代码部分：

我尝试将“灰色”更改为其他东西，但它并没有改变任何东西。有什么帮助吗？

eclipse下是否有用于reStructuredText的WiKiText编辑器插件？当我编辑 .textile 文件时，我会获得各种智能编辑功能（例如折线）和预览面板。我发现在各种 MyLyn 包下都有对 reStructuredText 的引用，但是安装它们后我仍然找不到 reStructuredText 编辑器。是因为没有吗？

谢谢。肯特

我将 reStructuredText 与 epydoc 一起使用。如何使内部链接的文本与链接的目标不同？我有：

Product 链接看起来很好，并链接到 Product 对象。Product.manufacturer 链接指向正确的成员变量，但不是 Product.manufacturer 的文本，我只想成为制造商。

我知道如果我使用 epytext 可以做到这一点，但我们想坚持使用 reStructuredText，以便我们以后可以根据需要切换文档生成器。

我使用 restructuredText，我喜欢 smartypants 为 Markdown 所做的。有没有办法为 restructuredText 启用相同的功能？

我正在编写一个 Django 应用程序来提供一些用 RestructuredText 编写的文档。我有很多用 *.rst 编写的文件，每个文件都很长，有很多节、小节等。

使用 Django 过滤器在单个页面中显示整个文档不是问题，但我宁愿在第一页上只显示主题索引，并链接到我可以显示单个部分/小节的 URL（这将需要一些'previous | up | home | next' 链接我猜...）。以类似于 docbook / XML 到 HTML 转换中的“多 HTML 页面输出”的方式。

谁能指出我构建 *.rst 文档的文档树并解析其中的单个部分的方向，或者提出一种获得类似结果的聪明方法？

我想使用一种轻量级的标记语言在我的大学课堂上做笔记。

我选择的编辑器是 gedit，我找到了用于 Gedit 的 reStructuredText Tools，它将运行 reStructuredText 处理器并在 gedit 的窗格中呈现 HTML。这很棒，而且已经完成了 80%。

但是对于我的许多课程，我需要在笔记中包含数学方程式或希腊字符。虽然我对 LaTeX 不是很熟悉，但我的理解是它具有这些功能。

如何在 REST 文档中使用 LaTeX？是否需要将 reST 文档处理成 LaTeX，然后渲染成 HTML，还是有更好的方法？降价会让这更容易吗？如有必要，我可以修改 gedit 插件。

最后，有人这样做吗？在纯文本编辑器中做课堂笔记的任何其他建议？

谢谢！

我正在记录一个包含 Python 组件和 JavaScript 组件的库。整个用户文档和 Python API 文档都在 reStructuredText 中，使用 Sphinx 处理。JavaScript API 位于 jsdoc 中，并使用 jsdoc-toolkit 进行处理。主要输出格式为 HTML。我是 reST、Sphinx 和 jsdoc 的新手。

我已经建立了一个构建系统，所以所有生成的 html 页面都被转储到一个目录树中。我现在需要在主页（从 reST 生成）中插入指向生成的 Javascript 文档的链接。这需要是一个相对链接，因为文档可能位于不同安装的不同位置。reST 会自动解析一个完整的 URL，但我不知道如何让它插入一个相对链接。:ref:和:doc:之类的构造似乎没有帮助，因为它们希望目标是 reST。

有任何想法吗？