Darmowy konwerter online ASCIIDOC do ODT

Pliki ASCIIDOC są wygodne w przypadku dokumentacji zarządzanej za pomocą systemu kontroli wersji, ale wiele aplikacji biurowych wymaga formatu OpenDocument Text do edycji lub dostarczania dokumentów. Konwersja do ODT zachowuje dokument jako edytowalny plik edytora tekstu, który można otworzyć w LibreOffice i innych programach zgodnych z OpenDocument.

Czym jest format ASCIIDOC

AsciiDoc to lekki format znaczników służący do tworzenia uporządkowanych dokumentów w postaci zwykłego tekstu. Autorzy używają takich elementów znaczników jak nagłówki, listy, linki, tabele, ostrzeżenia, bloki kodu źródłowego i atrybuty, zamiast przechowywać formatowanie bezpośrednio w pliku edytora tekstu.

Pliki zwykle używają rozszerzenia .adoc lub .asciidoc. Asciidoctor i Asciidoc tworzą i przetwarzają te pliki; często występują one w dokumentacji oprogramowania, plikach README, instrukcjach technicznych oraz repozytoriach dokumentacji zarządzanych za pomocą Git.

Czym jest format ODT

ODT to format OpenDocument Text, oparty na ZIP format dokumentów zdefiniowany przez standard OpenDocument. Przechowuje edytowalny tekst, style akapitów i znaków, tabele, obrazy, metadane oraz informacje o układzie strony.

LibreOffice Writer bezpośrednio otwiera i edytuje pliki ODT; Apache OpenOffice i inne aplikacje zgodne z OpenDocument również mogą je odczytywać. ODT jest przydatny, gdy odbiorcy potrzebują dokumentu z podziałem na strony i edytowalnym formatowaniem, a nie źródła zawierającego znaczniki.

Jak faktycznie przekonwertować ASCIIDOC do ODT

Najbardziej niezawodny przebieg pracy na komputerze stacjonarnym polega na użyciu Asciidoctor do utworzenia DocBook XML, a następnie Pandoc do utworzenia pliku ODT.

1. Zainstaluj Asciidoctor i Pandoc. Po zainstalowaniu Ruby Asciidoctor można zainstalować za pomocą gem install asciidoctor; zainstaluj Pandoc z jego oficjalnego pakietu dla komputerów stacjonarnych przeznaczonego dla używanego systemu operacyjnego.
2. Otwórz terminal w katalogu zawierającym plik źródłowy.
3. Przekonwertuj źródło AsciiDoc do XML DocBook 5:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Przekonwertuj pośredni plik XML do ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Otwórz plik output.odt w LibreOffice Writer i sprawdź nagłówki, tabele, obrazy, podziały stron, przypisy oraz bloki kodu.

W przypadku pliku AsciiDoc zawierającego obrazy lub dołączane pliki uruchamiaj polecenia z katalogu źródłowego, aby ścieżki względne były poprawnie rozpoznawane. Jeśli źródło używa atrybutu, przekaż go do Asciidoctor za pomocą opcji takiej jak -a toc= lub zdefiniuj go w nagłówku dokumentu.

Jeśli nie chcesz instalować oprogramowania, możesz bezpłatnie przekonwertować plik w serwisie 101convert.com za pomocą jego konwertera ASCIIDOC-to-ODT.

Ograniczenia jakości i zgodności

Konwersja przebiega przez dwa modele formatów, dlatego funkcje specyficzne dla AsciiDoc mogą nie zostać dokładnie odwzorowane w ODT. Podstawowe nagłówki, akapity, wyróżnienia, listy, linki, tabele, obrazy i bloki kodu są zazwyczaj przenoszone poprawnie, natomiast złożone role, niestandardowe motywy Asciidoctor, rozszerzenia, treść warunkowa, makra i zaawansowane style ostrzeżeń mogą wymagać ręcznego dostosowania.

Źródło AsciiDoc opisuje strukturę; ODT wymaga również stylów stron, czcionek, marginesów, nagłówków, stopek i podziału na strony. Pandoc stosuje własne domyślne ustawienia dokumentu, dlatego sprawdź wynik w LibreOffice i modyfikuj style zamiast polegać na pierwotnym wyglądzie AsciiDoc. Jeśli spójny podział na strony ma znaczenie, przed ostatecznym eksportem osadź wymagane czcionki lub zainstaluj je w systemie.

Zachowaj pośredni plik XML do czasu zakończenia walidacji. Pomoże on ustalić, czy problem powstał na etapie analizowania przez Asciidoctor, czy podczas zapisu ODT przez Pandoc.