在django（和python）中解析重组文本

Question

我将使用Django管理一些文档（我来自Sphinx），以便对输出进行更多控制。文档位于git存档中的第一个（重组文本），使用过滤器在HTML中显示它们是微不足道的。我的问题是它们很长，而且我希望能更好地控制分页的方式，所以我可以在每个HTML页面显示一个部分，对单个部分进行评论等等......

我的目标是能够解析每个文档，创建我的TOC，其中包含指向单独HMTL页面中每个部分的链接，其中一个视图将通过整个文档在html中呈现一个部分。

据我所知，这主要是一个docutils的问题，我能找到的最有趣的例子是：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

Answer 2

Pygments有一个ReST词法分析器，你可以检查（甚至可以直接使用）。