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

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 для импорта.