问题标签 [docutils]

见：http ://diveintopython.net/native_data_types/lists.html#d0e5623

我有一个网站，上面有代码示例，通过 生成docutils，而且 CSS 总是不太正确。

我想知道是否有

• 用于显示代码的最佳 CSS 实践（即它是否可以处理环绕、长行、任何获得着色的机会）

• 小数字标注的最佳实践（参见上面的diveintopython）

最后，我想知道是否有（开放的）CSS 旨在与 docutils HTML 输出一起使用并且实际上看起来“不错”。我很乐意贡献一些 CSS 使表格看起来像“微软专业灰色”等等。

我正在尝试在 Windows 7 上为 django 启用 docutils。我已启用 urls.y 和 settings.py 中的链接，并下载并安装了 docutils 的最新快照。但是，每次我尝试访问管理员中的文档链接时，都会出现一个页面，要求我安装 docutils。

有任何想法吗？

谢谢

我正在尝试将我们的 API 文档及其专有文档生成器架构迁移到 reStructuredText。最困难的部分是，我们有一个 API 详细信息的表格表示，直接用 HTML 编码，例如：

（即当前编码为<tr><td class='param'>id</td><td class='required'>Yes</td>...）

我想在 RST 中执行此操作，但要在语义上执行，而不仅仅是使用 RST 表格式。但是我找不到任何自定义指令的好例子来按我想要的方式处理这个问题，就像

我怎样才能在 reStructuredText 中做到这一点？

我正在为我的班级编写一个方法，我喜欢将我的项目国际化。现在我正在开发一个真正的多语言系统。我想翻译文档。
关于如何在方法定义后翻译新行在 django 文档中没有任何内容。
我试着写：

但在 admin-doc 中没有效果。

我希望能够在 Python 中解析基于 sphinx 的 rst 以进行进一步处理和检查。就像是：

使用 docutils.core.publish_file 在 docutils 中似乎有一些可能：

但这对狮身人面像特定指令等一无所知......

我有一些 reStructuredText 文档。我想在在线帮助中使用它的片段。似乎一种方法是通过引用“剪断”标记片段，例如

如何使用 python/docutils/sphinx 提取 _my_interesting_section 标记的标记？

我正在制作一个包含许多表格的文档。但是，我知道如何在文本中引用它们的唯一方法是使用 a:ref:'my_table'并将整个表格名称“我的表格的长标题”放在我的文本块中。我宁愿把它放在“表1.3”中……这可能吗？

一个单独但与表格相关的问题：是否有 sphinx/docutils 选项用于将表格名称/标题放在底部而不是顶部，还是样式表/乳胶的东西？

我想在 python 脚本中生成从乳胶创建的 pdf 输出。由于我正在使用 python xy 在 Windows 下工作并且我无法安装乳胶，我想知道是否有一种方法可以使用来自 pythonxy 的包（如sphinx或docutils）产生乳胶输出欢迎任何建议

这是一个简单的 reST 片段：

这是它被渲染的演示：

带有初始行：http
://rst.ninjs.org/?n=ff67380d732a33c7844f350c240804d0 没有初始行：http ://rst.ninjs.org/?n=550ea2c1b4233affdce1d158c5dc4d99

我正在使用以下 Python 渲染 reST：

如何在<h2>没有初始行的情况下获得副标题（特别是标签）？是否在子标题之上提供了两个层次结构？天真地提供页眉并没有帮助：http ://rst.ninjs.org/?n=e874f6eaad17c8ae7fd565f9ecb2212b

我尝试在 reStructuredText 的粗体文本中插入一个链接，但失败了。

这是我的第一个来源：

但我得到了：

我想得到这个：