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

Объединение списков с помощью сниппетов

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

Этот подход работает как для нумерованных, так и для маркированных списков.

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

Объединение списков на странице справки

Выполните следующие действия, чтобы объединить списки с помощью сниппета:

  • Создайте страницу для хранения списка, который вы собираетесь вставлять в качестве сниппета в другие списки.
    Список в контенте страницы в режиме просмотра
    Его HTML-код должен выглядеть примерно следующим образом:
    HTML
    <ul>
    <li>Snippet Item</li>
    <li>Snippet Item</li>
    <li>Snippet Item</li>
    </ul>

    Примечание
    Примечание: сниппет не должен содержать ничего, кроме самого списка.
  • Откройте страницу справки со списком, в который вы хотите вставить сниппет.
    Страница со списком для вставки в качестве сниппета
  • Создайте пустой элемент списка после номера, в который вы хотите вставить список сниппета.
    Создайте пустой элемент списка для вставки списка сниппета
  • Нажмите Вставить сниппет в разделе Публикация из единого источника на вкладке Вставка.
  • Начните вводить заголовок страницы-сниппета в поле Выберите страницу.
  • Выберите страницу-сниппет в выпадающем меню с соответствующими результатами.
  • Сниппет будет вставлен в список.
    Список сниппета, вставленный в целевой список в режиме редактирования
  • Нажмите Разблокировать и смотреть, чтобы проверить, как будет выглядеть список на странице, а также посмотреть, как работает автоматическая нумерация.
    Целевой список со списком сниппета в режиме просмотра
Примечание
Контейнер <li> (элемент целевого списка), в который вы вставляете сниппет, должен быть пустым — внутри него может быть только тег <br/> или пустые теги <p>.

HTML
<ol>
<li>Main List Item</li>
<li><ch:snippet .../>
<br/>
</li>
<li>Main List Item</li>
<li>Main List Item</li>
</ol>

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