Перейти к основному контенту

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

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 вашего экземпляра:

import-overview.png

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

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

Наверх