Darmowy konwerter online PNG do ADOC

Format źródłowy: PNG

PNG (Portable Network Graphics) to format grafiki rastrowej szeroko stosowany do zrzutów ekranu, logo, diagramów, ikon oraz grafiki internetowej. Obsługuje bezstratną kompresję i przezroczystość, dzięki czemu jest częstym wyborem, gdy liczy się jakość obrazu i czyste krawędzie. Pliki PNG są zwykle tworzone przez edytory graficzne, narzędzia do przechwytywania ekranu, aparaty z opcjami eksportu oraz oprogramowanie projektowe.

Format docelowy: ADOC

ADOC to plik dokumentu AsciiDoc, format tekstowy typu plain-text używany do pisania dokumentacji technicznej, instrukcji, plików README oraz książek. Jego główne zalety to czytelność, łatwa kontrola wersji oraz elastyczne publikowanie do formatów takich jak HTML, PDF i EPUB. W przeciwieństwie do PNG, ADOC nie jest formatem obrazu; to tekstowy format znaczników, więc konwersja PNG do ADOC zwykle oznacza osadzenie obrazu w dokumencie AsciiDoc albo utworzenie pliku AsciiDoc, który odwołuje się do obrazu.

Jak wykonać konwersję

Najlepsze podejście zależy od tego, co ma zawierać plik ADOC:

1. Jeśli chcesz plik AsciiDoc, który wyświetla obraz PNG

Utwórz nowy plik .adoc i wstaw makro obrazu wskazujące na plik PNG:

image::picture.png[]

Jeśli obraz znajduje się w podfolderze, użyj ścieżki względnej, np. image::images/picture.png[].

Możesz utworzyć lub edytować plik w dowolnym edytorze tekstu, takim jak VS Code, Notepad++ lub Vim. Zapisz go z rozszerzeniem .adoc.

2. Jeśli chcesz przekonwertować PNG na treść dokumentacji

Otwórz PNG w przeglądarce lub edytorze obrazów i opisz je ręcznie w AsciiDoc. Na przykład zrzut ekranu można przekształcić w dokumentację krok po kroku, z nagłówkami, listami oraz obrazem dodanym jako figura.

3. Jeśli chcesz podglądnąć lub opublikować wynik

Użyj procesora AsciiDoc, takiego jak Asciidoctor, aby wyrenderować plik:

asciidoctor file.adoc

Domyślnie generowane jest wyjście w formacie HTML. Jeśli potrzebujesz PDF lub innych formatów, użyj odpowiedniego backendu Asciidoctor lub narzędziowego toolchain.

Korzystanie z wbudowanego konwertera online

Możesz przekonwertować plik na 101convert.com za darmo, bez instalowania żadnego oprogramowania. Prześlij PNG, wybierz ADOC jako format docelowy i pobierz wygenerowany wynik. To wygodne rozwiązanie do szybkich konwersji, szczególnie gdy potrzebujesz prostego pliku AsciiDoc, który odwołuje się do obrazu lub go pakuje.

Uwagi dotyczące jakości, kompatybilności i ograniczeń

Konwersja PNG do ADOC nie jest prawdziwą konwersją obrazu do tekstu. ADOC nie potrafi przechowywać danych pikselowych tak jak PNG, więc wynik zwykle jest albo opakowaniem AsciiDoc wokół obrazu, albo ręcznie napisanym dokumentem opisującym obraz. Jeśli potrzebujesz OCR do wyodrębnienia tekstu ze zrzutu ekranu, najpierw użyj narzędzia OCR, a następnie umieść rozpoznany tekst w pliku ADOC.

Dla najlepszej kompatybilności trzymaj plik PNG w tym samym folderze co plik .adoc lub użyj poprawnej ścieżki względnej. Podczas publikowania upewnij się, że obraz jest dostępny dla procesora AsciiDoc. Duże pliki PNG mogą zwiększać rozmiar dokumentu i spowalniać renderowanie, natomiast przezroczyste PNG zazwyczaj dobrze działają w wyjściu AsciiDoc.

Jeśli Twoim celem jest edycja samego obrazu, przekonwertuj go na format do edycji grafiki rastrowej; ADOC jest przeznaczone do dokumentacji, a nie do edycji obrazów.