В данной статье описывается, как Документерра обрабатывает макросы Confluence в процессе импорта.
Поддерживаемые макросы
Все поддерживаемые макросы Confluence будут автоматически преобразованы в соответствующие элементы системы Документерра или обработаны с сохранением их контента. Ниже приведен список поддерживаемых макросов:
|
Макрос Confluence
|
Элемент Документерры
|
Комментарий
|
|---|---|---|
|
Якорь (точка привязки гипертекстовой ссылки)
|
Якорь
|
|
|
Отображение дочерних страниц
|
Связанные статьи
|
|
|
Блок кода
|
Блок кода
|
|
|
Условный контент
|
Условный контент |
Часть функционала Версий разделов. Условные страницы с Вариантами импортируются как страницы с условными тегами, созданными из примененных к ним вариантов.
|
|
Decision
|
Экспресс-блоки
|
Импортируется как Информационный блок с другим цветом фона.
|
|
Error
|
Экспресс-блоки
|
Импортируется как Блок Ошибки.
|
|
Цитата (Excerpt и Excerpt Include)
|
Сниппеты контента
|
Об особенностях импорта фрагментов можно узнать ниже.
|
|
Развернуть
|
Выпадающий текст
|
|
|
Скрыть, если / Показать, если
|
Условный контент
|
Импортируется как Включающий/Исключающий блок, преобразующий группы пользователей в условные теги. |
|
Горизонтальная линия
|
Горизонтальная линия |
|
|
Информация
|
Экспресс-блоки
|
Импортируется как Информационный блок.
|
|
Примечание
|
Экспресс-блоки
|
Импортируется как Информационный блок.
|
|
Панель
|
—
|
Импортируется как HTML-элемент <p> с сохранением своих стилей, таких как размер шрифта, стили границ, цвет фона и т.д.
|
|
Успех
|
Экспресс-блоки
|
Импортируется как Успешный блок.
|
|
Совет
|
Экспресс-блоки
|
Импортируется как Информационный блок.
|
|
Дерево страниц
|
Оглавление статьи
|
Инлайн стили, такие как list-style-type,indent и т. д. не сохраняются. Макрос Зона Дерева страниц не поддерживается. |
|
Уведомление
|
Экспресс-блоки
|
Импортируется как Блок Предупреждения.
|
Неподдерживаемые макросы
На шаге 3 Мастера импорта из Confluence есть параметр Обработка неподдерживаемых макросов. Данная настройка позволяет выбрать способ обработки неподдерживаемых макросов: Удаление неподдерживаемых макросов или Замена неподдерживаемых макросов плейсхолдерами.
Ниже описано, как работают эти два варианта.
Удаление неподдерживаемых макросов
Неподдерживаемые макросы будут обработаны следующим образом:
- Если макрос не содержит контента, он будет удален.
- Если макрос содержит контент, будет импортирован только данный контент. Контейнер макроса будет удален.
| Параметр Удаление неподдерживаемых макросов является рекомендуемым способом обработки. |
Замена неподдерживаемых макросов плейсхолдерами
Выбор данного параметра приведет к сохранению неподдерживаемых макросов и помещению их контента в контейнеры <div> или <span>. Тег <div> используется для макроса с контентом, а <span> — для макроса без контента.
Вот HTML-пример того, как выглядит неподдерживаемый макрос без контента после импорта, если выбран параметр Замена неподдерживаемых макросов плейсхолдерами:
HTML |
|
- Атрибут unknown-macro-name содержит имя макроса.
- Атрибут unknown-macro-attribute содержит настройки макроса, которые использовались в системе Confluence.
Разметка для макроса с контентом аналогична, за исключением обязательного использования тега <div> и контента макроса, помещенного в данный контейнер.
После импорта вы всегда можете использовать функцию Глобального поиска и замены для выполнения очистки импортированных неподдерживаемых макросов.
Особенности импорта макроса Excerpt
Макросы Цитата (Excerpt) импортируются в Документерру в виде Сниппетов. Однако существует два различных сценария обработки данных макросов:
- Макрос Цитата составляет весь контент Страницы. Страница импортируется как одна страница и помещается в папку Сниппеты.
-
Макрос Цитата составляет часть контента Страницы. Одна страница импортируется как две: контент Цитаты импортируется как отдельная страница, которая помещается в папку Сниппеты, а остальная часть контента импортируется как «основная» страница; страница, созданная из Цитаты, затем вставляется в «основную» страницу в виде сниппета.