Добавление произведения
Создание файла
- Зайдите в каталог автора. Создайте файл
*.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 %}
Каждая сноска — отдельной строкой (важно помнить, что каждая строка трактуется как отдельная сноска и отбивка, например, тегов-контейнеров от их содержимого может привести к ошибке). Номера будут проставлены автоматически, определение будет отделено от описания длинным тире.