Darmowy konwerter online AD do DOCBOOK

Czym jest format AD

W kategorii plików tekstowych AD zazwyczaj oznacza plik źródłowy AsciiDoc. Pliki AsciiDoc zawierają znaczniki w postaci zwykłego tekstu dla nagłówków, list, tabel, odnośników, obrazów, komunikatów, kodu źródłowego i metadanych dokumentu; ta sama składnia jest również często zapisywana z rozszerzeniami .adoc lub .asciidoc.

Pliki z rozszerzeniem .ad są tworzone lub edytowane za pomocą procesorów AsciiDoc, Asciidoctor oraz zwykłych edytorów tekstu. Samo rozszerzenie nie gwarantuje użycia konkretnego procesora ani wersji składni, dlatego przed konwersją należy sprawdzić pierwsze wiersze pod kątem atrybutów takich jak :doctype:, :toc: lub dyrektyw include.

Czym jest format DOCBOOK

DocBook to słownik XML przeznaczony do tworzenia uporządkowanej dokumentacji technicznej. Reprezentuje elementy dokumentu, takie jak rozdziały, sekcje, akapity, procedury, tabele, cytowania, listingi programów i odwołania wzajemne, niezależnie od ostatecznego układu strony.

DocBook sprawdza się, gdy potok wydawniczy korzysta z narzędzi takich jak xsltproc, Jing, Saxon lub arkuszy stylów DocBook do tworzenia HTML, PDF, EPUB lub stron podręcznika. Jego struktura XML ułatwia również walidację, indeksowanie i późniejsze przekształcanie do innych formatów w porównaniu z pracą ze znacznikami ukierunkowanymi na prezentację.

Jak przekonwertować AD na DOCBOOK

Asciidoctor to najbardziej bezpośrednie narzędzie do konwersji na komputerze, ponieważ odczytuje AsciiDoc i zawiera backend DocBook.

1. Zainstaluj Asciidoctor za pomocą menedżera pakietów systemu operacyjnego lub gem Ruby, a następnie sprawdź instalację poleceniem asciidoctor --version.
2. Umieść plik źródłowy oraz wszystkie powiązane obrazy, dołączane pliki i pliki atrybutów w oczekiwanych ścieżkach względnych.
3. Uruchom polecenie asciidoctor -b docbook5 -o output.xml input.ad. Opcja -b docbook5 wybiera XML DocBook 5, a -o ustawia nazwę pliku wyjściowego.
4. W przypadku obiegu pracy z DocBook 4 użyj polecenia asciidoctor -b docbook -o output.xml input.ad, jeśli ten backend jest dostępny w zainstalowanej wersji.
5. Zweryfikuj wynik za pomocą schematu DocBook lub polecenia walidacyjnego wymaganego przez system wydawniczy. Otwórz plik output.xml w edytorze obsługującym XML, aby sprawdzić nierozwiązane dołączenia, nieprawidłowe ścieżki obrazów i błędnie sformułowane atrybuty.

Aby przeprowadzić konwersję graficznie bez instalowania oprogramowania, prześlij plik AD do 101convert.com, wybierz DOCBOOK jako format docelowy i pobierz wygenerowany XML. Jest to odpowiednie rozwiązanie w przypadku jednorazowej konwersji pliku, gdy źródło korzysta ze standardowych funkcji AsciiDoc i nie zależy od lokalnych plików dołączanych.

Kwestie dotyczące jakości i zgodności

Znaczniki AsciiDoc nie zawsze odwzorowują się idealnie na DocBook, gdy źródło korzysta z niestandardowych rozszerzeń, atrybutów właściwych dla konkretnego backendu, bloków passthrough, makr lub osadzonych skryptów. Po konwersji należy sprawdzić komunikaty, tabele, wywołania, przypisy, odwołania wzajemne i listingi kodu źródłowego.

Obrazy względne i dyrektywy include:: wymagają dostępu do oryginalnej struktury katalogów; konwerter, który otrzyma tylko główny plik, może pominąć te zasoby lub pozostawić nierozwiązane odwołania. Wynik DocBook jest kodem XML, a nie gotowym plikiem PDF ani stroną internetową, dlatego później należy zastosować odpowiedni arkusz stylów DocBook lub narzędzie wydawnicze używane w kolejnym etapie.