Konwertuj OPF na EPUB

Workflow publikowania, archiwum lub aplikacja do czytania może udostępniać pakiet OPF, podczas gdy docelowy czytnik lub usługa dystrybucyjna wymaga jednego pliku .epub. Konwersja pakuje OPF, XHTML, arkusze stylów, obrazy, czcionki i zasoby nawigacyjne do kontenera EPUB.

Czym jest format OPF

OPF, zwykle oznaczany rozszerzeniem .opf, to dokument pakietu XML używany przez systemy produkcji EPUB. Definiuje metadane, manifest zasobów i kolejność czytania za pomocą elementów takich jak <metadata>, <manifest> i <spine>.

Plik OPF zwykle nie jest kompletnym e-bookiem. Odwołuje się do rozdziałów XHTML lub HTML, CSS, obrazów, czcionek, plików okładki i dokumentów nawigacyjnych za pomocą ścieżek względnych. Te pliki muszą pozostać w lokalizacjach zadeklarowanych w manifeście. Pliki OPF są używane przez wydawców, aplikacje do tworzenia e-booków, projekty Calibre, biblioteki cyfrowe i rozpakowane pakiety EPUB; zwykle nie otwiera się ich bezpośrednio w oprogramowaniu do czytania.

Czym jest format EPUB

EPUB to oparty na ZIP kontener e-booka, który pakuje dokument OPF wraz z zasobami, do których dokument ten się odwołuje. EPUB musi zawierać znajdujący się w katalogu głównym plik mimetype z zawartością application/epub+zip, plik META-INF/container.xml wskazujący dokument pakietu oraz pliki treści wymienione w tym pakiecie.

EPUB 2 zazwyczaj używa pakietu OPF i spisu treści NCX. EPUB 3 wykorzystuje pakiet OPF wraz z dokumentem nawigacyjnym XHTML i może obsługiwać takie funkcje jak semantyczny HTML, MathML, nakładki multimedialne, dźwięk, wideo, skrypty i układy o stałych wymiarach, zależnie od obsługi przez czytnik.

Układ EPUB z możliwością ponownego przepływu dopasowuje tekst do różnych rozmiarów ekranów, a jeden plik może zawierać metadane, nawigację, arkusze stylów, obrazy i czcionki. Apple Books, Kobo, Thorium Reader, Adobe Digital Editions, wiele aplikacji do czytania na Androidzie oraz usługi dystrybucji e-booków obsługują EPUB, chociaż obsługa poszczególnych funkcji jest różna.

Konwersja kompletnego projektu OPF za pomocą Calibre

1. Umieść plik OPF oraz każdy powiązany plik XHTML lub HTML, arkusz stylów, obraz, czcionkę, okładkę i dokument nawigacyjny w strukturze katalogów określonej w manifeście. Zachowaj ścieżki względne i wielkość liter w nazwach plików.
2. Zainstaluj aktualne wydanie desktopowe Calibre ze strony calibre-ebook.com.
3. Uruchom konwerter wiersza poleceń z katalogu projektu:
   ebook-convert book.opf book.epub
4. Możesz również wypróbować workflow graficzny: użyj Calibre → Add books, wybierz źródło, wybierz Convert books, wybierz EPUB jako format wyjściowy i rozpocznij konwersję. Jeśli importer graficzny nie zaakceptuje OPF, użyj ebook-convert.
5. Otwórz wynik w docelowej aplikacji do czytania i sprawdź kolejność rozdziałów, spis treści, obrazy, łącza, czcionki, okładkę i metadane.

Calibre może rozpoznać manifest OPF, ponownie utworzyć kontener EPUB, ujednolicić metadane oraz przepisać niezgodny HTML lub CSS. Może zmienić znaczniki źródłowe i style, dlatego zachowaj oryginalny projekt, gdy ważne jest dokładne renderowanie lub zachowanie źródła. Adobe Digital Editions to czytnik, a nie uniwersalny konwerter OPF-do-EPUB.

Ponowne utworzenie rozpakowanego EPUB

Jeśli OPF pochodzi z rozpakowanego EPUB, a wszystkie pliki pakietu są nadal dostępne, konwersja za pomocą Calibre nie jest konieczna. Utwórz ponownie ZIP EPUB z oryginalną strukturą katalogów. Katalog główny pakietu musi zawierać mimetype, META-INF/container.xml, dokument pakietu wskazany przez container.xml oraz wszystkie zasoby manifestu.

Z katalogu głównego pakietu utwórz archiwum, umieszczając wpis mimetype jako pierwszy i bez kompresji:

zip -X0 ../book.epub mimetype
zip -rX9 ../book.epub META-INF OEBPS

Zastąp OEBPS rzeczywistym katalogiem zawartości i dołącz każdy katalog wskazany przez container.xml oraz manifest OPF. Plik mimetype musi zawierać dokładnie application/epub+zip, bez dodatkowych białych znaków, i musi być pierwszym wpisem ZIP. Użyj narzędzia do pakowania obsługującego EPUB, jeśli narzędzie archiwizujące systemu operacyjnego nie potrafi zachować tych wymagań.

Walidacja EPUB

Uruchom oficjalne narzędzie EPUBCheck dla utworzonego pliku:

epubcheck book.epub

EPUBCheck wykrywa nieprawidłowe metadane pakietu, uszkodzone odwołania w manifeście lub spine, nieprawidłową nawigację, błędne deklaracje MIME oraz błędy struktury kontenera. Nie może przywrócić brakujących plików ani naprawić niepoprawnego HTML, CSS, typografii lub układu wizualnego.

Konwertery online i ograniczenia zgodności

Większość internetowych konwerterów e-booków obsługuje pojedynczy dokument, a nie projekt OPF z powiązanym drzewem katalogów. Przesłanie wyłącznie pliku .opf może doprowadzić do utworzenia niekompletnego EPUB lub pominięcia zasobów bez wyraźnego wskazania błędu. W przypadku nieopublikowanych manuskryptów lub treści objętych licencją lokalne przetwarzanie za pomocą Calibre pozwala uniknąć wysyłania źródła do podmiotu trzeciego.

Renomowane usługi, takie jak CloudConvert i Zamzar, można brać pod uwagę tylko wtedy, gdy ich aktualna lista formatów wyraźnie obejmuje dostarczony OPF lub kompletny pakiet archiwum i wyjaśnia sposób rozwiązywania odwołań do zewnętrznych zasobów. Są bardziej odpowiednie dla spakowanego e-booka lub prostej konwersji pojedynczego pliku niż dla wieloplikowego projektu OPF. Każdy wynik online sprawdź za pomocą EPUBCheck i przetestuj w docelowym czytniku.

• OPF nie może dostarczyć rozdziałów, obrazów, CSS, czcionek ani plików nawigacyjnych, których brakuje w odwołaniach jego manifestu.
• Ścieżki wewnątrz pakietów EPUB są w praktyce uwrażliwione na wielkość liter. Odwołanie do Images/Cover.jpg nie zapewnia poprawnego rozpoznania images/cover.jpg.
• Calibre może zmienić CSS, HTML, metadane, nawigację i sposób obsługi obrazów podczas konwersji; porównaj wynik ze źródłem.
• Osadzone czcionki wymagają prawidłowych typów MIME i odpowiednich licencji na czcionki. Niektóre czytniki je ignorują lub ograniczają możliwość ich użycia.
• JavaScript, układy o stałych wymiarach, MathML, nakładki multimedialne, dźwięk, wideo i inne funkcje EPUB 3 są obsługiwane w różnym zakresie. Przetestuj je w konkretnej aplikacji, na urządzeniu lub w walidatorze dystrybucyjnym.