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

Question

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

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

Answer 1

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

• Jekyll является очень популярным, а также двигатель позади GitHub pages.
• Python варианта: Hyde или Pelican
• nanoc (используемые f.ex. в GitHub API documentation)
• Middlemanapp: может быть, лучший вариант?

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

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

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

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

• Gitit: Pandoc Wiki
• Pandoc-Plugin forIkiwiki
• Yst static site generator
• Gouda - generates a site from a directory of markdown files
• Rippledoc - generates a navigable site from nested directories of markdown files

Окончательный список Генераторы Статическая сайта

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

Answer 2

Pandoc, ГНУ make и sed команды, посыпают некоторым CSS все, что вам нужно полностью автоматизировать создание статического веб-сайта, начиная с Markdown.

Pandoc предлагает три опции командной строки, которые могут обеспечивать навигацию между страницами, а также создание оглавления (TOC) на основе заголовков внутри страницы. С помощью CSS вы можете сделать навигацию и TOC выглядеть и вести себя так, как вы хотите.

-B FILE, --include-до того тела = FILE

Включить содержимое файла, стенографические, в начале тела документа (например, после тега в HTML, или \ {начать document} в LaTeX). Это можно использовать для включения навигационных панелей или баннеров в HTML-документы. Этот параметр можно использовать повторно для включения нескольких файлов. Они будут включены в указанный заказ. Подразумевает --стандарт.

--toc, --table-из-содержимого

Включить автоматически сгенерированного оглавление.

--toc глубина = ЧИСЛО

Укажите количество уровней раздела, чтобы включить в таблицу содержимого. Значение по умолчанию равно 3 (это означает, что заголовки уровня 1, 2 и 3 будут указаны в содержимом).

По сути, my personal website is built this way. За более подробной информацией обратитесь к его makefile. Это бесплатная лицензия с открытым исходным кодом под лицензией GNU GPL version 3.

Answer 3

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

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