Импорт макросов Confluence
В данной статье описывается, как Документерра обрабатывает макросы Confluence в процессе импорта.
Поддерживаемые макросы
Все поддерживаемые макросы Confluence будут автоматически преобразованы в соответствующие элементы системы Документерра или обработаны с сохранением их контента. Ниже приведен список поддерживаемых макросов:
| Макрос Confluence |
Элемент Документерры |
Комментарий |
|---|---|---|
| Якорь (точка привязки гипертекстовой ссылки) |
Якорь |
|
| Отображение дочерних страниц |
Связанные статьи |
|
| Блок кода |
Блок кода |
|
| Условный контент |
Условный контент | Часть функционала Версий разделов. Условные страницы с Вариантами импортируются как страницы с условными тегами, созданными из примененных к ним вариантов. |
| Decision |
Экспресс-блоки |
Inserted as Info Box template with the different background color. |
| Error |
Экспресс-блоки |
Inserted as Error Box template. |
| Цитата (Excerpt и Excerpt Include) |
Сниппеты контента |
Об особенностях импорта фрагментов можно узнать ниже. |
| Развернуть |
Выпадающий текст |
|
| Скрыть, если / Показать, если |
Условный контент |
Вставлено как Включающий/Исключающий блок, преобразующий группы пользователей в условные теги. |
| Горизонтальная линия |
Горизонтальная линия | |
| Информация |
Экспресс-блоки |
Inserted as Info Box template. |
| Примечание |
Экспресс-блоки |
Inserted as Info Box template. |
| Панель |
— |
Импортируется как HTML-элемент <p> с сохранением своих стилей, таких как размер шрифта, стили границ, цвет фона и т.д. |
| Success |
Экспресс-блоки |
Inserted as Success Box template. |
| Совет |
Экспресс-блоки |
Inserted as Info Box template. |
| Дерево страниц |
Оглавление статьи |
Инлайн стили, такие как list-style-type,indent и т. д. не сохраняются. Макрос Зона Дерева страниц не поддерживается. |
| Уведомление |
Экспресс-блоки |
Inserted as Warning Box template. |
Неподдерживаемые макросы
На шаге 3 Мастера импорта из Confluence есть параметр Обработка неподдерживаемых макросов. Данная настройка позволяет выбрать способ обработки неподдерживаемых макросов: Удаление неподдерживаемых макросов или Замена неподдерживаемых макросов плейсхолдерами.
Ниже описано, как работают эти два варианта.
Удаление неподдерживаемых макросов
Unsupported macros will be processed in the following way:
- Если макрос не содержит контента, он будет удален.
- Если макрос содержит контент, будет импортирован только данный контент. Контейнер макроса будет удален.
| Параметр Удаление неподдерживаемых макросов является рекомендуемым способом обработки. |
Замена неподдерживаемых макросов плейсхолдерами
Выбор данного параметра приведет к сохранению неподдерживаемых макросов и помещению их контента в контейнеры <div> или <span>. Тег <div> используется для макроса с контентом, а <span> — для макроса без контента.
Вот HTML-пример того, как выглядит неподдерживаемый макрос без контента после импорта, если выбран параметр Замена неподдерживаемых макросов плейсхолдерами:
HTML |
<span unknown-macro-name="status" unknown-macro-attribute="{"colour":"Green","title":"Test"}"> |
- Атрибут unknown-macro-name содержит имя макроса.
- Атрибут unknown-macro-attribute содержит настройки макроса, которые использовались в системе Confluence.
Разметка для макроса с контентом аналогична, за исключением обязательного использования тега <div> и контента макроса, помещенного в данный контейнер.
После импорта вы всегда можете использовать функцию Глобального поиска и замены для выполнения очистки импортированных неподдерживаемых макросов.
Особенности импорта макроса Excerpt
Макросы Цитата (Excerpt) импортируются в Документерру в виде Сниппетов. Однако существует два различных сценария обработки данных макросов:
- Макрос Цитата составляет весь контент Страницы. Страница импортируется как одна страница и помещается в папку Сниппеты.
- Макрос Цитата составляет часть контента Страницы. Одна страница импортируется как две: контент Цитаты импортируется как отдельная страница, которая помещается в папку Сниппеты, а остальная часть контента импортируется как «основная» страница; страница, созданная из Цитаты, затем вставляется в «основную» страницу в виде сниппета.