问题标签 [docutils]

我正在学习 Sphinx，我需要编辑 ReST 文件。有智能编辑器吗？比如，一个给我代码着色、简单缩进、代码完成（希望如此）等的编辑器。

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

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

我正在用 Python 开发一个 CMS，它使用 reStructuredText（通过 docutils）来格式化内容。我的很多内容都是从其他来源导入的，通常以无格式文本文档的形式出现。reST 对此非常有效，因为它默认情况下让一切看起来都非常正常。

然而，我遇到的一个问题是，我收到警告转储到我的网络服务器上的 stderr并 注入到我的页面内容中。例如，我在网页上收到如下警告：

系统消息：WARNING/2（第 296 行）；反向链接

我的问题是：如何抑制、禁用或以其他方式重定向这些警告？

理想情况下，我很想将这些写到日志文件中，但如果有人能告诉我如何关闭警告，以免注入到我的内容中，那将是完美的。

负责将 reST 解析为 HTML 的代码：

本文档（http://docutils.sourceforge.net/docs/ref/rst/directives.html）解释了在docutils中使用..raw::来传递HTML代码，HTML代码在生成的body部分HTML。

如何使用 docutils 在标题部分 (..) 中添加内容？

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

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

这是一个例子：

我习惯于在 C++ 和 Python 项目中使用Sphinx。我刚刚在Clojure中启动了一个项目，我想重新使用我的 Sphinx/reStructuredText 技能来记录我的 Clojure 代码。由于 Clojure 没有内置域，因此我开始编写一个。

具有讽刺意味的是，Sphinx 的文档对编写扩展没有任何帮助。所以，从 Python 和 Javascript 的内置模式开始，我已经有了一些基本的元素。我可以使用以下指令为函数编写文档：

但是，HTML 输出会生成 C/Python 样式的签名。前面的示例生成如下内容：

我宁愿以 lisp-ish 形式获得签名：

生成签名的代码似乎一直到docutils.addnodes模块。如何让 Sphinx 使用 Sphinx 语法生成 HTML？可以用模板来完成，还是我需要破解整个构建器系统才能做到这一点？

Github 将解析一个 reStructuredText 文件，如果其扩展名为.rst. docutilsbuildhtml.py只会解析带有扩展名的文件.txt，我看不到更改它的选项。这非常烦人。有什么方法可以让 Github 将文件识别.txt为 RST 或 buildhtml 来识别.rst文件？

是否可以在重组文本中删除文本？

<strike>例如，在转换为 HTML 时 呈现为标签的内容，例如： ReSTructuredText

我正在制作一个框架，让开发人员在其中使用 reStructuredText 描述他们的包。我想将该 reStructuredText 解析为 HTML，以便可以在 GUI 中显示它。

我对出色的 Sphinx 很熟悉，但我从未解析过 reStructuredText。我想像一个函数，它接受一个 reStructuredText 字符串，可能还有几个额外的参数，并返回一个 HTML 字符串。

所以我查看了负责解析reStructuredText的Docutils。我完全不明白如何找到这个功能。网络上的文档参差不齐。该模块中的许多功能docutils.parsers.rst似乎都针对文件名。我没有文件名！我只是在处理字符串。

我尝试创建 aParser和 aDocument并使用该parse方法，但我只是收到有关缺少.tab_width设置的错误。

有谁知道如何将 reStructuredText 解析成 HTML？

下面是我的代码

我收到以下错误：

所以，我args改为：

现在，没有错误。但是，插入 HTML 输出的样式表不是/home/wonder/lab/css/note.css. 它仍然是/usr/local/lib/python2.7/dist-packages/docutils/writers/html4css1/html4css1.css。

也就是说，与使用 publish_cmdline 时在命令行中指定选项不同，settings_overrides带有 HTML-Specific Options 的参数在使用 publish_string 时不起作用。