Analysis of restructured text in django (and python)

Question

I am going to manage some documentation using Django (I came from Sphinx) to have more control over the exit. Documents first (restructured text) in the git archive, and it is trivial to display them in HTML using a filter. My problem is that they are quite long, and I would like to have more control over how pagination happens, so I can show one section on an HTML page, write comments for one section and so on ...

My goal would be to be able to analyze each document, create my TOC with links to each section on a separate HMTL page, where the presentation will go through the entire document to display only the section in html.

I understand that this is basically a docutils problem, the most interesting example I could find is: http://www.ibm.com/developerworks/library/x-matters24/#code2 , but it seems deprecated, and the examples in The "Wood Oriented Processing" section in which magic happens does not work with my version of docutils. The article is good: I could use more than one subject!

Is there something similar to what I plan to make already available that I can study, or maybe someone can point me to a gentle introduction to docutils for analyzing the first documents?

Answer 1

, , Django. , http://www.arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html

Answer 2

Pygments ReST, (, , ).