Синтаксис шаблонов и счётчики
Обычный текст и коды
Заголовок раздела «Обычный текст и коды»Обычный текст выводится как написан. Распознанный код в {...} заменяется
значением. Коды набираются латинскими буквами с точками, без пробелов внутри.
Чтобы избежать опечаток, вставляйте их через «Добавить поле».
{album.name}. {photo.description}При названии «Общие виды» и описании «Вид с востока» получится «Общие виды. Вид с востока». Вставленное значение не разбирается повторно как шаблон: если в описании написаны скобки, они не запускают новые поля и счётчики.
Условный фрагмент
Заголовок раздела «Условный фрагмент»[[Автор: {photo.author}. ]]Фрагмент между [[ и ]] показывается, только когда заполнены все его
распознанные поля, кроме счётчиков. Значение из одних пробелов считается пустым.
Если хотя бы одного значения нет, скрывается весь фрагмент, включая постоянный текст.
Счётчик сам по себе не проверяет наличие описания или другого поля.
| Конструкция | Как ведёт себя |
|---|---|
[[{photo.author} — {photo.date}]] |
Показывается, если заполнены и автор, и дата |
[[{counter.photo}. {photo.description}]] |
Без описания скрывается, номер не расходуется |
[[{counter.photo}]] |
Счётчик не делает условие пустым; номер расходуется |
[[Обычный текст]] |
Нет распознанных полей — остаётся буквальный текст со скобками |
Нет вложенных условий, операторов «или» и произвольных выражений. Для независимых необязательных частей используйте соседние условия:
[[Автор: {photo.author}. ]][[Дата: {photo.date}.]]Форматы даты
Заголовок раздела «Форматы даты»В меню полей есть {photo.date}, {photo.date|long},
{photo.date|month-year}, {photo.date|year}.
Для даты 15.04.2026 это соответственно «15.04.2026», «15 апреля 2026»,
«апрель 2026», «2026». Пустая дата даёт пустое значение.
У остальных полей эти форматы не работают; дата и время EXIF — отдельный код.
Что происходит при ошибке
Заголовок раздела «Что происходит при ошибке»| Ошибка | Что увидите |
|---|---|
Неизвестное поле {unknown.field} |
Сам код вместе со скобками |
Неподдерживаемый формат {photo.author|year} |
Сам код, а не отформатированное значение |
Незакрытое [[... |
Буквальный текст нераспознанного фрагмента |
| Вложенное условие | Весь такой фрагмент остаётся буквальным |
| Неизвестный код внутри условия | Всё условие остаётся буквальным, а не частично выполняется |
Сохранение не блокируется только из-за такой конструкции. Проверьте предпросмотр: слово в скобках может попасть и в документ. Обычное пустое известное поле, напротив, не выводит свой код.
Пробелы, точки и переводы строк
Заголовок раздела «Пробелы, точки и переводы строк»Лишние обычные пробелы и одиночные разделители на стыках подстановок
убираются автоматически. Это помогает избежать лишней точки при пустом поле
или двух одинаковых знаков подряд после значения. Содержание самих полей,
многоточия и переводы строк сохраняются.
Очистка не исправляет произвольную пунктуацию и не заменяет условия:
слово «Автор:» перед пустым полем лучше поместить в [[...]].
Enter в шаблоне создаёт настоящий перевод строки. Перенос по ширине редактора не меняет подпись. Переключатель «∘↵» только показывает пробелы и переводы, не записывая эти знаки в документ.
Как выдаются номера
Заголовок раздела «Как выдаются номера»Сначала для каждого снимка выбирается шаблон: собственный, иначе групповой, иначе общий. Затем фотографии обрабатываются по порядку. Каждое появление кода счётчика в подписи получает следующий номер.
- Один
{counter.photo}на снимок даёт по одному номеру. - Два кода в одной подписи дают два следующих значения.
- Отсутствующий код и код в скрытом условии не расходуют номер.
- Пустая вставка между группами не расходует номер фотографии.
Групповой счётчик без отдельного старта продолжает последовательность, а не обнуляется на каждой группе. Для явного перезапуска задайте «Начать с» в настройках группы. Схема выдаёт и пропускает значения, затем исключает перечисленные номера. Точные настройки и примеры есть в «Поля, условия и счётчики».
