Совместимый с Linux статический генератор сайтов с гибким, мощным и хорошо документированным движком шаблонов и поддержкой markdown «из коробки».

Я использовал несколько различных генераторов статических сайтов, включая:

• GitBook
• Hexo
• HubPress
• Hugo
• Jekyll
• Pelican

И каждый из них не имел очень важной функции: гибкого, мощного и хорошо документированного движка шаблонов. Под этим я имею в виду движок шаблонов, который:

1. Позволяет включать содержимое из нескольких файлов в одном посте, при этом рендеринг будет таким же, как если бы содержимое нескольких файлов было помещено в пост. Например, на моем текущем блоге, работающем на Jekyll, я часто разбиваю посты на более мелкие и управляемые файлы markdown. Jekyll позволяет мне, используя движок шаблонов Liquid, включать эти файлы markdown в окончательный пост. Если вы хотите увидеть точно, что я использую и имею в виду, здесь пример файла поста, как вы можете увидеть, несколько файлов markdown включены в него с помощью {% include_relative <FILENAME> %}. Другие движки шаблонов не предоставили мне этой возможности.

2. Может быть широко настраиваем с использованием условных операторов, тестов, итераций, greps, seds, и т. д. Например, если бы я мог проверить, содержит ли вводимая строка строку (но не обязательно равна ей), это было бы полезно. Аналогичным образом, если бы я мог удалить всё, что находится перед косой чертой / (например, если ввод был веб-адресом http://www.example.com, это удалит http:// и оставит www.example.com) в вводе и использовать это, это было бы полезно. Если ввод был бы в форме a/b (например, games-strategy/megaglest, где a это games-strategy и b это megaglest), было бы полезно, если бы я мог разделить его на две части a и b и использовать a и b отдельно в своих шаблонах.

3. Имеет исчерпывающую документацию. Я не встречал ни одного движка шаблонов, используемого генератором статических сайтов, который имел бы исчерпывающую документацию, тот, у кого была лучшая документация на момент написания этого вопроса, вероятно, был Liquid, но она все равно не исчерпывающая.

Совместимость с Linux тоже важна, так как я хотел бы развернуть на страницах GitHub, и для этого, с большинством SSG (кроме Jekyll и HubPress) мне нужно иметь возможность строить сайт локально (что для меня на Linux), а затем загружать содержимое сайта в ветку gh-pages моего репозитория. Поддержка постов в markdown также обязательна. Если на сайте можно включить страницы, отличные от постов (например, страницу “обо мне” для сайта), это тоже будет отлично.

Я бы предложил взглянуть на злого близнеца Jekyll Hyde.

• Шаблоны через Jinja2, который имеет обширную документацию и включает обширные условные операторы и т. д.
• Markdown реализован в Python Markdown, который имеет обширный список расширений и API для расширений. Одно из доступных расширений, использующих этот API, это markdown include.
• Все вышеперечисленные инструменты написаны на Python, поэтому совместимость с Linux не является проблемой

• Hyde имеет 4 команды из командной строки:

  • hyde create Создать начальную структуру файлов
  • hyde gen Генерировать страницы, по умолчанию инкрементально
  • hyde serve Запустить локальный тестовый веб-сервер с автоматической (пер-)генерацией
  • hyde publish Опубликовать сгенерированные файлы в указанное место, например, на страницах GitHub.