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

Использование переменных в тексте

Переменные — это текстовые строковые значения, которые имеют уникальное имя в своей области (на уровне проекта или глобальное). Переменные используются для хранения значений, используемых во многих местах руководства пользователя, а также для их централизованного обновления. Хорошим примером является версия программного продукта.


Можно создавать проектные и глобальные переменные. Проектные переменные доступны во всех разделах проекта, а глобальные переменные доступны во всех проектах. Если в проектной и глобальной области есть переменная с одинаковым именем, будет использоваться переменная, проектного уровня.

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

Давайте начнем с создания переменной проекта...

Создание проектной переменной

  • Откройте проект, выбрав его в дереве проектов и нажав Открыть выбранный проект на панели инструментов.
  • В главном меню выберите Текущий проект | Переменные...
  • Нажмите Создать проектную переменную — новая строка будет добавлена в таблицу Проектные переменные.
  • Укажите имя и значение для новой переменной во встроенных редакторах добавленной строки таблицы. Помните, что значение представляет собой обычный текст.
  • Нажмите кнопку Обновить в правой части только что добавленной строки.

Вставка переменной на страницу

  • В режиме редактирования страницы переключитесь на вкладку Вставка.
  • Нажмите Вставить переменную в категории Публикация из единого источника.
  • В появившемся диалоговом окне Вставить переменную начните вводить имя переменной в поле Выберите переменную.
  • В выпадающем списке быстро отобразятся все проектные и глобальные переменные, в именах или значениях которых содержится введенный текст.
  • Выберите нужную переменную и нажмите ОК.
  • Выбранная переменная будет вставлена в текущую позицию в тексте страницы.