Добавление произведения

Создание файла

Зайдите в каталог автора. Создайте файл *.html (можно копировать уже существующий и изменять настройки). Задайте все необходимые настройки.
Первой строкой подключите основной шаблон.

Добавление переменных

Добавьте обязательные основные настройки, а также специфичные для данного типа страниц:

parentTitle — название произведения (для страницы, не являющейся самостоятельным опусом). Оно будет выведено как заголовок первого уровня, а title — как заголовок второго уровня.
workdate — дата написания произведения (указывается, если представлена в формате DD.MM.YYYY).
workplace — место написания произведения (произвольная осмысленная строка).

Добавление даты и места написания произведения

Если задан параметр workdate в формате DD.MM.YYYY, нужный функционал работает автоматически, опционально добавляя и значение workplace, если оно есть.

Если дата неполная (год и месяц, просто год), задаётся кастомный блок, например:

{% block dateplace %}
  <time class="page__workdate" datetime="2011">2011</time>
{% endblock %}

Если используется диапазон дат, то следует создать такой же кастомный блок, в datetime тега <time> указав крайнюю дату диапазона, причём если она в нужном формате, то через параметр workdate (для потенциального агрегирования).

Если представлено место написания, даже в кастомном блоке рекомендуется выводить его параметром workplace — для удобства обработки.

Создание сносок

Для создания сноски в тексте используется макрос notelink, первым параметром которого является инлайновый (который допустимо поместить в <span>) html-код, который будет подсвечен при обратном переходе из блока сносок, а вторым — номер сноски, например:

На {{notelink('мги', 1)}} осенней полусон.

Третьим параметром может выступать строковый ключ, меняющий поведение. Пока реализован только один — double — определяющий, что сноска является дубликатом и не должна иметь id.

Для создания списка ссылок используется отдельный блок (пример соответствует вышеуказанному примеру инлайнового кода):

{% block notes %}
  [Мга] то же, что и мгла (словарь Ожегова) — прим. авт.
{% endblock %}

Каждая сноска — отдельной строкой (важно помнить, что каждая строка трактуется как отдельная сноска и отбивка, например, тегов-контейнеров от их содержимого может привести к ошибке). Номера будут проставлены автоматически, определение будет отделено от описания длинным тире.