# Як упорядкувати бібліотеку для BOOKITCA

BOOKITCA не потребує спеціального формату чи конвертування. Застосунок читає звичайні файли книжок із теки бібліотеки у вашому сховищі. Цей посібник написано так, щоб за ним міг діяти і людина, і ШІ-агент.

## Куди класти книжки

- Типова бібліотека, яку застосунок створює під час першого запуску: iCloud Drive › BOOKITCA. Без iCloud: Файли › На моєму iPhone › BOOKITCA (на iPad: На моєму iPad).
- Dropbox: тека Apps/Bookitca. Вона зʼявляється, коли ви підʼєднуєте Dropbox у застосунку.
- Інші сховища: точне місце застосунок показує в Налаштуваннях › Сховище бібліотеки › назва сховища › Папка.
- Audiobookshelf: застосунок бере книжки з бібліотек на вашому сервері так, як ними керує Audiobookshelf. Упорядковуйте їх там; правила нижче стосуються тек в інших сховищах.
- Кілька сервісів одночасно: у кожного своя тека бібліотеки. Та сама книжка у двох сервісах зʼявиться в застосунку двічі.
- Вкладені теки підходять, наприклад за автором чи жанром. Застосунок читає всю теку бібліотеки.

## Формати

- Е-книги: EPUB, PDF і файли Kindle без DRM (MOBI, AZW3, AZW, PRC).
- Старіші формати з давно зібраних архівів: FB2, PDB (PalmDOC), RTF і TXT. Застосунок читає їх після конвертування й не чіпає оригінал. TXT менше 20 кБ і нотатки на кшталт readme.txt книжками не вважаються.
- Аудіокниги: M4B, M4A, MP3 або ZIP з MP3, як їх пропонують для завантаження крамниці. Не розпаковуйте його, BOOKITCA відтворює його як є.
- DRM: книжки з класичним DRM (Adobe, Kindle, власний застосунок крамниці) відкрити неможливо. Соціальний DRM (водяний знак) підходить.
- Інші файли, приховані файли (починаються з крапки) і незавершені завантаження (.download) ігноруються.

## Правила

1. Е-книга є одним файлом. Вона може лежати будь-де в теці бібліотеки.
2. Та сама е-книга в кількох форматах поруч (Knyha.epub і Knyha.mobi) рахується один раз. Перемагає EPUB, далі AZW3, MOBI, AZW, PRC, PDB, FB2, RTF і нарешті TXT. Тека Calibre (з metadata.opf) є однією книжкою навіть із кількома форматами всередині й отримує cover.jpg як обкладинку.
3. Аудіокнига з кількох файлів є однією текою. Кожен файл є розділом, у природному порядку назв (01, 2, 10, як у Finder).
4. Кожна тека з аудіофайлами є окремою книжкою. Аудіокнига, розділена на вкладені теки CD1 і CD2, стала б двома книжками: покладіть усі доріжки в одну теку й назвіть їх так, щоб вони йшли по порядку (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Аудіокнига з одного файлу (M4B або MP3) кладеться просто в корінь бібліотеки або сама у власну теку. Два такі файли в одній теці були б однією книжкою з двома розділами. Аудіокнига в ZIP може лежати будь-де.
6. Назва й автор беруться з метаданих самого файлу (EPUB, MOBI, FB2, PDF, а також теги M4B, M4A і MP3). Назва файлу лише запасний варіант.
7. Обкладинка: якщо у файлі її немає, використовується зображення поруч із книжкою.
   - Е-книга або аудіокнига з одного файлу: зображення з такою самою назвою (Knyha.epub і Knyha.jpg).
   - Тека аудіокниги: cover.jpg, folder.jpg або front.jpg (PNG теж підходить). Інакше зображення з назвою теки, інакше найбільше зображення в теці.
8. Супровідні файли в теці аудіокниги (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) читаються заради відомостей про книжку.
9. Тека .bookitca належить застосунку (позиції читання, колекції, статистика). Не видаляйте її і нічого в неї не записуйте.
10. Перейменовувати чи переміщувати книжку всередині бібліотеки можна. Застосунок упізнає її за вмістом і зберігає позицію читання (якщо сам файл не змінився). Але дві копії тієї самої книжки в бібліотеці зʼявляться двічі: всередині бібліотеки переміщуйте, а не копіюйте.

## Приклад

```
Bookitca/
  Karel Čapek, Vijna z sakhalamandramy.epub
  Karel Čapek, Vijna z sakhalamandramy.jpg
  Hraf Monte-Kristo.m4b
  Saturnin.zip
  Stari cheski lehendy/
    cover.jpg
    01 Praotets Chekh.mp3
    02 Pro Kroka.mp3
  Detektyvy/
    Vbyvstvo v Skhidnomu ekspresi.epub
```

## Завантаження багатьох книжок одразу

Скопіюйте книжки з компʼютера в теку бібліотеки, хоч сотні одразу. Сховище їх вивантажить, а BOOKITCA додасть їх під час наступної синхронізації. Великі аудіокниги не завантажуються повністю, вони грають просто зі сховища.

## Інструкції для ШІ-агентів

- Завантажуйте з крамниці лише те, що сама крамниця дозволяє завантажити як файл. Не обходьте DRM і не входьте від імені користувача без його згоди.
- Нічого не конвертуйте й не розпаковуйте. Зберігайте оригінальні файли.
- Не видаляйте й не перезаписуйте файли, що вже є в теці бібліотеки. Не чіпайте теку .bookitca.
- Дотримуйтеся правил від 3 до 5: одна аудіокнига з кількох файлів = одна тека.
- Якщо бракує обкладинки, а у вас вона є, збережіть її поруч із книжкою за правилом 7.
- Порядок дій: спершу інвентаризація, потім пропозиція і згода користувача, лише після цього будь-які переміщення. Наостанок перевірте, що все на місці (розміри або контрольні суми, де можливо), і звітуйте, зокрема про те, що не вдалося.
- Не вгадуйте в неоднозначних випадках, пропустіть їх і повідомте. Дублікати лише повідомляйте, не видаляйте.
- Не вдавайте, що операції відбулися або що відтворення перевірено в застосунку.
- Готовий промпт ШІ-бібліотекаря, що охоплює все це (англійською): https://www.bookitca.app/assets/guides/bookitca-ai-librarian-en.md
