django - 在 django(和 python)中解析重构文本

Question

我将使用 Django(我来自 Sphinx)管理一些文档，以便更好地控制输出。这些文档位于 git 存档中的第一个(重组文本)中，使用过滤器以 HTML 形式显示它们很简单。我的问题是它们很长，我希望对分页的进行有更多的控制，这样我可以在每个 HTML 页面上显示一个部分，为单个部分添加注释等等......

我的目标是能够解析每个文档，创建目录，其中包含指向单独 HMTL 页面中每个部分的链接，其中 View 将遍历整个文档以仅在 html 中呈现一个部分。

我知道这主要是文档问题，我能找到的最有趣的例子是:http://www.ibm.com/developerworks/library/x-matters24/#code2但它似乎已经过时了，并且“面向树的处理”部分中的示例(这就是魔法所在)似乎不适用于我的 docutils 版本。文章很好:我可以使用更多相同主题的内容!

是否有与我计划做的事情类似的东西可供我研究，或者也许有人可以向我指出用于解析第一个文档的 docutils 的温和介绍？

Answer 1

这是一个博客，描述如何创建自定义第一个编写器并从 Django 调用它。我认为它应该给你一个好的开始http://www.arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html