Analisi del testo ristrutturata nel Django (e pitone)

Question

ho intenzione di gestire una documentazione Django (io vengo da Sfinge) al fine di avere un maggiore controllo sulla produzione. La documentazione è in prima (testo ristrutturato) in un archivio git, ed è banale per visualizzarli in HTML utilizzando un filtro. Il mio problema è che sono piuttosto lungo, e mi piacerebbe avere un maggiore controllo su come la paginazione va, in modo da poter mostrare una singola sezione per pagina HTML, avere commenti per una singola sezione e così via ...

Il mio obiettivo sarebbe quello di essere in grado di analizzare ogni documento, creare il mio sommario con collegamenti a ogni sezione in una pagina HTML separata, dove la vista sarebbe passare attraverso tutta la doc per il rendering in HTML solo una sezione.

Mi rendo conto che è per lo più una questione di docutils, l'esempio più interessante che ho potuto trovare è: http://www.ibm.com/developerworks/library/x-matters24/#code2 ma sembra superata e gli esempi nella sezione 'trattamento Tree-oriented', che è dove la magia va, non sembrano lavorare con la mia versione di docutils. L'articolo è buono: ho potuto usare più dello stesso soggetto

C'è qualcosa di simile a quello che sto pensando di fare già a disposizione che posso studiare, o forse qualcuno mi potrebbe puntare a un'introduzione graduale alla docutils per l'analisi di primi documenti?

Answer 1

Ecco un blog che descrive howto fare un primo scrittore di costume e chiamare da Django. Penso che dovrebbe dare un buon inizio http: // www. arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html

Answer 2

Pygments ha un lexer riposo che si potrebbe esaminare (o forse anche utilizzare direttamente).