Запросить демо

Вебинар о Лучших практиках единого источника · 25 июня 2024, 18:00 (МСК)

Зарегистрироваться
Запросить демо
Документерра: руководство пользователя

Условный контент

При создании онлайн-документации может возникнуть необходимость получить разные публикации из одного проекта. Различия между публикациями могут быть слишком незначительны, и было бы нецелесообразно создавать отдельный проект.

В системе Документерра можно создавать условный контент, что является одним из методов создания нескольких публикаций из единого источника. Помимо переменных и сниппетов, также можно использовать условные блоки. Это означает, что фрагменты контента можно включать в один вариант публикации и исключать из другого.

Например, у вас может быть инструкция для администраторов, которая является частью контента страницы, предназначенной для широкой аудитории. При этом данная инструкция будет исключена из PDF-файла, который вы отправляете своим читателям, но будет присутствовать в онлайн-публикации, доступной только администраторам.

Вы можете легко управлять блоками условного контента с помощью режима «Дизайн». В частности, с помощью раздела Единый источник на вкладке Вставка в ленте.

Elements in the Single-Sourcing section

Три опции здесь относятся к условным блокам:

  1. Вставить условный блок — Вставляет условный блок либо с содержимым по умолчанию, либо для выделенного фрагмента. 
  2. Сделать включением/Сделать исключением — делает условным текущий активный элемент или общий родительский элемент.
  3. Очистить условия — отменяет условия для активного в данный момент элемента или для общего родительского элемента.

Обе опции Вставить условный блок и Сделать условным могут быть Включением и Исключением.

  • Содержимое с типом условия Включение будет включено в публикаци, только если проект будет публиковаться с указанным тегом (тегами).
  • Содержимое с типом условия Исключение не будет включено в публикацию, только если проект публикуется с указанным тегом (тегами).

Вставить условный блок

Данные команды вставляют элемент блокового уровня с контентом по умолчанию в позицию курсора. 

Вставка условного блока по умолчанию в текст

Если вы выделили элемент и нажали одну из этих двух опций, контент выделенного элемента заменит контент по умолчанию в условном блоке.

Сделать условным

Данная команда нужна не для вставки нового контента, а для того, чтобы сделать существующий контент условным.

Если выделения нет, условие будет применено к текущему активному элементу. Текущий активный элемент отображается в Инспекторе тегов:

Просмотр текущего активного элемента в Инспекторе тегов

При наведении курсора на любую из опций Сделать включением / исключением происходит выделение элемента, который будет преобразован в условный.

Преобразование текущего элемента в условный контент

Если выбрать несколько элементов, условие будет применено к общему родительскому элементу блокового уровня.

Очистить условия

Эта кнопка полностью соответствует своему названию - она очищает элементы от примененных к ним условий.   Если элементы не выбраны, условия будут отменены для текущего активного элемента.   Если элементы выделены, условия будут отменены для всех выделенных элементов. Эта функция удаляет только условия. При этом контент сохраняется.

Вы также можете отменить условия, нажав кнопку Очистить условия в Инспекторе тегов или в контекстном меню:

Опция «Отменить условия» в контекстном меню

Добавление условий через исходный код

Вы также можете добавить условия к любым тегам HTML и Документерры, добавив атрибут в исходном коде. Пример:

HTML
<p ch:include="OnlineDoc,First">A paragraph</p>

Вам нужно будет добавить атрибуты ch:include или ch:exclude. Можно добавить несколько тегов через запятую.

Предпросмотр публикации с условными блоками

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

  1. Переключитесь в режим Предпросмотра в редакторе. 
  2. В верхней панели выберите вкладку Просмотр.
  3. Нажмите на поле Выбор условных тегов и выберите условные теги, с которыми вы хотите выполнить предпросмотр.
  4. Нажмите Применить.

В режиме предпросмотра Вы увидите публикацию, сгенерированную для выбранного условного тега с учетом переменных, сниппетов и условных блоков.