Konverter online gratis PNG ke ADOC

Format sumber: PNG

PNG (Portable Network Graphics) adalah format gambar raster yang banyak digunakan untuk tangkapan layar, logo, diagram, ikon, dan grafis web. Format ini mendukung kompresi tanpa kehilangan (lossless compression) dan transparansi, sehingga menjadi pilihan umum ketika kualitas gambar dan tepi yang bersih menjadi hal penting. File PNG biasanya dibuat oleh editor grafis, alat tangkap layar (screen capture), kamera dengan opsi ekspor, dan perangkat lunak desain.

Format target: ADOC

ADOC adalah berkas dokumen AsciiDoc, format teks biasa yang digunakan untuk menulis dokumentasi teknis, manual, berkas README, dan buku. Keunggulan utamanya adalah keterbacaan, kontrol versi yang mudah, serta penerbitan yang fleksibel ke format seperti HTML, PDF, dan EPUB. Berbeda dari PNG, ADOC bukan format gambar; ini adalah format markup berbasis teks, jadi mengonversi PNG ke ADOC biasanya berarti menyematkan gambar di dalam dokumen AsciiDoc atau membuat berkas AsciiDoc yang mereferensikan gambar tersebut.

Cara melakukan konversi

Pendekatan terbaik bergantung pada apa yang ingin Anda masukkan ke dalam berkas ADOC:

1. Jika Anda ingin berkas AsciiDoc yang menampilkan gambar PNG

Buat berkas .adoc baru dan masukkan macro gambar yang mengarah ke berkas PNG:

image::picture.png[]

Jika gambar berada di subfolder, gunakan path relatif seperti image::images/picture.png[].

Anda dapat membuat atau mengedit berkas tersebut di editor teks apa pun, seperti VS Code, Notepad++, atau Vim. Simpan dengan ekstensi .adoc.

2. Jika Anda ingin mengonversi PNG menjadi konten dokumentasi

Buka PNG di penampil atau editor gambar, lalu jelaskan secara manual dalam AsciiDoc. Misalnya, tangkapan layar dapat diubah menjadi dokumentasi langkah demi langkah dengan heading, daftar, dan gambar yang disertakan sebagai sebuah figure.

3. Jika Anda ingin meninjau (preview) atau mempublikasikan hasilnya

Gunakan prosesor AsciiDoc seperti Asciidoctor untuk merender berkas:

asciidoctor file.adoc

Ini akan menghasilkan output HTML secara default. Jika Anda memerlukan PDF atau format lain, gunakan backend Asciidoctor atau toolchain yang sesuai.

Menggunakan konverter online bawaan

Anda dapat mengonversi berkas di 101convert.com secara gratis, tanpa menginstal perangkat lunak apa pun. Unggah PNG, pilih ADOC sebagai format target, lalu unduh hasil yang dihasilkan. Ini nyaman untuk konversi cepat, terutama ketika Anda hanya membutuhkan berkas AsciiDoc sederhana yang mereferensikan atau mengemas gambar.

Catatan tentang kualitas, kompatibilitas, dan keterbatasan

PNG ke ADOC bukan konversi gambar-ke-teks yang benar (true image-to-text conversion). ADOC tidak dapat menyimpan data piksel seperti yang dilakukan PNG, sehingga hasilnya biasanya berupa pembungkus (wrapper) AsciiDoc di sekitar gambar atau dokumen yang ditulis secara manual yang menjelaskan gambar tersebut. Jika Anda perlu OCR untuk mengekstrak teks dari tangkapan layar, gunakan alat OCR terlebih dahulu, lalu masukkan teks yang dikenali ke dalam berkas ADOC.

Untuk kompatibilitas terbaik, simpan berkas PNG di folder yang sama dengan .adoc atau gunakan path relatif yang benar. Saat mempublikasikan, pastikan gambar dapat diakses oleh prosesor AsciiDoc. File PNG berukuran besar dapat meningkatkan ukuran dokumen dan memperlambat proses rendering, sedangkan PNG transparan umumnya bekerja dengan baik dalam output AsciiDoc.

Jika tujuan Anda adalah mengedit gambar itu sendiri, konversikan ke format untuk pengeditan raster; ADOC ditujukan untuk dokumentasi, bukan pengeditan gambar.