Спакуйте дані своєї групи, перш ніж їх доведеться переміщати.

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 до резервного копіювання та відновлення.

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