Appearance
Источники литературы
Источники литературы в документе объявляются один раз, отдельно от места использования, а затем упоминаются по всему тексту сколько угодно раз — подход, привычный по научным и учебным работам, где один и тот же источник может цитироваться в разных главах.
Объявление
Источник объявляется отдельной строкой с уникальной переменной и полным библиографическим описанием в кавычках:
md
[Ref]: RefVariableName "Полное описание источника"RefVariableName — уникальная переменная, через которую источник будет упоминаться в тексте, а текст в кавычках — то самое полное описание, которое попадёт в список литературы: автор, название, издательство, год и так далее, в зависимости от требований вашего шаблона.
Важно
Объявление источника должно находиться снаружи секции документа, а не внутри неё — так система может собрать все источники в единый список независимо от того, в какой части текста они упомянуты.
Ссылка
Чтобы сослаться на источник в тексте — например, поставить порядковый номер в квадратных скобках, — используется конструкция Liquid JS:
liquid
{{ Ref.RefVariableName.index }}Номер источника в списке литературы и во всех ссылках на него пересчитывается автоматически при добавлении, удалении или изменении порядка источников — вручную поддерживать нумерацию не нужно.