Разбор реструктурированный текст в Джангу (и Python)

Question

Я собираюсь управлять некоторой документацией, используя Django (я прихожу из Сфинкса), чтобы иметь больше контроля на выходе. Документы находятся в RST (реструктурированном тексте) в архиве Git, и он тривиален для их отображения в HTML с помощью фильтра. Моя проблема в том, что они довольно долго, и я хотел бы иметь больше контроля над тем, как проходит страница, поэтому я могу показать одну секцию на страницу HTML, есть комментарии для одного раздела и так далее ...

Моя цель будет способна проанализировать каждый док, создать мой TOC со ссылками на каждый раздел на отдельной странице HMTL, где представление будет проходить через целый документ для рендера в HTML просто раздел.

Я понимаю, что это в основном проблема документа, самый интересный пример, который я смог найти: http://www.ibm.com/developerworks/library/x-matters24/#code2. Но кажется устаревшим и примером в разделе «Ориентированная на деревьях обработку», которая находится там, где происходит волшебство, не кажется работать с моей версией Docutils. Статья хорошая: я мог бы использовать больше того же предмета!

Есть ли что-то похожее на то, что я планирую сделать уже доступен, что я могу учиться, или, может быть, может кто-то указать мне нежное введение в документацию для разборки RST-документов?

Answer 1

Вот в блоге, описывающем, как сделать пользовательский RST-писатель и назвать его от Django. Я думаю, что это должно дать вам хорошее начало http://www.arnebrodowski.de/blog/write-your-own-ressucturedtext-writer.html.

Answer 2

Пожелание отдыхает лексером, который вы могли бы исследовать (или, возможно, даже использовать напрямую).