Конвертация статей
База знаний позволяет конвертировать статьи одного формата в другой. Всего в модуле доступно три сценария конвертации:
- Упрощенный редактор > Расширенный
- Упрощенный редактор > Блочный
- Блочный редактор > Расширенный
В статье рассмотрены возможности и нюансы конвертации.
Важно
Конвертация статей из одного формата в другой может привести к изменению исходного форматирования текста и верстки. Чем больше в статье разнообразных элементов (медиа, таблиц, табов, заметок, ссылок, цитат, кастомных HTML-тегов и т.п.) тем выше вероятность потери исходного форматирования.
Упрощенный редактор > Расширенный
Если в настройках модуля включена опция «Для каждой новой статьи включать упрощенный редактор, но можно конвертировать статью для использования расширенного редактора», то статьи, созданные в упрощенном редакторе можно конвертировать для работы в расширенном редакторе.
Для этого в правом верхнем углу статьи будет соответствующий переключатель.
Нюансы конвертации из упрощенного редактора в расширенный:
-
Конвертация обратима. Как только конвертированную статью сохранили, снова использовать в такой статье упрощенный редактор будет нельзя. НО:
-
Если статью конвертировали, но еще не сохранили, то ее можно закрыть без сохранения данных — изменения не будут применены и в статье останется упрощенный редактор.
-
Если у статьи есть сохраненная версия, где используется упрощенный редактор, то при восстановлении версии в статье снова будет использоваться данный редактор.
-
-
Расширенный редактор нельзя конвертировать в упрощенный. Если для наполнения статей изначально используется расширенный HTML-редактор, то использовать для таких статей упрощенный редактор уже нельзя.
-
Прикрепленные файлы не пропадают при конвертации. Упрощенный редактор позволяет прикреплять к статьям различные файлы: документы, таблицы, изображения и тому подобное. При этом в расширенном HTML-редакторе нет опции прикрепления файлов, поэтому при конвертации статьи, где уже есть прикрепленные файлы, визуально кажется что ранее добавленные файлы были удалены.
На самом деле файлы не исчезают из статьи при конвертации и будут видны в режиме просмотра.
Важно учитывать, что после конвертации в HTML-редактор из статьи невозможно напрямую удалить прикрепленные файлы. В этом случае стоит удалить данный файл с диска Битрикс24. Удаленный файл в статье будет выглядеть следующим образом:
Упрощенный редактор > Блочный
Статьи, созданные в упрощенном редакторе можно конвертировать для работы с блочным редактором. Для этого в настройках модуля есть мастер миграции. Доступ к этому интерфейсу есть только у администраторов портала.
Запустите мастер миграции и пройдите все его шаги. В результате все статьи, где ранее использовался упрощенный редактор, будут сконвертированы в формат блочного редактора.
Если в процессе конвертации возникли ошибки, это будет видно в таблице на финальном шаге мастера миграции. Если таблица пустая — конвертация прошла успешно.
Нюансы конвертации из упрощенного редактора в блочный:
-
Миграция только из упрощенного редактора. Если в Базе знаний есть статьи, для редактирования которых используется расширенный (HTML) редактор, то они не будут конвертированы через мастер миграции.
-
Конвертируются статьи и версии. При использовании мастера миграции в формат блочного редактора конвертируются не только сами статьи, но и все их версии. Соответственно, восстановить версию статьи в ее первоначальном редакторе будет нельзя.
-
Конвертация НЕобратима. Как только конвертированную статью сохранили, отменить действие и снова использовать в такой статье упрощенный редактор будет нельзя.
-
Блочный редактор нельзя конвертировать в упрощенный. Если для наполнения статей изначально используется BlockNote-редактор, то использовать для таких статей упрощенный редактор уже нельзя.
-
Файлы открепляются при конвертации. Упрощенный редактор позволяет прикреплять к статьям различные файлы: документы, таблицы, изображения и тому подобное. При этом из-за разницы в форматах при конвертации BB-code в Blocknote ранее добавленные в статью файлы исчезают. В тексте статьи остаются ID файлов на диске Б24.
Совет
Если в статьях вашей Базы знаний присутствует большое количество прикрепленных файлов, рекомендуется оставить эти статьи в формате упрощенного редактора, а блочный редактор использовать в уже новых статьях.
Блочный редактор > Расширенный
Если в настройках модуля включен блочный редактор, а также включена опция «Для каждой новой статьи включать упрощенный редактор, но можно конвертировать статью для использования расширенного редактора», то статьи, созданные в блочном редакторе можно конвертировать для работы в расширенном редакторе.
Для этого в правом верхнем углу статьи будет соответствующий переключатель.
Нюансы конвертации из блочного редактора в расширенный:
-
Конвертация обратима. Как только конвертированную статью сохранили, снова использовать в такой статье блочный редактор будет нельзя. НО:
-
Если статью конвертировали, но еще не сохранили, то ее можно закрыть без сохранения данных — изменения не будут применены и в статье останется блочный редактор.
-
Если у статьи есть сохраненная версия, где используется блочный редактор, то при восстановлении версии в статье снова будет использоваться данный редактор.
-
-
Расширенный редактор нельзя конвертировать в блочный. Если для наполнения статей изначально используется расширенный HTML-редактор, то использовать для таких статей блочный редактор уже нельзя. В том числе такие статьи нельзя конвертировать через мастер миграции.
-
Прикрепленные файлы не пропадают при конвертации. Блочный редактор позволяет прикреплять к статьям различные файлы: документы, таблицы, изображения и тому подобное. При конвертации в расширенный редактор файлы останутся в тексте статьи и будут по-прежнему доступны для скачивания.