Мова опису розмітки

Швидке переміщення по статті:

• Теги форматування
  • Керування шрифтами
  • Теги для керування шрифтами
  • Атрибути тега <qrcode>
  • Розміри шрифтів для деяких пристроїв
  • Керування вирівнюванням
  • Друк зображень
  • Керування перенесенням тексту
  • Інші теги форматування
  • Приклад 2. Демонстрація тега <fill />
• Таблиці
  • Атрибути тега <table />
  • Приклад 3. Найпростіший документ із таблицею
  • Визначення колонок
  • Атрибути тега <column />
  • Визначення комірок
  • Атрибути тега <c /> та <ct />
  • Вкладені таблиці
  • Вкладена таблиця, що не займає весь рядок батьківської
• Макроси DocPreprocess.xslt
• Приклад 4. Форматування пречека

     Основні поняття 

     Мова опису розмітки використовується для друкованої форми документів, які виводяться на принтери та Фіскальні Реєстратори (надалі ФР). 

     Основна одиниця друку - документ у форматі xml з кореневим тегом <doc>. 

Приклад 1. Найпростіший документ 

     Найпростіший документ у цій розмітці має такий вигляд: 

<doc>текст для друку</doc>

     Результат: 

| текст для друку        |

     Які пристрої підтримуються 

     У прикладах наводиться очікуване виведення на принтер з одним підтримуваним шрифтом і шириною стрічки в 30 символів. Для позначення початку і кінця рядка (країв паперу) використовується символ " | ". 

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

     Розмітка документа має працювати на пристроях із шириною стрічки 16 символів - мінімальна ширина стрічки з пристроїв, які підтримуються на момент створення цієї статті. 

Атрибути тега <doc> 

     Теги форматування

Керування шрифтами 

     Є три розміри шрифту. Вони нумеруються цифрами від 0 до 2 у порядку збільшення розміру: шрифт номер 0 - найменший, шрифт номер 2 - найбільший. Якщо явно не вказано шрифт, то за замовчуванням використовується шрифт номер 0. 

     Усі теги, зазначені в таблиці нижче, змінюють шрифт для всіх вкладених у них елементів. 

Теги для керування шрифтами

<f0></f0>

<f1></f1>

<f2></f2>

<barcode></barcode>

<qrcode></qrcode>

<qrcode size="normal" correction="medium"> https://www.knaipateam-borsch.com/ </qrcode>

Атрибути тега <qrcode> 

Розміри шрифтів для деяких пристроїв 

     У таблиці для кожного розміру шрифту вказано кількість символів у рядку. 

     Усі ФР підтримують форматування тільки одним шрифтом, розміри якого задаються в налаштуваннях ФР, в Syrve Office. 

     Теги й атрибути зміни шрифтів заборонені всередині таблиць, для цього необхідно користуватися атрибутом font для комірок таблиці. 

Керування вирівнюванням 

     За замовчуванням у документі задано вирівнювання по лівому краю. У таблиці подано теги, що дають змогу змінювати спосіб вирівнювання для всіх вкладених у них елементів. 

     Теги для керування вирівнюванням 

<center></center>

<justify></justify>

<left></left>

<right></right>

Друк зображень

     За замовчуванням у документі друк зображень вимкнено. Тег для друку зображень:

<logo>index</logo>

Керування перенесенням тексту

     За замовчуванням у документі використовується перенесення тексту в будь-якому місці. У таблиці перелічено теги, які можна використовувати для перенесення тексту в документі. 

     Теги для керування перенесенням тексту

<split></split>

<wrap></wrap>

<cut></cut>

<br />

<np />

<nobr />

Інші теги форматування 

     За замовчуванням порожній простір між символами заповнюється пробілами. Тег <fill /> дає змогу перевизначити цю поведінку.

<fill />

     Слід враховувати, що тег <fill /> не перевизначає пробільні символи користувацького тексту. 

Приклад 2. Демонстрація тега <fill />

<doc>
  <left> текст з пробілом </left>
  <fill symbols=".">
    <br />
    <left> текст з пробілом </left>
    <np />
    <table>
      <columns>
        <column />
        <column />
      </columns>
      <cells>
        <c>лівий текст</c>
        <c>
          <right>правий текст</right>
        </c>
      </cells>
    </table>
  </fill>
</doc>

Результат:

| текст з пробілом                    |
| текст з пробілом ...................|
|.....................................|
|лівий текст              правий текст|

     Таблиці

Форматування таблиць - основний спосіб форматування документів. 

     Таблиця визначається тегом <table></table>, який містить обов'язкові дочірні теги: <columns></columns> (колонки таблиці), <cells></cells> (клітинки таблиці), які, своєю чергою, мають містити хоча б одне визначення колонки та комірки відповідно. 

Атрибути тега <table /> 

Приклад 3. Найпростіший документ із таблицею 

<doc>
  <table>
    <columns>
      <column />
    </columns>
    <cells>
      <c>Текст</c>
    </cells>
  </table>
</doc>

Визначення колонок 

     Колонки визначаються тегами <column /> усередині тега <columns /> у напрямку зліва направо. Для всіх клітинок кожної колонки можна задавати спосіб форматування за допомогою загальних атрибутів форматування: font, align і formatter (див. вище Атрибути тега <doc>). 

Атрибути тега <column /> 

     Колонки, які не розтягуються (атрибут autowidth) і для яких явно не задано розмір в атрибуті width, розподіляють місце, що залишилося від інших колонок, порівну. 

Визначення комірок

     Осередки (клітинки) визначаються тегами <c /> або <ct /> усередині тега <cells /> у напрямку зліва направо, згори вниз.

     За замовчуванням у кожному рядку таблиці виводиться стільки ж клітинок, скільки і колонок. 

     Тег <c> може містити будь-який контент, зокрема й інші теги форматування. Тег <ct /> може містити тільки текст.

     У колонках, що розтягуються (з атрибутом autowidth), має бути хоча б один осередок типу <ct />, і тільки за ним рахують ширину колонки для врахування розтягування колонки й обмежень minwidth і maxwidth.

Атрибути тега <c /> та <ct /> 

Вкладені таблиці

     Механізм форматування підтримує таблиці, вкладені в таблиці.

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

Вкладена таблиця, що не займає весь рядок батьківської

<doc>
  <table>
    <columns>
      <column width="10" />
      <column />
    </columns>
    <cells>
      <c>котрийсь текст</c>
      <c>котрийсь інший текст</c>
      <c font="f1">
        <table cellspacing="0">
          <columns>
            <column />
            <column valign="bottom" />
          </columns>
          <cells>
            <c>f0c1</c>
            <c>f0c2</c>
            <c font="f2">f2c1</c>
            <c>f2c2</c>
          </cells>
        </table>
      </c>
      <c>текст у батьківській таблиці</c>
    </cells>
  </table>
</doc>

<f0>, <f1> - це умовне позначення для рядків, що друкуються шрифтом f0 і f1.

     У цьому прикладі для першого рядка застосовано шрифт <f0>, тому що це шрифт за замовчуванням для документа і він не перевизначений.

     Шрифт вкладеної таблиці визначається шрифтом, заданим для рядка батьківської таблиці, у якому знаходиться вкладена таблиця. Перевизначення для другого рядка вкладеної таблиці (font="f2") не спрацювало, оскільки таблиця не займає цілий рядок батьківської таблиці. 

     Макроси DocPreprocess.xslt

Макроси - це теги, які не визначені в базовому наборі тегів форматування, і є скороченими версіями деяких типових конструкцій.

     Будемо позначати @attribute значення атрибута attribute з вихідного тега. 

<fill symbols="@symbols">
<np />
</fill>

<c colspan="0">
  <fill symbols="@symbols">
    <np />
  </fill>
</c>

<table>
  <columns>
    <column align="left" autowidth="" />
    <column align="right" />
  </columns>
  <cells>
    <ct>@left</ct>
    <ct>@right</ct>
  </cells>
</table>

<table>
  <columns>
    <column align="left" />
    <column align="right" autowidth="" />
  </columns>
  <cells>
    <ct>@left</ct>
    <ct>@right</ct>
  </cells>
</table>

<table>
  <columns>
    <column align="left" autowidth="" />
    <column align="left" />
  </columns>
  <cells>
    <ct>@left</ct>
    <ct>@right</ct>
  </cells>
</table>

     Приклад 4. Форматування пречека 

<doc>
  <left>
    <split>
      ******************************************      Мій ресторан ----- ТОВ «Syrve»      РНОКПП 1234657890      ******************************************    </split>
  </left>
  <center>ГОСТЬОВИЙ РАХУНОК</center>
  <pair fit="right" left=“Основний зал" right=“Стіл: 2" />
  <pair fit="right" left=“Відкрито: 13.03.2023 16:39" right=“Замовлення №459" />
  <left>Офіціант: Орест</left>
  <table>
    <columns>
      <column />
      <column align="right" autowidth="" />
      <column align="right" autowidth="" />
    </columns>
    <cells>
      <linecell />
      <ct>Найменування</ct>
      <ct>К-сть</ct>
      <ct>Сума</ct>
      <linecell />
      <c colspan="0">Гість 1</c>
      <ct>Ковбаска</ct>
      <ct>1</ct>
      <ct>10.00</ct>
      <ct>  +1</ct>
      <ct />
      <ct>1.00</ct>
      <ct>Горілка. Безалкогольна. Так, це можливо;)</ct>
      <ct>1</ct>
      <ct>20.00</ct>
      <ct>  +9</ct>
      <ct />
      <ct />
      <c colspan="2" />
      <c>
        <line />
      </c>
      <c colspan="2">Всього до сплати Гість 1:</c>
      <ct>31.00</ct>
      <linecell symbols=" " />
      <c colspan="0">Гість 2</c>
      <ct>Ковбаска</ct>
      <ct>1</ct>
      <ct>10.00</ct>
      <c colspan="2" />
      <c>
        <line />
      </c>
      <c colspan="2">Всього до сплати Гість 2:</c>
      <ct>10.00</ct>
      <linecell />
      <c colspan="2">ВСЬОГО ДО СПЛАТИ:</c>
      <ct>41.00</ct>
    </cells>
  </table>
  <np />
  <center>
    <split>
      ДЯКУЄМО! ПРИХОДЬТЕ ЩЕ!    </split>
  </center>
  <np />
  <np />
  <center>Гарного дня!</center>
  <np />
</doc>

Результат:

|******************************************                  |
|Мій ресторан ----- ТОВ «Syrve»                              |
|РНОКПП 1234657890                                           |
|******************************************                  |
|                      ГОСТЬОВИЙ РАХУНОК                     |
|Основний зал                                         Стіл: 2|
|Відкрито: 13.03.2023 16:39                   Замовлення №459|
|Офіціант: Орест                                             |
|------------------------------------------------------------|
|Найменування                                      К-сть Сума|
|------------------------------------------------------------|
|Гість 1                                                     |
|Ковбаска                                             1 10.00|
| +1                                                     1.00|
|Горілка. Безалкогольна. Так, це можливо;)            1 20.00|
| +9                                                         |
|                                                      ------|
|Всього до сплати Гість 1:                              31.00|
|                                                            |
|Гість 2                                                     |
|Ковбаска                                             1 10.00|
|                                                      ------|
|Всього до сплати Гість 2:                              10.00|
|------------------------------------------------------------|
|ВСЬОГО ДО СПЛАТИ:                                      41.00|
|                                                            |
|                   ДЯКУЄМО! ПРИХОДЬТЕ ЩЕ!                   |
|                                                            |
|                                                            |
|                        Гарного дня!                        |
|                                                            |