Darmowy konwerter online ASCIIDOC do EPUB

Czytniki e-booków i systemy publikowania zwykle wymagają formatu EPUB zamiast pliku źródłowego AsciiDoc. Konwersja zachowuje nagłówki, akapity, listy, odnośniki, obrazy i inne uporządkowane treści w formacie z płynnym układem, który można otwierać na telefonach, tabletach i dedykowanych urządzeniach do czytania e-booków.

Czym jest format ASCIIDOC

AsciiDoc to tekstowy format znaczników przeznaczony do tworzenia uporządkowanych dokumentów, takich jak książki, podręczniki, dokumentacja oprogramowania, artykuły i pliki README. Autorzy zapisują nagłówki, listy, tabele, odnośniki, bloki kodu, atrybuty, odsyłacze wzajemne i admonitions za pomocą czytelnej składni tekstowej, zamiast edytować dokument binarny.

Typowe rozszerzenia plików źródłowych to .adoc, .asciidoc i .asc. Asciidoctor i Asciidoc używają tych plików do generowania dokumentów HTML, PDF, man pages i EPUB. Deweloperzy zwykle spotykają je w repozytoriach dokumentacji, projektach static-site, projektach opartych na Git oraz systemach kompilowania dokumentacji.

Czym jest format EPUB

EPUB to pakiet e-booka oparty na ZIP, zawierający treści XHTML, arkusze stylów CSS, metadane, pliki nawigacyjne oraz opcjonalne obrazy, fonty i inne zasoby. EPUB 3 obsługuje semantyczny HTML, układy responsywne, nawigację, dźwięk lub wideo oraz tekst pisany od prawej do lewej lub pionowo, jeśli system odczytu obsługuje te funkcje.

W przeciwieństwie do dokumentu PDF ze stałym układem stron treść EPUB dopasowuje się do rozmiaru ekranu, ustawień fontu i orientacji urządzenia do czytania. Format ten nadaje się do rozpowszechniania obszernej dokumentacji lub książek za pośrednictwem czytników e-booków i bibliotek, a także do sprawdzania wyniku w aplikacjach zgodnych z EPUB.

Jak przekonwertować ASCIIDOC do EPUB

Użyj Asciidoctor EPUB3

Asciidoctor EPUB3 to najbardziej bezpośredni wybór, ponieważ rozumie konstrukcje charakterystyczne dla AsciiDoc, zamiast traktować źródło jako ogólny język znaczników. Najpierw zainstaluj Ruby, jeśli nie jest jeszcze dostępny, a następnie zainstaluj konwerter:

gem install asciidoctor-epub3

Uruchom następujące polecenie z katalogu zawierającego plik źródłowy:

asciidoctor-epub3 book.adoc -o book.epub

Zastąp book.adoc rzeczywistą nazwą pliku. Konwerter odczytuje nagłówek dokumentu, dołączone pliki, wskazane obrazy, atrybuty i elementy strukturalne, a następnie zapisuje plik book.epub.

W przypadku projektu składającego się z wielu plików przechowuj dołączone źródła i katalogi obrazów w oczekiwanych lokalizacjach względnych. Typowe polecenie z niestandardowym katalogiem roboczym wygląda następująco:

asciidoctor-epub3 -D output book.adoc

Ustaw metadane dokumentu w nagłówku AsciiDoc przed konwersją, na przykład:

= Book title
Author Name <author@example.com>
:revnumber: 1.0
:description: A short description
:doctype: book
:toc:
:sectnums:

Użyj atrybutu obrazu, takiego jak :imagesdir: images, gdy ścieżki obrazów są względne względem wspólnego katalogu. Sprawdź, czy każdy wskazany obraz istnieje i jest zapisany w formacie obsługiwanym przez docelowe systemy odczytu, zazwyczaj JPEG, PNG lub SVG.

Konwersja bez instalowania oprogramowania

Możesz bezpłatnie przekonwertować plik w witrynie 101convert.com, jeśli instalowanie Ruby lub Asciidoctor jest niepraktyczne. Prześlij plik AsciiDoc, wybierz EPUB jako format wyjściowy, rozpocznij konwersję i pobierz wygenerowany e-book.

Użyj Pandoc jako alternatywy

Pandoc może bezpośrednio konwertować niektóre dokumenty AsciiDoc:

pandoc book.adoc -o book.epub

Użyj Pandoc w przypadku stosunkowo prostych dokumentów lub gdy jest już częścią procesu publikowania. Asciidoctor EPUB3 zazwyczaj bardziej niezawodnie zachowuje atrybuty charakterystyczne dla AsciiDoc, admonitions, dołączone pliki i odsyłacze wzajemne.

Jakość, zgodność i ograniczenia

EPUB ma płynny układ, dlatego stałe podziały wierszy, dokładne położenie elementów na stronach i instrukcje układu charakterystyczne dla PDF nie mogą być konsekwentnie zachowane. Numery stron, wdowy, sieroty i łamanie wierszy różnią się w zależności od systemu odczytu i ustawień fontu użytkownika.

Złożone rozszerzenia AsciiDoc, niestandardowe konwertery, osadzone diagramy, nieobsługiwane makra i formatowanie dostępne wyłącznie w PDF mogą wymagać ręcznych modyfikacji. Wygeneruj pliki diagramów przed konwersją i używaj ścieżek względnych dla wszystkich zasobów lokalnych.

Otwórz wynik w co najmniej jednym czytniku EPUB i sprawdź spis treści, hierarchię nagłówków, odnośniki, bloki kodu, tabele, obrazy i znaki specjalne. Aby przeprowadzić walidację na poziomie pakietu, uruchom EPUBCheck:

epubcheck book.epub

Przed rozpowszechnieniem pliku napraw brakujące zasoby, nieprawidłowy XHTML, błędy metadanych i ostrzeżenia dotyczące nawigacji.