Экспорт и импорт контента

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

Экспорт

Если у вас есть необходимое разрешение роли «Экспорт контента», вы можете экспортировать книги, главы или страницы в следующих форматах:

• Контейнерный веб-файл
  Файл .html, в который, где возможно, встроены изображения. Такой файл можно открыть в веб-браузере.
  Этот формат обычно обеспечивает наилучшее представление контента BookStack.

• PDF-файл
  Документ в формате .pdf, представляющий ваш контент.
  Выходной файл иногда может быть неточным или лишённым некоторых функций по сравнению с оригинальным представлением в BookStack.

• Простой текстовый файл
  Файл .txt, содержащий только текст вашего контента.

• Файл Markdown
  Файл .md, представляющий ваш контент в формате Markdown.
  Если страница была написана с использованием редактора Markdown, то будет представлен исходный контент. В противном случае система попытается преобразовать контент в Markdown. Получившийся Markdown может всё ещё содержать HTML для некоторых типов контента.

• Портативный ZIP
  Сжатый файл .zip, содержащий данные, файлы вложений и изображения.
  Этот архив можно повторно импортировать в другие экземпляры BookStack, как упомянуто ниже.
  Подробное описание формата можно найти в исходниках BookStack.

Кроме перечисленных форматов, в BookStack уделено внимание правильному отображению страниц при печати через браузер. Это позволяет печатать страницы на бумаге или, зачастую, экспортировать в PDF с помощью функции печати браузера.

Для разработчиков многие из этих вариантов экспорта также доступны через REST API BookStack, который предоставляет дополнительные конечные точки, полезные для задач, связанных с экспортом.

Импорт

Если у вас есть соответствующее разрешение роли «Импорт контента», вы можете импортировать архивы в формате «Portable ZIP» (упоминаемые в разделе экспорта) через действие «Импорт», доступное при просмотре верхнего уровня вида «Книги» или по пути /import вашего экземпляра:

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

Для разработчиков подробности формата ZIP-файла для импорта можно найти здесь, либо рассмотреть использование REST API BookStack для импорта.