Вся компиляция сайта markdown/pandoc?

С помощью Sphinx-doc вы можете создать группу файлов ReStructureText с файлом index.rst, который содержит макрос оглавления, который автоматически генерирует таблицу содержимое из других включенных файлов и conf.py, который выступает в качестве конфигурации компиляции. Затем вы можете скомпилировать лот в один сайт в стиле python-doc, в комплекте с индексом, инструментами навигации и функцией поиска.

Есть ли сопоставимый инструмент для уценки (желательно уценка типа pandoc)?

Ответы

Ответ 1

Некоторые статические генераторы сайтов, которые работают с Markdown:

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

Другие интересные способы создания сайта из уценки:

  • Markdown-Wikis, основанные на файлах: f.ex. Gollum, Wiki-Engine, который также используется GitHub
  • Телеграмма: коммерческая; написанный Дэвидом Поллаком, изобретателем Lift- Scala -framework

Двигатели, использующие Pandoc:

Окончательный список генераторов статических сайтов

Хороший обзор генераторов статических узлов: http://staticsitegenerators.net/

Ответ 2

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.

Ответ 3

Если вы не используете Pandoc, mkdocs, похоже, соответствует вашим потребностям.

Если вы определенно хотите использовать Markdown Mark, вы можете проверить pdsite. Я написал это как способ генерации сайта в стиле mkdocs с большим количеством входных форматов (например, org-mode emacs) и без зависимостей Python - вы проходите в папку файлов Markdown и выходите на сайт HTML (включая автоматически генерируемые мультиплееры -уровневые навигационные ссылки). Это похоже на подход Сергея Стробандта, поскольку это всего лишь оболочка script (для этого требуется установить tree). К сожалению, у него еще нет функции поиска, хотя это не было бы слишком сложно добавить...