Darmowy konwerter online ASCIIDOC do TEXTILE

Czym jest format ASCIIDOC

AsciiDoc to lekki format znaczników przechowywany jako zwykły tekst, zwykle z rozszerzeniem .adoc lub .asciidoc. Obsługuje tytuły dokumentów, sekcje, ostrzeżenia, tabele, odsyłacze, atrybuty, listingi kodu źródłowego, obrazy i dołączane pliki.

Pliki są tworzone i przetwarzane przez Asciidoctor, starszy procesor AsciiDoc, AsciidocFX, Antora oraz edytory tekstu. Projekty dokumentacji, pliki README, podręczniki, informacje o wydaniach i pliki źródłowe witryn statycznych często z niego korzystają. Składnia AsciiDoc różni się w zależności od implementacji, a rozszerzenia Asciidoctor mogą dodawać funkcje, które nie należą do podstawowego formatu.

Czym jest format TEXTILE

Textile to język znaczników w postaci zwykłego tekstu, używany przez niektóre wiki, systemy zarządzania treścią, narzędzia publikowania i starsze aplikacje internetowe. Jego składnia wykorzystuje krótkie znaczniki, takie jak h1. Heading dla nagłówków, *bold* dla tekstu pogrubionego, _italic_ dla kursywy oraz "link text":https://example.com dla odnośników.

Textile pozostaje przydatny, gdy aplikacja docelowa ma parser Textile, ale nie obsługuje AsciiDoc. Ponieważ jest to zwykły tekst, przekonwertowany plik można edytować za pomocą dowolnego edytora tekstu i wersjonować bez używania binarnego formatu dokumentu. Implementacje Textile różnią się obsługą tabel, atrybutów, przypisów dolnych i rozszerzonej składni.

Jak faktycznie przekonwertować ASCIIDOC na TEXTILE

Aby szybko przeprowadzić konwersję bez instalowania oprogramowania, użyj konwertera na stronie 101convert.com: prześlij plik .adoc lub .asciidoc, wybierz TEXTILE jako format wyjściowy, rozpocznij konwersję i pobierz wynikowy plik .textile.

Aby przeprowadzić lokalną, powtarzalną konwersję, użyj Asciidoctor do utworzenia DocBook XML, a następnie Pandoc do utworzenia Textile. Pandoc nie analizuje niezawodnie każdego dialektu AsciiDoc bezpośrednio, dlatego ta dwuetapowa metoda powierza Asciidoctor interpretację składni źródłowej.

1. Zainstaluj Asciidoctor i Pandoc, korzystając z metody instalacji odpowiedniej dla Twojego systemu operacyjnego.
2. Otwórz terminal w katalogu zawierającym plik źródłowy.
3. Uruchom polecenie asciidoctor -b docbook5 -o intermediate.xml input.adoc. Zastąp input.adoc rzeczywistą nazwą pliku. Użyj input.asciidoc, jeśli jest to rozszerzenie pliku źródłowego.
4. Przekonwertuj dokument pośredni za pomocą polecenia pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Otwórz plik output.textile w edytorze tekstu lub zaimportuj go do docelowej aplikacji Textile i sprawdź wyrenderowany wynik.

Jeśli źródło korzysta z lokalnych plików dołączanych, uruchom Asciidoctor z katalogu projektu, aby ścieżki względne zostały poprawnie rozwiązane. Na przykład polecenie asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc może wymagać, aby ścieżki do dołączanych plików i atrybuty projektu były dostępne z tego katalogu roboczego.

Ograniczenia jakości i zgodności

Pośredni etap DocBook może zmienić szczegóły prezentacji. Atrybuty AsciiDoc, bloki warunkowe, niestandardowe role, rozszerzenia, styl ostrzeżeń, nierozwiązane odsyłacze oraz makra zależne od procesora mogą zostać pominięte lub przedstawione w Textile w inny sposób.

Po konwersji sprawdź tabele, zagnieżdżone listy, formatowanie w tekście, obrazy, przypisy dolne, kotwice, bloki kodu źródłowego i odnośniki. Obrazy są zwykle wskazywane za pomocą ścieżki, a nie osadzane, dlatego skopiuj pliki obrazów i zachowaj względną strukturę katalogów. Renderer Textile może nie obsługiwać każdej funkcji utworzonej przez Pandoc; nieobsługiwane konstrukcje mogą pojawić się jako zabezpieczone znaczniki lub zwykłe akapity.

Zachowaj oryginalny plik AsciiDoc jako źródło nadrzędne. Edytuj wynik Textile tylko wtedy, gdy system docelowy wymaga jednorazowej korekty, ponieważ ponowne przeprowadzenie konwersji nadpisze te zmiany.