Базовое отображение

ГОСТ-ОН поддерживает 8 типов переменных:
Простые:

  1. Строка (string)
  2. Число (number)
  3. Дата (date)
  4. Логическое значение (boolean)
  5. Таблица (table)
    Составные:
  6. Простой список (list)
  7. Вложенный список (nested_list)
    Изображения:
  8. Изображение (image)

Простое отображение

Чтобы вывести простую переменную (string, number, date, boolean, table), заключите ее код в двойные фигурные скобки:

{{ string_example }}     - пример строки
{{ number_example }}     - пример числа
{{ date_example }}       - пример даты
{{ boolean_example }}    - пример логического значения
Пример таблицы:
{{ table_example }}

Результат:
Hello, world! - пример строки
-3.14159 - пример числа
16.04.2077 - пример даты
false - пример логического значения
Пример таблицы:

К выводу переменной можно применить стиль и форматирование:

<!​-- style size="20" font="Calibri" -->
_{{ string_example }}_
<!​-- style:end -->

Результат:

Hello, world!

Отображение списков

Список можно вывести тремя способами:

1) Простое отображение: {{ list_example }}
2) Отображение с помощью специальных фильтров (подробнее см. «Фильтры»):
 2.1 Нумерованный список
 {{ list_example | as_numbered_list }}
 2.2 Маркированный список
 {{ list_example | as_bullet_list }}
3) Отображение с помощью цикла (подробнее см. «Циклы»):
{% for n in list_example %}
1. {{ n }}
{% endfor %}

Результат:

  1. Простое отображение: ['красный', 'оранжевый', 'желтый', 'зеленый', 'голубой', 'синий', 'фиолетовый']
  2. Отображение с помощью специальных фильтров (подробнее см. «Фильтры»):
    2.1 Нумерованный список
  1. красный
  2. оранжевый
  3. желтый
  4. зеленый
  5. голубой
  6. синий
  7. фиолетовый
    2.2 Маркированный список
  • красный
  • оранжевый
  • желтый
  • зеленый
  • голубой
  • синий
  • фиолетовый
  1. Отображение с помощью цикла (подробнее см. «Циклы»):
  1. красный
  2. оранжевый
  3. желтый
  4. зеленый
  5. голубой
  6. синий
  7. фиолетовый
Пример отображения вложенного списка:
{{ nested_list_example | as_numbered_list }}

Пример отображения вложенного списка:

  1. зима
    1.1. декабрь
    1.2. январь
    1.3. февраль
  2. весна
    2.1. март
    2.2. апрель
    2.3. май
  3. лето
    3.1. июнь
    3.2. июль
    3.3. август
  4. осень
    4.1. сентябрь
    4.2. октябрь
    4.3. ноябрь

Фильтр «punctuate_list» сам расставляет знаки препинания в конце пунктов списка:

{{ list_example | as_bullet_list | punctuate_list }}

Результат:

  • красный;
  • оранжевый;
  • желтый;
  • зеленый;
  • голубой;
  • синий;
  • фиолетовый.

Вывод элемента списка

Чтобы вывести отдельный элемент списка, укажите после названия списка номер элемента в квадратных скобках (нумерация начинается с 0):

{{ list_example[1] }}

Результат:
оранжевый

Изображения

Изображение можно вывести двумя способами:

  1. URL-ссылка:
{{ image_example }}

Результат:
_assets/content-images/4a0baf9d3d56b9da.png

  1. Рисунок
    Изображение выводится с помощью специальных фильтров:
  • «| image('')» — картинка отдельным блоком (основной вариант; подпись в кавычках необязательна)
{{ image_example | image('Рисунок {figure_num} — Текст') }}

Результат:
Рисунок 20 — Текст

  • «| image» — блок с картинкой без подписи
{{ image_example | image }}

Результат:

  • «| inline» — картинка размером с букву прямо в строке
    Фильтр оборачивает адрес картинки в конструкцию \includegraphics.
{{ image_example | inline }}

Результат:
Текст с переменной-иконкой прямо в строке.

  • «| inline('')» — картинка заданной высоты в строке
    Ширина подстраивается автоматически с сохранением пропорций.
Большая в строке {{ image_example | inline('2em') }} — две высоты буквы.

Фиксированная высота {{ image_example | inline('20pt') }} — в пунктах.

В сантиметрах {{ image_example | inline('4cm') }} — точный размер.

Результат:
Большая в строке — две высоты буквы.

Фиксированная высота — в пунктах.

В сантиметрах — точный размер.

Допустимые единицы для inline('размер'):

Единица Что означает Когда использовать
em Размер относительно высоты текущего текста Лучший вариант для иконок внутри строки
pt Пункты Word/DOCX Когда важен стабильный размер в DOCX
px CSS-пиксели Удобно для предпросмотра и веб-публикаций
cm Сантиметры Для точного физического размера
mm Миллиметры Для мелких точных размеров
in Дюймы Для размеров в дюймах

Примечание

Если единицу не указать, размер считается в em: inline('2') = inline('2em').

Предыдущая
Следующая