Соберите данные вашей группы до того, как их придётся перемещать.

1. Решите, что пакет должен позволять вам делать.

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

BookStack проводит это различие явно: инструменты экспорта и импорта контента не предназначены для резервного копирования и восстановления. Читаемая копия в формате HTML или PDF полезна, но она не должна незаметно заменять набор для восстановления приложения. Экспорт и импорт контента в BookStack.

Для гипотетической группы мастерской начальная цель скромна: другой уполномоченный сопровождающий может прочитать руководство по эксплуатации и импортировать представительный раздел вместе с его схемами в отдельный тестовый экземпляр.

2. Запишите формат и пробелы.

Создайте матрицу, описывающую, что нужно сохранить и как вы это докажете. Не ставьте «готово» в ячейку, пока не проверите место назначения.

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

3. Дайте пакету понятную человеку отправную точку.

Добавьте короткий файл readme с исходным приложением и версией, датой и часовым поясом экспорта, выбранной областью, ролью экспортёра, списком файлов и ожидаемым местом назначения. Используйте описательные имена папок, например readable-content, attachments и import-package. Храните учётные данные отдельно; записывайте только утверждённую процедуру получения для уполномоченных сопровождающих.

Гипотетическое руководство содержит начальный контрольный список, страницу ухода за оборудованием, схему и одну связанную электронную таблицу. Его манифест фиксирует эти четыре элемента, их относительные пути и связь между страницей и её вложением. Также отметьте ограниченную страницу как намеренно исключённую, чтобы её отсутствие позже не было ошибочно принято за случайную потерю.

Контрольная сумма помогает выявить неизменённый файл при передаче. Она не доказывает, что экспорт был полным, с корректными разрешениями или читаемым.

4. Проверьте репрезентативную выборку.

Откройте читаемую копию, не полагаясь на активный сеанс в исходном приложении. Перейдите по ссылке, просмотрите встроенное изображение и откройте связанное вложение. Ищите ссылки, которые всё ещё ведут обратно к исходному сервису. Запишите, какие ссылки намеренно внешние, а какие сломаются после переноса.

Для календарей выберите образец, включающий повторяющееся событие, исключение и событие с соответствующим часовым поясом. Nextcloud описывает экспорт календаря и совместимый с iCalendar .ics импорт. Это устанавливает поддерживаемый путь обмена, а не доказательство того, что ваша цель сохраняет каждую выбранную функцию. Импорт и экспорт календаря Nextcloud.

Перед тем как следовать меткам интерфейса, проверьте документацию для установленной у вас версии; указанное в ссылке актуальное руководство может описывать другую версию.

5. Импортируйте в отдельное контролируемое место назначения.

Используйте пустое тестовое место назначения или явно одобренную тестовую коллекцию. Не трогайте рабочий сервис и его исходные данные. Перед запуском импортированного приложения отключите исходящие уведомления и ограничьте внешние соединения; цель — оценить данные, а не повторно рассылать исторические события участникам.

Пусть второй сопровождающий следует readme, не полагаясь на недокументированные инструкции экспортёра. Сравните ожидаемые элементы с импортированным результатом. Проверьте схему, ссылку на электронную таблицу, структуру страниц и предполагаемые разрешения участников. Запишите любое сопоставление ролей, требующее ручной работы. Если в формате отсутствует нужная функция, решите, воссоздать её, выбрать другой метод экспорта или сохранить читаемый архив рядом с новым сервисом.

6. Сделайте сбой информативным.

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

Для примера с мастерской приёмка означает, что второй сопровождающий может читать и редактировать выбранные страницы, получить каждый включённый файл и продемонстрировать, что обычный участник не может получить доступ к исключённому материалу. Запишите каждый результат и его проверяющего. «Импорт завершился» — это лишь одно наблюдение. Держите нерешённые расхождения перечисленными вместе с пакетом, чтобы группа могла принять по ним осознанное решение.

7. Держите экспорт и восстановление на разных дорожках.

Храните принятый пакет в контролируемом месте, независимом от исходного сервиса, и договоритесь, когда его обновлять. Проверяйте снова после изменений важных форматов, разрешений или версий приложений. Файлы экспорта могут содержать приватный контент, даже если место назначения лишь временное, поэтому назначьте им доступ и решение о сроке хранения.

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

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