Parsen umstrukturiert Text in django (und Python)

Question

Ich werde eine Dokumentation mit Django verwalten (ich komme aus Sphinx), um auf dem Ausgang mehr Kontrolle zu haben. Die Dokumente sind in erster (neu strukturiert Text) in einem git-Archiv, und es ist trivial sie in HTML angezeigt werden unter Verwendung eines Filters. Mein Problem ist, dass sie sehr lang sind, und ich möchte mehr Kontrolle haben, wie die Paginierung geht, so dass ich einen einzelnen Abschnitt per HTML-Seite anzeigen kann, haben Kommentare für einen einzelnen Abschnitt und so weiter ...

Mein Ziel wäre in der Lage sein, jedes Dokument zu analysieren, schaffen sie meine TOC mit Links zu jedem Abschnitt in einer separaten HMTL Seite, wo ein Blick durch ganze doc in html gehen würde, nur einen Abschnitt zu machen.

Ich verstehe, dass es ist vor allem eine Frage der docutils, das interessanteste Beispiel ich in der Lage gewesen bin zu finden ist: http://www.ibm.com/developerworks/library/x-matters24/#code2 aber es scheint veraltet und die Beispiele in Abschnitt ‚Baum-orientierte Verarbeitung‘, das ist wo die Magie geht, scheint nicht die Arbeit mit meiner Version von docutils. Artikel ist gut: Ich könnte mehr von dem gleichen Thema verwenden

Gibt es etwas Ähnliches, was ich plane bereits zu tun, dass ich studieren kann, oder vielleicht könnte jemand Punkt mich auf eine sanfte Einführung in docutils für erste Dokumente Parsen?

Answer 1

Hier ist ein Blog beschreibt Howto einen benutzerdefinierten ersten Schriftsteller zu machen und es von Django nennen. Ich denke, es sollte Ihnen einen guten Start http: // www. arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html

Answer 2

Pygments hat eine Pause Lexer, dass man untersuchen könnte (oder möglicherweise sogar direkt verwenden).