С помощью Sphinx-doc вы можете создать группу файлов ReStructureText с файлом index.rst, который содержит макрос оглавления, который автоматически генерирует таблицу содержимое из других включенных файлов и conf.py, который выступает в качестве конфигурации компиляции. Затем вы можете скомпилировать лот в один сайт в стиле python-doc, в комплекте с индексом, инструментами навигации и функцией поиска.
Есть ли сопоставимый инструмент для уценки (желательно уценка типа pandoc)?
Некоторые статические генераторы сайтов, которые работают с Markdown:
Я думаю, что ни один из них не использует pandoc (возможно, потому, что он написан в Haskell), но все они используют расширенный синтаксис Markdown или могут быть настроены для использования pandoc.
Другие интересные способы создания сайта из уценки:
Двигатели, использующие Pandoc:
Окончательный список генераторов статических сайтов
Хороший обзор генераторов статических узлов: http://staticsitegenerators.net/
Pandoc, GNU make и sed, посыпанными некоторыми CSS все, что вам нужно, чтобы полностью автоматизировать создание статического веб-сайта, начиная с Markdown.
Pandoc предлагает три варианта командной строки, которые могут обеспечивать навигацию между страницами, а также создание оглавления (TOC) на основе заголовков внутри страницы. С помощью CSS вы можете сделать навигацию и TOC выглядеть и вести себя так, как вы хотите.
-B FILE, --include-before-body = FILE
Включить содержимое файла FILE, в начале тела документа (например, после тега в HTML или команды \begin {document} в LaTeX). Это можно использовать для включения навигационных панелей или баннеров в HTML-документы. Этот параметр можно использовать повторно для включения нескольких файлов. Они будут включены в указанный заказ. Подразумевает --стандарт.
- toc, - table-of-contents
Включить автоматически сгенерированное оглавление.
- TOC-глубина = ЧИСЛО
Укажите количество уровней разделов для включения в оглавление. Значение по умолчанию равно 3 (это означает, что заголовки уровня 1, 2 и 3 будут указаны в содержимом).
По сути, мой личный сайт построен таким образом. Подробнее см. makefile. Это бесплатная лицензия с открытым исходным кодом под лицензией GNU GPL версии 3.
Если вы не используете Pandoc, mkdocs, похоже, соответствует вашим потребностям.
Если вы определенно хотите использовать Markdown Mark, вы можете проверить pdsite. Я написал это как способ генерации сайта в стиле mkdocs с большим количеством входных форматов (например, org-mode emacs) и без зависимостей Python - вы проходите в папку файлов Markdown и выходите на сайт HTML (включая автоматически генерируемые мультиплееры -уровневые навигационные ссылки). Это похоже на подход Сергея Стробандта, поскольку это всего лишь оболочка script (для этого требуется установить tree). К сожалению, у него еще нет функции поиска, хотя это не было бы слишком сложно добавить...