# Jak uspořádat knihovnu pro BOOKITCU

BOOKITCA nepotřebuje žádný zvláštní formát ani převod. Čte obyčejné soubory knih ze složky knihovny ve tvém úložišti. Tenhle návod je psaný tak, aby podle něj mohl knihovnu srovnat člověk i AI agent.

## Kam knihy patří

- Výchozí knihovna, kterou aplikace založí při prvním spuštění: iCloud Drive › BOOKITCA. Bez iCloudu Soubory › Na mém iPhonu › BOOKITCA (na iPadu Na mém iPadu).
- Dropbox: složka Aplikace/Bookitca (v anglickém Dropboxu Apps/Bookitca). Vznikne po připojení Dropboxu v aplikaci.
- Ostatní úložiště: přesné místo ukazuje aplikace v Nastavení › Úložiště knihovny › název úložiště › Složka.
- Audiobookshelf: knihy bere aplikace z knihoven na serveru tak, jak je spravuje Audiobookshelf. Pořádek se dělá tam, pravidla níže platí pro složky v ostatních úložištích.
- Víc úložišť najednou: každé má vlastní složku knihovny. Stejná kniha ve dvou úložištích bude v aplikaci dvakrát.
- Podsložky jsou v pořádku, třeba podle autorů nebo žánrů. Aplikace prochází celou složku knihovny.

## Formáty

- E-knihy: EPUB, PDF a soubory pro Kindle bez DRM (MOBI, AZW3, AZW, PRC).
- Starší formáty z letitých archivů: FB2, PDB (PalmDOC), RTF a TXT. Aplikace je čte převedené, originál nemění. TXT menší než 20 kB a poznámky jako readme.txt se za knihu nepovažují.
- Audioknihy: M4B, M4A, MP3, nebo ZIP s MP3 tak, jak ho dávají obchody ke stažení. ZIP nerozbaluj, BOOKITCA ho přehraje rovnou.
- DRM: knihy zamčené klasickým DRM (Adobe, Kindle, aplikace obchodu) otevřít nejde. Sociální DRM (vodoznak) nevadí.
- Ostatní soubory, skryté soubory (začínají tečkou) a nedokončená stahování (.download) se ignorují.

## Pravidla

1. E-kniha je jeden soubor. Může ležet kdekoli ve složce knihovny.
2. Stejná e-kniha ve víc formátech vedle sebe (Kniha.epub a Kniha.mobi) se počítá jednou. Přednost má EPUB, pak AZW3, MOBI, AZW, PRC, PDB, FB2, RTF a nakonec TXT. Složka z Calibre (s metadata.opf) je jedna kniha, i když v ní leží víc formátů, a dostane obálku cover.jpg.
3. Audiokniha z víc souborů je jedna složka. Každý soubor je kapitola, pořadí je přirozené podle názvu (01, 2, 10, jako ve Finderu).
4. Každá složka se zvukovými soubory je samostatná kniha. Audiokniha rozdělená na CD1 a CD2 v podsložkách by byla dvě knihy: dej všechny stopy do jedné složky a pojmenuj je tak, aby šly po sobě (CD1 01.mp3, CD1 02.mp3, CD2 01.mp3).
5. Audiokniha v jednom souboru (M4B nebo MP3) patří přímo do kořene knihovny, nebo sama do vlastní složky. Dva takové soubory v jedné složce by byly jedna kniha o dvou kapitolách. ZIP s audioknihou může ležet kdekoli.
6. Název a autor se berou z údajů v souboru (EPUB, MOBI, FB2, PDF a štítky M4B, M4A a MP3). Název souboru je jen záloha, když údaje chybí.
7. Obálka: když ji soubor nemá vloženou, použije se obrázek vedle knihy.
   - E-kniha nebo audiokniha v jednom souboru: obrázek se stejným názvem (Kniha.epub a Kniha.jpg).
   - Audiokniha ve složce: cover.jpg, folder.jpg nebo front.jpg (i PNG). Jinak obrázek pojmenovaný jako složka, jinak největší obrázek ve složce.
8. Doprovodné soubory k audioknize ve stejné složce (bookinfo.html, .opf, .nfo, .cue, .m3u, .pls) aplikace přečte a doplní z nich údaje o knize.
9. Složka .bookitca patří aplikaci (pozice čtení, sbírky, statistiky). Nemaž ji a nic do ní nepiš.
10. Přejmenovat nebo přesunout knihu uvnitř knihovny jde. Aplikace ji pozná podle obsahu a pozice čtení zůstane (u souborů beze změny obsahu). Kopie téže knihy na dvou místech knihovny se ale ukáže dvakrát: uvnitř knihovny přesouvej, nekopíruj.

## Příklad

```
Bookitca/
  Karel Čapek, Válka s mloky.epub
  Karel Čapek, Válka s mloky.jpg
  Hrabě Monte Cristo.m4b
  Saturnin.zip
  Staré pověsti české/
    cover.jpg
    01 Praotec Čech.mp3
    02 O Krokovi.mp3
  Detektivky/
    Vražda v Orient expresu.epub
```

## Hromadné nahrání

Zkopíruj knihy z počítače do složky knihovny, klidně stovky naráz. Úložiště je nahraje a BOOKITCA je při další synchronizaci přidá do knihovny. Velké audioknihy se nestahují celé, hrají rovnou z úložiště.

## Pokyny pro AI agenta

- Stahuj z obchodu jen to, co obchod sám dovoluje stáhnout jako soubor. Neobcházej DRM a nepřihlašuj se za uživatele bez jeho souhlasu.
- Nic nepřeváděj a nerozbaluj. Zachovej původní soubory.
- Nemaž a nepřepisuj soubory, které už ve složce knihovny jsou. Do složky .bookitca nesahej.
- Drž se pravidel 3 až 5: jedna audiokniha z víc souborů = jedna složka.
- Když chybí obálka a máš ji k dispozici, ulož ji vedle knihy podle pravidla 7.
- Postup: nejdřív inventura, pak návrh změn a souhlas uživatele, teprve potom přesuny. Po nich zkontroluj, že je vše na místě (kde to jde, i velikosti nebo kontrolní součty), a podej zprávu včetně toho, co se nepovedlo.
- Nejednoznačný případ nehádej, přeskoč ho a nahlas. Duplicity jen nahlas, nemaž je.
- Nepředstírej provedené operace ani ověřené přehrávání v aplikaci.
- Hotový prompt pro AI knihovníka, který tohle všechno obsahuje: https://www.bookitca.app/assets/guides/bookitca-ai-knihovnik-cs.md
