Knihy

Aby bylo možné nabízet knihy zákazníkům, je nejprve nutné vytvořit formáty a nahrát je do Miguela. Pro vytvoření knihy stačí zadat titul a identifikátor (nebo kód produktu). Knihy se mohou vytvářet přes administraci anebo pomocí API.

Identifikátor knihy

Identifikátor se používá pro párování knihy s produktem na e-shopu nebo při komunikaci přes API. Takže je vhodné používat nějaký jednotný a srozumitelný systém. Můžete si jej nastavit na jakýkoliv text, číslo nebo třeba ISBN.

V našem nakladatelství používáme URL slug z titulu (pro knihu Čtyřhodinové tělo použijeme ctyrhodinove-telo, všechny znaky malé, bez diakritiky a místo mezer pomlčka).

• povolené znaky jsou a-z, A-Z, 0-9, -, _ a /; ostatní znaky (včetně diakritiky, mezer, ., @ a +) Miguel odmítne
• na velikosti písmen nezáleží, viz níže
• doporučujeme použít jednoduchý, univerzální a čitelný formát
• délka není omezená, ale doporučujeme délku do 50 znaků

Velikost písmen

Na velikosti písmen v identifikátoru nezáleží — ABC-1, abc-1 i Abc-1 jsou pro Miguela ten samý identifikátor. Když tedy váš e-shop pošle kód produktu s jinou velikostí písmen, než jakou máte zadanou v Miguelovi, kniha se i tak správně spáruje.

Miguel si přitom pamatuje přesně ten zápis, který jste zadali, a v administraci i v API ho vrací nezměněný.

Z toho také plyne, že v jednom účtu nemohou existovat dvě knihy, jejichž identifikátory se liší jen velikostí písmen — pokud už máte knihu abc-1, druhou s identifikátorem ABC-1 už vytvořit nelze. Změnit velikost písmen u identifikátoru existující knihy (např. abc-1 na ABC-1) ale možné je.

Nahrávání souborů

Aby se mohly nabízet knihy, je nutné je nejprve nahrát. Soubory se nahrávají na bezpečné centrální uložiště v Miguelovi. Miguel podporuje několik formátů pro e-knihy a audioknihy (viz Formáty). Je také možné nahrát několik různých formátů k jedné knize. Například EPUB a PDF, pokud chcete nabízet jak jednoduchou tak i graficky složitou variantu.

Při nahrávání se knihy validují. U některých formátů může validace trvat i několik minut, záleží na velikosti, komplexnosti knihy a také na aktuálním vytížení Miguela. Nejdéle trvá nahrávání EPUB (viz Formáty > EPUB > Validace).

Verzování

U každého souboru lze určit číslo verze, to umožňuje mít v Miguelovi víc verzí jedné knihy (při generování knihy se vždy použije soubor s nejvyšším číslem verze). Původně byla tato funkce zamýšlena pro uchovávání všech verzí knihy v čase, ale zjišťujeme, že se tato možnost nepoužívá a naopak způsobuje komplikace. Tuto funkci proto nejspíš v budoucnu odstraníme a při nahrání nové verze se předchozí po nějakém čase smaže.