Я собираюсь управлять некоторой документацией, используя Django (я из Sphinx), чтобы иметь больше контроля над выводом. Документы находятся в первом (реструктурированный текст) в git-архиве, и их тривиально отображать в HTML с помощью фильтра. Моя проблема в том, что они довольно длинные, и я хотел бы иметь больше контроля над тем, как происходит разбиение на страницы, чтобы я мог показать один раздел на страницу HTML, иметь комментарии для одного раздела и так далее ...
Моя цель состоит в том, чтобы иметь возможность проанализировать каждый документ, создать свое оглавление со ссылками на каждый раздел на отдельной странице HMTL, где представление будет проходить через весь документ для отображения в html только раздела.
Я понимаю, что это в основном вопрос документации, самый интересный пример, который мне удалось найти, это: http://www.ibm.com/developerworks/library/x-matters24/#code2, но он выглядит устаревшим, и примеры в разделе "Древовидная обработка", который где магия идет, не похоже на работу с моей версией документации. Статья хороша: я мог бы использовать больше того же предмета!
Есть ли что-то похожее на то, что я планирую сделать, уже доступным для изучения, или, может быть, кто-то может указать мне на небольшое введение в документацию для разбора первых документов?