EPUB

Podporovány jsou verze 2.0 i 3.0. A to ve flow i fixed variantě.

Fixed variantu nedoporučujeme, nemáme s tím dobrou zkušenost. Mnohem lepší je nahrát flow EPUB a PDF.

Výstupní formáty

Miguel umí z EPUB vytvořit MOBI a PDF. V případě nastavené šablony pro sociální DRM se tato stránka vloží i do převedených formátů.

V případě používání objednávkového režimu (viz Používání > API) nebo napojení na Shoptet se automaticky z EPUB vytváří MOBI i PDF, pokud vám toto chování nevyhovuje a chcete jej vypnout, je prozatím nutné kontaktovat podporu na miguel@servantes.cz.

Validace

Při nahrání EPUB formátu do Miguela se celý soubor validuje pomocí oficiálního nástroje EPUBCheck a testuje se generování do všech možných formátů, tento proces může zabrat i několik minut, ale zajišťuje, že bude vše fungovat jak má.

EPUBCheck je celý anglicky, takže vám to při nějaké chybě zobrazí anglické texty. Pro někoho to může být problematické (můžete nás kontaktovat na miguel@servantes.cz a pomůžeme vám to rozluštit).

Chyba může vypadat např. takto:

ERROR(RSC-005): ebook_sazba-2.epub/OEBPS/toc.xhtml(9,10):
  Error while parsing file: element "ol" incomplete; missing required element "li"

Když si projdeme celý řádek z leva, jsou tam tyto části:

• ERROR - úroveň chyby (může tam také být INFO nebo WARN, to jsou jenom informativní, validace i přesto projde).
• RSC-005 - chybový kód
• ebook_sazba-2.epub - název EPUB souboru
• OEBPS/toc.xhtml - cesta k souboru v EPUBu, kde se chyba nachází
• (9,10) - pozice v souboru, kde se chyba nachází (číslo řádku, pozice na řádku). V tomto případě je chyba na 9. řádku a pozici 10 na řádku
• zbytek je chybová hláška

Pro editaci souboru a případné opravení chyby v EPUB souboru doporučujeme editor Sigil.

Časté chyby

Nejčastější chyby jsou špatné odkazy v knize, chybějící soubor nebo chybějící obsah (pozor na to, že EPUB má svůj interní strukturovaný obsah).

Chybějící obsah

Takto např. vypadá chyba, když chybí obsah v knize (ten interní strukturovaný obsah v EPUB):

ERROR(RSC-005): název_souboru.epub/OEBPS/toc.xhtml(9,9):
  Error while parsing file: element "ol" incomplete; missing required element "li"

Špatný odkaz v knize

Tady je příklad toho, když je v knize odkaz na jiné místo v knize (třeba do jiné kapitoly) a ten soubor neexistuje:

ERROR(RSC-007): název_souboru.epub/OEBPS/text/kapitola_01.xhtml(15,84):
  Referenced resource "OEBPS/text/neexistujici_soubor.xhtml" could not be found in the EPUB.

• text/kapitola_01.xhtml - soubor ve kterém je špatný odkaz
• (15,84) - 15. řádek, pozice 84 (84. znak od začátku řádku)
• text/neexistujici_soubor.xhtml - soubor, na který se odkazuje a který chybí

Chybějící soubor

Příklad toho, jak vypadá chybová hláška, když chybí soubor images/obrazek.jpg:

ERROR(RSC-001): název_souboru.epub(-1,-1):
  File "OEBPS/images/obrazek.jpg" could not be found.

Zakázaný value atribut

Příklad toho když máte v <li> elementu v HTML souboru atribut value:

ERROR(RSC-005): název_souboru.epub/index_split.htm|(11,54):
  Error while parsing file: attribute "value" not allowed here; expected attribute "class", "dir", "lang", "style", "title" or "xml:lang"

Z nějakého důvodu je tento atribut zakázaný a musíte jej odstranit.

Sociální DRM

Miguel umí vložit novou sociální DRM stránku do EPUB nebo upravit existující. Pro správné fungování je nutné nastavit šablonu a nebo vložit soubor se speciálním názvem do EPUB. Šablona je popsána v nastavení.

Ruční vkládání

Pokud chcete mít jinou šablonu pro každou knihu, je možné v EPUBu vytvořit soubor se jmény social_drm, social-drm, nebo socialdrm (přípona v tomhle případě není podstatná).

Automatické vkládání

Pro automatické vkládání je nutné nastavit šablonu v administraci (viz Nastavení Miguela > DRM šablona).

Miguel se snaží vložit stránku na vhodné místo na začátku knihy, místo vyhledává podle následujících priorit:

1. za tiráž
2. za obálku
3. za obsah
4. před hlavní text

Rozhoduje se podle EPUB landmarks, takže je vhodné tyto značky v EPUB nastavit aby se stránka vložila na co nejlepší místo.