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

 Импорт макросов Confluence

В данной статье описывается, как Документерра обрабатывает макросы Confluence в процессе импорта.

Поддерживаемые макросы

Все поддерживаемые макросы Confluence будут автоматически преобразованы в соответствующие элементы системы Документерра или обработаны с сохранением их контента. Ниже приведен список поддерживаемых макросов:

Макрос Confluence
Элемент ClickHelp
Комментарий
Якорь (точка привязки гипертекстовой ссылки)
Якорь

Отображение дочерних страниц
Связанные статьи

Блок кода
Блок кода

Условный контент
Условный контент Часть функционала Версий разделов. Условные страницы с Вариантами импортируются как страницы с условными тегами, созданными из примененных к ним вариантов.
Decision
Экспресс-блоки
Импортируется как Информационный блок с другим цветом фона.
Error
Экспресс-блоки
Импортируется как Блок Ошибки
Цитата (Excerpt и Excerpt Include)
Сниппеты контента
Об особенностях импорта фрагментов можно узнать ниже.
Развернуть
Выпадающий текст
Скрыть, если / Показать, если
Условный контент
Импортируется как Включающий/Исключающий блок, преобразующий группы пользователей в условные теги.
Горизонтальная линия 
Горизонтальная линия
Информация
Экспресс-блоки
Импортируется как Информационный блок
Примечание
Экспресс-блоки
Импортируется как Информационный блок
Панель

Импортируется как HTML-элемент <p> с сохранением своих стилей, таких как размер шрифта, стили границ, цвет фона и т.д.
Success
Экспресс-блоки
Импортируется как Успешный блок
Совет
Экспресс-блоки
Импортируется как Информационный блок
Дерево страниц
Оглавление статьи

Инлайн стили, такие как list-style-type,indent и т. д. не сохраняются.

Макрос Зона Дерева страниц не поддерживается.

Уведомление
Экспресс-блоки
Импортируется как Блок Предупреждения

Неподдерживаемые макросы

На шаге 3 Мастера импорта из Confluence есть параметр Обработка неподдерживаемых макросов. Данная настройка позволяет выбрать способ обработки неподдерживаемых макросов:  Удаление неподдерживаемых макросов или Замена неподдерживаемых макросов плейсхолдерами.

Параметр Обработки неподдерживаемых макросов в Мастере импорта проектов

Ниже описано, как работают эти два варианта.

Удаление неподдерживаемых макросов

Неподдерживаемые макросы будут обработаны следующим образом:

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

Замена неподдерживаемых макросов плейсхолдерами

Выбор данного параметра приведет к сохранению неподдерживаемых макросов и помещению их контента в контейнеры <div> или <span>. Тег <div> используется для макроса с контентом, а <span> — для макроса без контента.

Вот HTML-пример того, как выглядит неподдерживаемый макрос без контента после импорта, если выбран параметр Замена неподдерживаемых макросов плейсхолдерами:

HTML
<span unknown-macro-name="status" unknown-macro-attribute="{&quot;colour&quot;:&quot;Green&quot;,&quot;title&quot;:&quot;Test&quot;}">
</span>

  • Атрибут unknown-macro-name содержит имя макроса.
  • Атрибут unknown-macro-attribute содержит настройки макроса, которые использовались в системе Confluence.

Разметка для макроса с контентом аналогична, за исключением обязательного использования тега <div> и контента макроса, помещенного в данный контейнер.

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

Особенности импорта макроса Excerpt

Макросы Цитата (Excerpt) импортируются в Документерру в виде Сниппетов. Однако существует два различных сценария обработки данных макросов:

  • Макрос Цитата составляет весь контент Страницы. Страница импортируется как одна страница и помещается в папку Сниппеты.
  • Макрос Цитата составляет часть контента Страницы.   Одна страница импортируется как две: контент Цитаты импортируется как отдельная страница, которая помещается в папку Сниппеты, а остальная часть контента импортируется как «основная» страница; страница, созданная из Цитаты, затем вставляется в «основную» страницу в виде сниппета.