Darmowy konwerter online ASCIIDOC do PDF

Czym jest format ASCIIDOC

AsciiDoc to format znaczników tekstu zwykłego przeznaczony do tworzenia uporządkowanych dokumentów, takich jak podręczniki oprogramowania, pliki README, książki, artykuły i specyfikacje techniczne. Autorzy tworzą czytelne pliki źródłowe zawierające nagłówki, listy, rozdzielane bloki kodu, tabele, atrybuty, odwołania między dokumentami i opcjonalne rozszerzenia; typowe rozszerzenia nazw plików to .adoc i .asciidoc.

Pliki AsciiDoc są zazwyczaj tworzone w edytorach tekstu, zintegrowanych środowiskach programistycznych, repozytoriach dokumentacji oraz systemach korzystających z Asciidoctor lub oryginalnego procesora AsciiDoc. Źródło pozostaje edytowalne i dobrze współpracuje z systemami kontroli wersji, ale jego ostateczny wygląd zależy od konwertera, motywu, czcionek, zasobów obrazów i atrybutów dokumentu.

Czym jest format PDF

PDF przechowuje strony wraz z ich układem, czcionkami, grafiką i wymiarami przeznaczonymi do druku, zachowując je niezależnie od systemu operacyjnego. Nadaje się do formalnej dokumentacji, załączników e-mail, drukowania, archiwów i recenzowania, ponieważ odbiorcy zazwyczaj nie potrzebują edytora źródłowego ani toolchaina AsciiDoc.

PDF jest mniej wygodny niż AsciiDoc podczas edycji i automatycznego porównywania wersji. Może również mieć większy rozmiar niż plik źródłowy, szczególnie gdy zawiera osadzone czcionki lub obrazy o wysokiej rozdzielczości.

Jak przekonwertować ASCIIDOC do PDF

Najbardziej bezpośrednią metodą wiersza poleceń jest Asciidoctor PDF, czyli konwerter PDF dla toolchaina Asciidoctor opartego na Ruby.

1. Zainstaluj Ruby, jeśli nie jest jeszcze dostępne.
2. Zainstaluj konwerter za pomocą gem install asciidoctor-pdf --pre. Opcja --pre może być potrzebna w przypadku bieżącego pakietu prerelease; pomiń ją podczas instalowania najnowszego stabilnego wydania.
3. Otwórz terminal w katalogu zawierającym plik źródłowy i uruchom asciidoctor-pdf manual.adoc -o manual.pdf.
4. Otwórz plik manual.pdf w przeglądarce PDF i sprawdź podziały stron, tabele, bloki kodu, odnośniki oraz obrazy.

W przypadku pliku źródłowego odwołującego się do obrazów lub dołączającego inne pliki AsciiDoc uruchom polecenie z katalogu projektu dokumentu i zachowaj jego względną strukturę folderów. Użyj -a toc=left lub -a toc=macro, aby dodać spis treści, oraz -a pdf-theme=custom-theme.yml, aby zastosować niestandardowy motyw PDF. Tytuł, autora i rewizję można ustawić w nagłówku dokumentu za pomocą atrybutów, takich jak = Installation manual, Author Name <author@example.com> i :revnumber: 1.2.

Możesz również bezpłatnie przekonwertować plik w witrynie 101convert.com bez instalowania oprogramowania. Prześlij plik AsciiDoc, wybierz PDF jako format wyjściowy, rozpocznij konwersję i pobierz wygenerowany dokument.

Kwestie dotyczące jakości i zgodności

Składnia AsciiDoc jest przetwarzana przez konwerter, a nie bezpośrednio kopiowana do PDF, dlatego nieobsługiwane rozszerzenia, niestandardowe makra, ścieżki include i zawartość warunkowa mogą zmienić wynik. Asciidoctor PDF używa bieżącego katalogu roboczego i atrybutów dokumentu do rozwiązywania ścieżek include oraz zasobów; brakujące ścieżki powodują niekompletny wynik lub ostrzeżenia.

Aby zapewnić przewidywalny podział na strony, osadź czcionki lub skonfiguruj je jawnie, ustaw rozmiar strony i marginesy w motywie PDF oraz używaj wymiarów obrazów przeznaczonych do druku. Po konwersji sprawdź diagramy, pliki SVG, odnośniki zewnętrzne, przypisy, przepełnienie tabel oraz znaki zapisywane od prawej do lewej lub znaki inne niż łacińskie. Plik źródłowy może zostać pomyślnie przekonwertowany, a mimo to zawierać przycięte tabele lub brakujące glify, jeśli wybrana czcionka nie zawiera wymaganych znaków.