Несколько страниц HTML вывод из документа .rst в Django

Question

Я пишу приложение Django, чтобы служить некоторой документации, написанной в реструктуретелетексту. У меня много документов, написанных в * .rst, каждый из них довольно длинный со многими разделами, подразделами и так далее.

Отображение всего документа на одной странице не является проблемой, используя фильтры Django, но я бы предпочел бы иметь только тему индекс на первой странице, ничья ссылки на URL-адрес, где я могу отобразить один раздел / подраздел (что понадобится некоторые «Предыдущая | Up | Главная | Следующая ссылка, которую я думаю ...). В некотором смысле похоже на «многократный выход HTML-страницы», как в документе / XML к преобразованию HTML.

Может ли кто-нибудь указать мне некоторое направление для создания дерева документа A * .RST документировать разбор одного раздела, или предложить умный способ получить аналогичный результат?

Answer 1

Выбор 1. Включите URL-ссылки на другие части документа.

Вы пишете index.rst, part1.rst, part2.rst и т. Д. И ваш index.rst имеет ссылки на другие детали. Это требует практически без работы, кроме тщательного планирования, чтобы убедиться, что ваши RST HTML-ссылки верны.

Там нет «анализа». Вы просто разбите свой документ в разделы. Вручную.

Это кажется настолько очевидно, я боюсь упомянуть это.

Выбор 2. Используйте Сфинкс. Отказ Он очень хорошо удается с таблицей и междокументированными соединениями.

Тем не менее, расширения SPHINX для RST не обрабатываются непосредственно Django, поэтому вам нужно будет сохранить вывод SPHINX, а затем отображать, что в Django. Мы используем JSON HTML Builder (http://sphinx.pocoo.org/builders.html?highthlight=json#sphinx.builders.html.jsonhtmlbuilder) Выход из сфинкса. Затем мы оказываем эти документы через шаблон.