Darmowy konwerter online ASCIIDOC do DOCX

Czym jest format ASCIIDOC

AsciiDoc to tekstowy format znaczników przeznaczony do tworzenia ustrukturyzowanych dokumentów, takich jak podręczniki oprogramowania, informacje o wydaniach, książki, specyfikacje i pliki README. Pliki zwykle używają rozszerzeń .adoc lub .asciidoc i mogą być tworzone za pomocą dowolnego edytora tekstu, IDE lub systemów dokumentacji opartych na Asciidoctor.

AsciiDoc przechowuje nagłówki, listy, tabele, odsyłacze, bloki kodu źródłowego, obrazy, adnotacje, atrybuty i odsyłacze krzyżowe jako czytelny tekst. Asciidoctor jest najczęściej używanym konwerterem i może generować HTML, DocBook, PDF za pośrednictwem dodatkowych narzędzi oraz inne formaty wyjściowe.

Czym jest format DOCX

DOCX to oparty na XML format dokumentów używany przez Microsoft Word i obsługiwany przez LibreOffice Writer, OnlyOffice oraz inne aplikacje biurowe. Nadaje się do pracy z dokumentami wymagającej edytowalnych akapitów, stylów, tabel, komentarzy, śledzenia zmian, nagłówków, stopek i drukowania zorientowanego na strony.

DOCX jest preferowany, gdy odbiorcy muszą wizualnie modyfikować dokument, stosować szablony Word, dodawać komentarze recenzentów lub przesłać plik do systemu, który nie akceptuje znaczników w postaci zwykłego tekstu. W przeciwieństwie do AsciiDoc, DOCX nie zachowuje znaczników źródłowych jako głównego interfejsu edycji.

Jak faktycznie przekonwertować ASCIIDOC do DOCX

Używanie Asciidoctor i Pandoc

Najbardziej kontrolowaną metodą na komputerze jest wygenerowanie dokumentu AsciiDoc jako DocBook za pomocą Asciidoctor, a następnie przekonwertowanie pliku DocBook do DOCX przy użyciu Pandoc.

1. Zainstaluj Asciidoctor i Pandoc. Po zainstalowaniu Ruby Asciidoctor można zainstalować za pomocą polecenia gem install asciidoctor. Zainstaluj Pandoc z oficjalnego pakietu dla danego systemu operacyjnego.
2. Otwórz terminal w katalogu zawierającym plik źródłowy i wygeneruj DocBook 5:

asciidoctor -b docbook5 -o manual.xml manual.adoc

3. Przekonwertuj plik pośredni do DOCX:

pandoc manual.xml -o manual.docx

4. Otwórz plik manual.docx w Word lub LibreOffice Writer i sprawdź nagłówki, tabele, obrazy, bloki kodu, podziały stron oraz odsyłacze przed jego rozpowszechnieniem.

Aby użyć szablonu Word, podaj referencyjny plik DOCX zawierający żądane style:

pandoc manual.xml --reference-doc=company-template.docx -o manual.docx

Upewnij się, że obrazy są dostępne w ścieżkach względnych używanych przez źródło AsciiDoc. Jeśli źródło korzysta z atrybutów lub dołączanych plików, uruchom Asciidoctor z katalogu projektu, aby te pliki mogły zostać odnalezione. Dokument składający się z wielu plików źródłowych można najpierw połączyć za pomocą dyrektywy include::, a następnie przetworzyć przy użyciu tych samych poleceń.

Używanie konwertera online

Możesz bezpłatnie przekonwertować plik w serwisie 101convert.com bez instalowania oprogramowania: prześlij plik ASCIIDOC, wybierz DOCX jako format wyjściowy, rozpocznij konwersję i pobierz wygenerowany dokument. Po pobraniu sprawdź wynik, zwłaszcza jeśli źródło zawiera lokalne obrazy, dołączane pliki, niestandardowe rozszerzenia Asciidoctor lub diagramy.

Ograniczenia jakości i zgodności

Pośredni etap z użyciem DocBook lepiej zachowuje standardową strukturę dokumentu niż kopiowanie wygenerowanego HTML do Word, ale nie umożliwia odtworzenia wszystkich funkcji Asciidoctor. Niestandardowe rozszerzenia, bloki passthrough, treści warunkowe, złożona logika atrybutów, procesory diagramów, specjalistyczne style adnotacji i niektóre makra mogą zostać pominięte lub przekonwertowane na zwykły tekst.

DOCX korzysta z układu stron i stylów Word, podczas gdy AsciiDoc opisuje przede wszystkim strukturę semantyczną. W wynikowym pliku DOCX należy spodziewać się konieczności dostosowania marginesów, czcionek, szerokości tabel, wyróżniania składni, rozmiarów obrazów, podpisów, nagłówków, stopek i podziałów stron. Bloki kodu źródłowego i tabele wymagają szczególnej kontroli, ponieważ długie wiersze i szerokie kolumny mogą wychodzić poza obszar strony.

Odsyłacze i podstawowe nagłówki zwykle konwertują się prawidłowo. Odsyłacze krzyżowe, przypisy, osadzone multimedia i względne ścieżki obrazów zależą od wersji Asciidoctor i Pandoc oraz od sposobu zorganizowania źródła. Zachowaj oryginalny plik .adoc jako źródło nadrzędne, jeśli dokument będzie nadal utrzymywany.