Standard EPUB 2.0.1 definiuje sekcję guide w taki sposób: http://www.idpf.org/epub/20/spec/OPF_2. ... Section2.6
Poniżej fragment z najczęściej potrzebnymi definicjami:
 | | |
| Kod: <guide> <reference type="toc" title="Spis treści" href="toc.html" /> <reference type="cover" title="Okładka" href="cover.html" /> <reference type="text" title="Text" href="chapter1.html" /> </guide> | |
| | |
Dla poprawnej konwersji z EPUB do mobi tak naprawdę krytycznie ważny jest jeden element toc, czyli spis treści w formacie HTML. Jest on potrzebny czytnikowi Kindle Classic do pokazania czytelnikowi spisu treści.
| | |
| Kod: <reference type="toc" title="Spis treści" href="toc.html" /> | |
| | |
Drugim mniej ważnym dla kindlegena, a krytycznie ważnym elementem dla pliku EPUB jest definicja okładki HTML (type="cover"). Wskazuje ona na plik HTML z okładką książki. W celu uniknięcia różnych problemów bardzo ważne jest, żeby ten plik występował jako pierwszy w kolejności w sekcji <spine>, a także, żeby nie miał ustawionej opcji linear="no" .
Uwaga! Okładka dla kindlegena musi być ustawiona w sekcji metadata w postaci znacznika <meta name="cover" content=""/>. Żeby uniknąć problemu podwójnych okładek kindlegen rozpoznaje, czy w okładce HTML jest zdefiniowany ten sam obrazek, co w sekcji meta, jeśli tak będzie to podwójnych okładek nie będzie. Kindlegen usunie okładkę html automatycznie. Jeśli inny obrazek będzie ustawiony w sekcji meta, a inny w okładce html w pliku wynikowym będzie widać podwójne okładki. Pierwsza to oczywiście ta z sekcji meta, druga to ta z okładki html, której kindlegen nie usunie.
Trzeci istotny element w sekcji guide, którego używa kindlegen to type="text" wskazuje on na plik, który jest pierwszym plikiem z właściwym tekstem książki. Z reguły będzie to plik z pierwszym rozdziałem na przykład.
Uwaga! w sekcji guide każdy ze z atrybutów type może pojawić się tylko raz, np. taki zapis jest niedozwolony:
| | |
| Kod: <guide> <reference type="text" title="Text" href="toc.html" /> <reference type="text" title="Text" href="chapter1.html" /> </guide> | |
| | |
Również dany plik wskazany w atrybucie href może występować tylko raz, np. taki zapis jest niedozwolony:
| | |
| Kod: <guide> <reference type="toc" title="Spis treści" href="TOC.HTML" /> <reference type="cover" title="Okładka" href="TOC.HTML" /> </guide> | |
| | |
Czyli, jeśli jakiś plik oznaczymy, że jest to wprowadzenie (foreword), to już nie możemy tego pliku oznaczyć jako text.
Wielkość liter ma krytyczne znaczenie. Wolno wskazać type="toc" (tak przewiduje cytowany wyżej standard), ale nie wolno type="TOC"
PS. epubQTools jeszcze nie kontroluje wszystkich wyżej wymienionych elementów. W wolnej chwili postaram się zaimplementować odpowiednią kontrolę i ewentualnie korektę.