Alstre
Спробувати
08 · Шаблони документів

Редагування коду шаблону

Перегляд вихідного коду для нетипових документів: власні стилі, макети й розділи, яких немає серед блоків. Пишемо, коли справді варто ним скористатися і що обмежує рушій друку.

Де це ввімкнути

Над полем редагування є перемикач Візуально / HTML. Перший варіант показує документ таким, яким він виглядає; другий — його вихідний код.

Це не те саме, що розширений режим
Перемикач Базовий / Розширений відповідає за інше: чи можна, крім блоків, вставляти змінні. Вихідний код відкриває лише описаний тут перемикач HTML.

У візуальному поданні блоки й змінні видно як вбудовані елементи — під час формування роздруківки їх буде заповнено вмістом.

Коли це варто робити

Рідше, ніж здається. Перш ніж братися за код, перевірте, чи потрібного елемента ще немає в бібліотеці блоків: блоки підтримують разом із системою, і вони самі встигають за змінами в договорі.

Код має сенс у трьох випадках:

  • Відповідність брендбуку — конкретні кольори, відступи й шрифти, яких не налаштуєш перемикачами.
  • Розділ, якого немає серед блоків — наприклад, власні комерційні умови або правила магазину.
  • Виправлення макета — ширина стовпців у таблиці позицій, відступи перед підписами, примусовий розрив сторінки.

Що можна зробити в коді

  • Стилі, записані безпосередньо в елементі, наприклад <div style="color:#005bbb">
  • Зміна структури таблиці, кольорів і відступів
  • Власні розділи й абзаци поза блоками
  • Змінні в будь-якому місці, наприклад {{customer_name}}
  • Блоки як порожні теги <div data-block="..."> — вміст підставляється під час друку
Умови не пишуть вручну
Фрагмент, що залежить від виду покупця, вставляється умовним блоком — і в цьому режимі теж. Запис на кшталт {{#if}} не спрацює: його буде надруковано дослівно, разом із дужками.

Чого не зробить рушій друку

Шаблон потрапляє до браузера, який формує PDF, тож стилі поводяться так само, як на вебсторінці. Однак чотири речі працюють інакше:

Без JavaScript
Документ статичний. Нічого не перераховується й не анімується.
Стилі лише всередині
Таблиці стилів, що завантажуються із зовнішніх адрес, можуть не підвантажитися. Усе записуйте в елементах або в блоці стилів у тексті шаблону.
Зображення з повною адресою
Графіка повинна мати повну адресу або походити з файлів, завантажених у налаштуваннях фірми. Відносний шлях не спрацює.
Розриви сторінок
Ними керують через page-break-before: always і page-break-inside: avoid. Друге варто застосувати до таблиці позицій, щоб рядок не розривався між сторінками.

Документ друкується у форматі A4 зі збереженням кольорів фону. Верхній і нижній колонтитули — окремі частини шаблону; рушій сам обчислює для них поле, тож вгадувати його не доведеться.

Як працювати безпечно

  • Перевіряйте перегляд після кожної зміни. Один незакритий тег може розладнати всю подальшу частину документа.
  • Перегляньте обидва сценарії — приватну особу й фірму.
  • Зробіть пробний друк у PDF. Перегляд на екрані не показує поділу на сторінки.
  • Вносьте зміни в копію шаблону. Новий шаблон з тієї самої відправної точки забирає хвилину, зате дає змогу повернутися до версії, яка працювала.
Один шаблон у коді, решта — з блоків
Шаблон, відредагований вручну, перестає отримувати поліпшення, які ми додаємо до блоків. У коді варто тримати лише той документ, що справді цього потребує, а решту залишити на блоках.