Darmowy konwerter online ADOC do PDF

Odbiorca, drukarka, system archiwizacji lub obieg dokumentów może wymagać pliku PDF ze stałym układem zamiast edytowalnego źródła AsciiDoc. Renderowanie źródła do PDF zachowuje podział na strony i umożliwia wyświetlanie dokumentu bez użycia narzędzia AsciiDoc.

Czym jest format ADOC

ADOC to standardowe rozszerzenie nazwy pliku dokumentu AsciiDoc; używane są również rozszerzenia .asciidoc i .asc. Jest to format źródłowy zwykłego tekstu zawierający znaczniki nagłówków, list, linków, tabel, atrybutów, odwołań do obrazów oraz dyrektyw include::.

Programiści, autorzy dokumentacji technicznej i zespoły dokumentacyjne używają plików ADOC z narzędziami takimi jak Asciidoctor, AsciidoctorJ i Antora. Edytor tekstu wyświetla znaczniki źródłowe, takie jak = Document title i == Section, a nie dokument z podziałem na strony utworzony podczas renderowania.

Czym jest format PDF

PDF to format opisu strony, który zachowuje rozmiar strony, typografię, odstępy, obrazy i podział na strony w różnych systemach operacyjnych i na różnych drukarkach. Nadaje się do drukowania, udostępniania, tworzenia kopii archiwalnych oraz dokumentów, które muszą być spójnie wyświetlane na różnych urządzeniach.

Format PDF jest mniej wygodny do edycji niż ADOC. W przypadku dokumentacji zarządzanej za pomocą systemu kontroli wersji należy edytować plik ADOC i ponownie wygenerować PDF zamiast modyfikować plik PDF bezpośrednio.

Jak przekonwertować plik ADOC do PDF

Używanie Asciidoctor PDF

Asciidoctor PDF to najbardziej bezpośredni lokalny konwerter, ponieważ interpretuje składnię AsciiDoc i tworzy PDF bez pośredniego pliku HTML. Wymaga Ruby.

1. Zainstaluj Ruby, jeśli nie jest jeszcze dostępne na komputerze.
2. Zainstaluj Asciidoctor PDF z poziomu terminala za pomocą polecenia gem install asciidoctor-pdf.
3. Otwórz terminal w katalogu zawierającym plik źródłowy lub podaj jego pełną ścieżkę.
4. Uruchom polecenie asciidoctor-pdf document.adoc -o document.pdf.
5. Otwórz wynikowy plik i sprawdź nagłówki, linki, obrazy, tabele, bloki kodu oraz podziały stron.

Zastąp nazwy plików rzeczywistymi nazwami pliku źródłowego i wyjściowego. Własny motyw PDF można przekazać za pomocą atrybutu takiego jak -a pdf-theme=my-theme.yml, pod warunkiem że plik motywu i wszystkie używane przez niego czcionki są dostępne.

Asciidoctor PDF można również zintegrować ze skryptami i procesami kompilowania dokumentacji, co jest preferowane, gdy pliki PDF muszą być konsekwentnie regenerowane na podstawie źródła zarządzanego za pomocą systemu kontroli wersji.

Używanie 101convert.com

Możesz bezpłatnie przekonwertować plik w serwisie 101convert.com bez instalowania oprogramowania: prześlij plik .adoc, wybierz PDF jako format wyjściowy, rozpocznij konwersję i pobierz wynik. W przypadku poufnych dokumentów lub plików zależnych od lokalnych obrazów, dołączanych plików, własnych motywów lub rozszerzeń użyj lokalnego Asciidoctor PDF.

Uwagi dotyczące jakości i zgodności

• Zmiana nazwy document.adoc na document.pdf nie konwertuje pliku; źródło AsciiDoc musi zostać wyrenderowane.
• Ścieżki względne obrazów i dyrektywy include:: muszą być poprawnie rozpoznawane. Brakujące pliki mogą powodować wyświetlanie pustych obszarów obrazów lub nierozwiązanej zawartości dołączanych plików.
• Asciidoctor PDF używa własnych motywów i reguł układu. CSS używany dla wynikowego HTML AsciiDoc nie określa wyglądu PDF.
• Czcionki muszą być zainstalowane lub dostarczone w procesie kompilowania PDF i muszą zawierać wymagane znaki. W przeciwnym razie glify mogą zostać zastąpione lub wyświetlone jako pola oznaczające brak znaku.
• Diagramy, wykresy, wyróżnianie składni i generowane przykłady kodu mogą przed wygenerowaniem PDF wymagać dodatkowych rozszerzeń AsciiDoc, plików wykonywalnych lub etapów kompilowania.
• Długie tabele i bloki kodu mogą być nieprawidłowo dzielone na granicach stron. Dostosuj szerokości, ustawienia motywu lub reguły podziału stron i sprawdź wyrenderowany PDF przed jego dystrybucją.
• Wynik PDF zależy od wersji konwertera, motywu, czcionek i dołączonych zasobów, dlatego różne środowiska mogą generować nieco inny podział na strony.