Darmowy konwerter online DOCX do ADOC

Dokumenty Word są konwertowane do AsciiDoc, gdy dokumentacja musi być przechowywana w Git, przeglądana jako tekst lub renderowana przez system publikowania AsciiDoc. Wynikowy kod źródłowy .adoc jest łatwiejszy do porównywania, scalania i ponownego wykorzystania w kompilacjach HTML lub PDF niż plik Word.

Format DOCX

.docx to domyślny format Microsoft Word, należący do standardu Office Open XML. Plik DOCX jest pakietem ZIP zawierającym pliki XML i powiązane pliki przeznaczone dla tekstu, stylów, tabel, obrazów, komentarzy, zmian, nagłówków, stopek i właściwości dokumentu.

Microsoft Word jest jego podstawowym edytorem; LibreOffice Writer, Google Docs, Apple Pages oraz wiele systemów zarządzania dokumentami również może otwierać lub eksportować pliki DOCX. Format dobrze zachowuje układ i formatowanie dokumentów biurowych, ale jego spakowana struktura słabo nadaje się do przeglądania zmian w systemach kontroli wersji wiersz po wierszu.

Format ADOC

.adoc zwykle oznacza plik źródłowy AsciiDoc. AsciiDoc to zwykły tekst UTF-8 ze znacznikami dla nagłówków sekcji, list, tabel, łączy, bloków kodu, admonitions, atrybutów i odwołań do obrazów. Inne popularne rozszerzenia AsciiDoc to .asciidoc i .ad.

Procesory takie jak Asciidoctor mogą renderować AsciiDoc jako HTML, PDF, DocBook, EPUB lub dane wyjściowe witryny dokumentacji. Obrazy są zwykle osobnymi plikami, do których odwołuje się kod źródłowy, dzięki czemu tekst pozostaje czytelny, a zasoby graficzne można łatwo zarządzać w Git.

Przed konwersją potwierdź wymagany format. Niektóre produkty używają .adoc dla niezwiązanych z tym zastrzeżonych plików; ta konwersja tworzy tekst AsciiDoc, a nie pliki w tych formatach.

Konwertowanie pliku

Aby przeprowadzić konwersję bez instalowania oprogramowania, prześlij plik DOCX do konwertera w serwisie 101convert.com, wybierz ADOC jako format wyjściowy, rozpocznij konwersję i pobierz wygenerowany plik .adoc. Otwórz go w edytorze tekstu i sprawdź nagłówki, tabele, łącza oraz odwołania do obrazów przed użyciem go w procesie publikowania.

W przypadku powtarzalnej konwersji lokalnej Pandoc odczytuje DOCX i zapisuje AsciiDoc. Po zainstalowaniu Pandoc uruchom to polecenie z folderu zawierającego dokument:

pandoc input.docx --from=docx --to=asciidoc --extract-media=media --wrap=none --output=output.adoc

--extract-media=media zapisuje osadzone obrazy w katalogu media i generuje odwołania do obrazów w danych wyjściowych. Zachowaj ten katalog razem z plikiem ADOC podczas przenoszenia lub publikowania dokumentu. --wrap=none zapobiega arbitralnemu zawijaniu wierszy, co może zapewnić czytelniejsze porównywanie zmian w systemie kontroli wersji.

Wyrenderuj wynik za pomocą Asciidoctor, aby sprawdzić wygenerowane znaczniki:

asciidoctor output.adoc

Spowoduje to utworzenie pliku output.html, który można otworzyć w przeglądarce w celu sprawdzenia.

Ograniczenia konwersji

Konwersja zależy od semantyki dokumentu, a nie od jego wyglądu. Przed konwersją zastosuj wbudowane style nagłówków Word; tekst powiększony lub pogrubiony bez użycia stylu nagłówka może pozostać zwykłym akapitem.

Zwykłe akapity, style nagłówków, listy, podstawowe wyróżnienia, łącza i proste tabele zwykle są przenoszone poprawnie. Scalane lub zagnieżdżone tabele, stałe szerokości kolumn, cieniowanie komórek, pola tekstowe, obiekty pływające, SmartArt, równania, złożony układ strony i obrazy umieszczone w określonych pozycjach nie mają bezpośrednich odpowiedników w AsciiDoc i wymagają ręcznego przepisania lub zastąpienia obrazami i standardowymi znacznikami.

Przed konwersją zaakceptuj lub odrzuć śledzone zmiany, a potrzebne komentarze zachowaj osobno. Nagłówki, stopki, pola numerów stron, makra, ochrona dokumentu i elementy sterujące układem charakterystyczne dla Word nie są niezawodną treścią AsciiDoc; przenieś istotne informacje do zwykłych sekcji dokumentu.

Zewnętrzne hiperłącza zwykle są konwertowane poprawnie, ale zakładki Word i odwołania krzyżowe należy przetestować po renderowaniu. Aby zapewnić trwałe łącza wewnętrzne, przypisz jawne kotwice AsciiDoc, takie jak [[installation]], i odwołuj się do nich za pomocą <<installation,Installation>>.