Darmowy konwerter online ASCIIDOC do HTML

Pliki AsciiDoc wymagają konwersji, gdy dokumentację trzeba otworzyć w przeglądarce internetowej, opublikować na stronie internetowej lub dostarczyć do systemu, który akceptuje HTML zamiast źródła znaczników. HTML zachowuje nagłówki, listy, odnośniki, tabele, bloki kodu i inne elementy struktury w formacie bezpośrednio widocznym dla użytkownika.

Czym jest format ASCIIDOC

AsciiDoc to format znaczników w postaci zwykłego tekstu przeznaczony do tworzenia ustrukturyzowanych dokumentów, takich jak dokumentacja oprogramowania, podręczniki, pliki README, artykuły i specyfikacje techniczne. Autorzy oznaczają strukturę za pomocą czytelnej składni dla nagłówków, list, odnośników, komunikatów, tabel, kodu źródłowego, obrazów i odwołań krzyżowych.

Typowe rozszerzenia nazw plików to .adoc, .asciidoc, a czasami .asc. Pliki są tworzone lub edytowane za pomocą zwykłych edytorów tekstu i narzędzi do tworzenia dokumentacji, w tym Asciidoctor, Asciidoctor.js i Antora. Plik AsciiDoc zawiera źródłowe znaczniki, dlatego przeglądarka wyświetli jego znaki formatowania zamiast wyrenderować zamierzoną strukturę dokumentu.

Czym jest format HTML

HTML to format znaczników interpretowany przez przeglądarki internetowe i używany przez strony internetowe, portale dokumentacji, systemy zarządzania treścią oraz procesy związane z pocztą e-mail. Konwersja do HTML przekształca strukturę AsciiDoc w elementy takie jak <h1>, <p>, <ul>, <table> i <pre>.

HTML sprawdza się, gdy odbiorcy potrzebują wyświetlania w przeglądarce, przeszukiwalnej dokumentacji, treści możliwej do kopiowania lub pliku, który można osadzić na stronie internetowej. Wynik może zawierać style CSS, odwołania do obrazów, zasoby do wyróżniania składni oraz odnośniki do innych wygenerowanych stron.

Jak faktycznie przekonwertować ASCIIDOC do HTML

Korzystanie z Asciidoctor

1. Zainstaluj Ruby i procesor Asciidoctor, a następnie uruchom gem install asciidoctor.
2. Otwórz terminal w katalogu zawierającym plik źródłowy.
3. Przekonwertuj go za pomocą asciidoctor input.adoc -o output.html. Zastąp nazwy plików rzeczywistymi nazwami pliku źródłowego i docelowego.
4. Otwórz output.html w przeglądarce i sprawdź nagłówki, odnośniki, tabele, bloki kodu oraz obrazy.

Aby wygenerować osadzony HTML odpowiedni do wstawienia na innej stronie, użyj asciidoctor -e input.adoc -o fragment.html. Aby zastosować arkusz stylów, podaj jego lokalizację za pomocą atrybutu Asciidoctor, na przykład asciidoctor -a stylesheet=site.css input.adoc -o output.html.

Korzystanie z konwertera online

Możesz bezpłatnie przekonwertować plik w witrynie 101convert.com bez instalowania oprogramowania. Prześlij plik AsciiDoc, w razie potrzeby wybierz HTML jako format wyjściowy, rozpocznij konwersję i pobierz wygenerowany plik. Po pobraniu sprawdź połączone obrazy i dołączone pliki, ponieważ konwersja w przeglądarce może nie mieć dostępu do lokalnych ścieżek wskazanych w źródle.

Kwestie dotyczące jakości i zgodności

Dokumenty AsciiDoc mogą odwoływać się do obrazów, dołączać inne pliki źródłowe, ładować atrybuty i korzystać z niestandardowych rozszerzeń. Lokalna konwersja za pomocą Asciidoctor jest zwykle preferowana, gdy te zależności mają znaczenie, ponieważ konwerter może działać z właściwego katalogu projektu i używać zamierzonych atrybutów.

Przechowuj obrazy i pliki CSS, do których istnieją odwołania, w oczekiwanych lokalizacjach względnych albo zaktualizuj wygenerowane ścieżki przed publikacją. Plik HTML może zawierać odnośniki do oddzielnych zasobów zamiast osadzać je w pliku, dlatego przeniesienie samego pliku HTML może spowodować brak obrazów lub wyświetlanie treści bez stylów.

Niestandardowe makra, nieobsługiwane rozszerzenia, brakujące dołączenia i nieprawidłowe atrybuty dokumentu mogą prowadzić do niekompletnego wyniku. Przetestuj wygenerowany HTML w docelowej przeglądarce lub systemie publikowania, szczególnie gdy źródło korzysta z wyróżniania składni, odnośników między dokumentami lub znaków innych niż ASCII.