我正在使用 Django 的标记包将 restructuredText 转换为 html。有没有办法自定义 HTML 编写器为每个<p>标签添加一个类属性？

我可以对每个段落使用class 指令，但我想自动化这个过程。

例如，我想要这个重组后的文本：

转换成这个html。

我想插入类的原因是因为我使用的是连字符库，它通过向所有带有“连字符”类的标签添加连字符来工作。我可以将连字符类添加到容器标签中，但是所有的孩子都会继承连字符类。我可以使用 javascript 来动态添加类，但我认为可能有一种简单的方法来使用 restructuredText。

谢谢您的帮助，

乔

我想在 restructuredText 中使用一些符号；我怎样才能做到这一点？（例如，在 Markdown 中产生标准 HTML 字符实体列表中→定义的“→”符号——另见w3c 参考）

注意：我不想要求数学公式支持作为依赖项。

我需要一个 PHP 项目的文档系统，并且我希望它能够将外部文档（用例、项目范围等）与从代码注释生成的文档集成。似乎 phpDocumentor 具有完全正确的功能集，但外部文档必须用 DocBook 编写，这对我们的团队来说太复杂了。

如果它在 python 中，sphinx 将非常适合这项工作（ReST 绝对比 docbook 简单）。有什么方法可以将外部 ReST 文档与从 phpdoc 中提取的文档集成在一起？我是否应该将外部文档分开（例如，将 ReST 用于外部，将 phpdoc 用于内部）？或者您对管理外部文档有更好的建议吗？

相关：如何在数据库中存储轻量级格式（Textile、Markdown）？

我想在我们的数据库中以某种标记语言存储评论格式。但是，我们希望允许多种格式语言（markdown、textile、restructuredText）。看来我们应该存储它们的特征的超集，以便我们可以在它们之间进行转换。

• 这行得通吗？
• 有这样的超集吗？
• 是否有库可以在它们之间切换？
• 我们应该在数据库中保留更结构化的格式吗？

（如果重要，Python/Google App Engine）

是Sphinx，有没有办法自动将文本链接#112到Tracr1023中的相应票证/变更集？

例如：

有关更多示例，请参阅TracLinks。

我想要一个基于 html 的静态站点，而不是博客/cms，它有几个（很少更新）页面。我认为更新它们的最简单方法是将源保持为 ReST 之类的格式，并在每次更新时对其进行编译。对于这种用法，推荐的编译器是什么？我想拥有自己的主题/设计，除了正确的 ReST 语法之外我不需要任何东西（例如，Sphinx 太多了）。

我更喜欢在声明参数的同一行记录每个参数（根据需要），以便应用DRY

如果我有这样的代码：

如何避免重复文档字符串中的参数并保留参数说明？

我想避免：

这在带有某种装饰器操作的 python 2.6 或 python 3 中是否可行？还有其他方法吗？

rst 有没有办法自动标头编号？那是这样的：

这将呈现为：

1.一些部分

...

1.1 一些小节

...

1.2 另一小节

...

2.另一个部分

...

我正在开发一个报告工具，需要生成各种格式的报告，包括 pdf、html 和 excel（.xls 或任何可以在 excel 中轻松打开的格式）

我正在考虑以 xhtml 或 restructuredtext(rst) 生成基本报告，然后将其转换为其他格式，我可以使用 xhtml2pdf 或 rst2pdf 进行 pdf 转换，但我无法找到任何可以执行 xhtml 或 rst 的工具/库以 excel转换。

Q1。是否有任何 rst 或 xhtml 到 excel 转换器？

还有什么其他选择？例如，我正在考虑将基本文档生成为python对象列表，然后通过reportlab将它们转换为pdf或通过xlwt（http://pypi.python.org/pypi/xlwt）将它们转换为excel

Q2。是否已经有任何这样的 python 文档模型？

Q3。生成 rst 并解析它以使用 xlwt 生成 xls 文件有多容易？

我一直在使用Sphinx和reStructuredText记录一个软件包。

在我的文档中，有一些长代码片段。我希望能够将它们默认隐藏，并带有一个可以展开它们的小“显示/隐藏”按钮（示例）。

有没有标准的方法来做到这一点？