Darmowy konwerter online ADOC do PNG

Format źródłowy

ADOC to plik źródłowy AsciiDoc, format dokumentu w postaci zwykłego tekstu, używany do tworzenia dokumentacji technicznej, książek, podręczników, plików README oraz innej uporządkowanej treści. Jest popularny wśród programistów, autorów technicznych i zespołów dokumentacji, ponieważ obsługuje nagłówki, listy, tabele, bloki kodu, odnośniki krzyżowe i inne bogate funkcje dokumentu, pozostając jednocześnie łatwy do edycji w dowolnym edytorze tekstu.

Ponieważ ADOC jest formatem źródłowym z adnotacjami (markup), nie jest przeznaczone do bezpośredniego oglądania jako finalny dokument wizualny. Aby zamienić je na obraz, treść jest zwykle najpierw renderowana do formatu opartego na stronach, takiego jak PDF lub SVG, a następnie konwertowana do PNG.

Format docelowy

PNG to powszechnie obsługiwany format rastrowego obrazu, który wykorzystuje kompresję bezstratną. Jest powszechnie używany do zrzutów ekranu, diagramów, grafiki internetowej oraz obrazów, które muszą mieć wyraźny tekst lub przezroczyste tła. PNG jest dobrym wyborem, gdy potrzebujesz statycznego obrazu strony dokumentu lub wyrenderowanego fragmentu sformatowanego tekstu.

Główne zalety PNG to jakość bezstratna, szeroka kompatybilność oraz obsługa przezroczystości. Do konwersji dokumentów jest to szczególnie przydatne, gdy chcesz wierną wizualną migawkę wyrenderowanej treści AsciiDoc.

Jak wykonać konwersję

Najbardziej niezawodnym sposobem konwersji .adoc do .png jest najpierw wyrenderowanie pliku AsciiDoc do PDF, a następnie wyeksportowanie strony PDF jako obrazu PNG. Zachowuje to układ i formatowanie lepiej niż próba bezpośredniego zasteryzowania źródła.

1. Wyrenderuj plik ADOC do PDF. Jeśli używasz Asciidoctor, zainstaluj go i uruchom polecenie takie jak asciidoctor -o output.pdf input.adoc. W zależności od konfiguracji możesz potrzebować zaplecza PDF, takiego jak Asciidoctor PDF, lub zestawu narzędzi, który potrafi wygenerować wyjście PDF z AsciiDoc.

2. Konwertuj PDF do PNG. Użyj narzędzia desktopowego, takiego jak ImageMagick, narzędzi Poppler lub aplikacji graficznej, która potrafi eksportować strony PDF jako obrazy. Na przykład w przypadku ImageMagick możesz uruchomić magick -density 200 output.pdf output.png. Wyższe wartości gęstości dają ostrzejszy tekst, ale większe pliki.

3. Sprawdź wynik. Otwórz PNG i zweryfikuj, czy rozmiar strony, ostrość tekstu i marginesy wyglądają poprawnie. Jeśli obraz jest rozmyty, zwiększ gęstość renderowania lub eksportuj w wyższej rozdzielczości.

Jeśli wolisz podejście oparte o przepływ graficzny, otwórz wyrenderowany PDF w przeglądarce lub edytorze desktopowym i użyj jego funkcji eksportu, aby zapisać stronę jako PNG. W wielu edytorach znajduje się to w menu File → Export lub File → Save As, zależnie od aplikacji.

Możesz też bezpłatnie przekonwertować plik na 101convert.com, bez instalowania żadnego oprogramowania.

Uwagi dotyczące jakości i ograniczeń

ADOC do PNG to konwersja dokumentu do obrazu, więc wynik jest statycznym, obrazem rastrowym o stałej rozdzielczości. Oznacza to, że tekst nie będzie już możliwy do zaznaczania, wyszukiwania ani edycji jako tekst. Jeśli dokument źródłowy jest długi, każda strona zwykle staje się osobnym plikiem PNG, chyba że celowo połączysz strony w jeden obraz.

Jakość w dużej mierze zależy od etapu renderowania. Eksport w niskiej rozdzielczości może sprawić, że małe czcionki będą wyglądały na miękkie lub poszarpane, natomiast eksport w wyższej rozdzielczości poprawia czytelność kosztem większych plików. Pamiętaj też, że złożone funkcje AsciiDoc, takie jak czcionki, diagramy i osadzone obrazy, mogą renderować się inaczej w zależności od procesora AsciiDoc oraz użytego łańcucha narzędzi do PDF/obrazu.

Dla najlepszej kompatybilności użyj nowoczesnego procesora AsciiDoc, takiego jak Asciidoctor, oraz dobrze obsługiwanego narzędzia do konwersji PDF do obrazu. Jeśli potrzebujesz wyniku skalowalnego zamiast obrazu rastrowego, rozważ eksport do SVG lub PDF zamiast PNG.