Online konvertor PNG do ADOC zdarma

Zdrojový formát: PNG

PNG (Portable Network Graphics) je rastrový formát obrázků, který se široce používá pro snímky obrazovky, loga, diagramy, ikony a webovou grafiku. Podporuje bezztrátovou kompresi a průhlednost, díky čemuž je často volenou možností, když záleží na kvalitě obrazu a čistých hranách. Soubory PNG obvykle vytvářejí grafické editory, nástroje pro snímání obrazovky, kamery s možnostmi exportu a návrhový software.

Cílový formát: ADOC

ADOC je soubor dokumentu AsciiDoc, formát obyčejného textu používaný pro psaní technické dokumentace, manuálů, souborů README a knih. Mezi jeho hlavní výhody patří čitelnost, snadná správa verzí a flexibilní publikování do formátů, jako jsou HTML, PDF a EPUB. Na rozdíl od PNG není ADOC formát obrázku; jde o textový značkovací formát, takže převod PNG na ADOC obvykle znamená vložit obrázek do dokumentu AsciiDoc nebo vytvořit soubor AsciiDoc, který na obrázek odkazuje.

Jak provést převod

Nejlepší postup závisí na tom, co má soubor ADOC obsahovat:

1. Pokud chcete AsciiDoc soubor, který zobrazuje obrázek PNG

Vytvořte nový soubor .adoc a vložte makro pro obrázek, které odkazuje na soubor PNG:

image::picture.png[]

Pokud je obrázek v podadresáři, použijte relativní cestu, například image::images/picture.png[].

Soubor můžete vytvořit nebo upravit v libovolném textovém editoru, jako je VS Code, Notepad++ nebo Vim. Uložte jej s příponou .adoc.

2. Pokud chcete převést PNG do obsahu dokumentace

Otevřete PNG v prohlížeči nebo editoru obrázků a ručně jej popište v AsciiDoc. Například snímek obrazovky lze převést na krokovou dokumentaci s nadpisy, seznamy a obrázkem vloženým jako obrázek (figura).

3. Pokud chcete výsledek náhlednout nebo publikovat

Použijte procesor AsciiDoc, jako je Asciidoctor, pro vykreslení souboru:

asciidoctor file.adoc

Tím se ve výchozím nastavení vygeneruje výstup ve formátu HTML. Pokud potřebujete PDF nebo jiné formáty, použijte příslušný backend Asciidoctoru nebo nástrojovou sadu.

Použití vestavěného online převodníku

Soubor můžete převést na 101convert.com zdarma, bez instalace jakéhokoli softwaru. Nahrajte PNG, zvolte ADOC jako cílový formát a stáhněte vygenerovaný výsledek. Je to pohodlné pro rychlé převody, zejména když potřebujete jen jednoduchý soubor AsciiDoc, který odkazuje na obrázek nebo jej balíčkuje.

Poznámky k kvalitě, kompatibilitě a omezením

PNG na ADOC není skutečná konverze obrázku na text. ADOC neumí ukládat pixelová data tak, jak to dělá PNG, takže výsledek je obvykle buď obal AsciiDoc kolem obrázku, nebo ručně napsaný dokument, který obrázek popisuje. Pokud potřebujete OCR k extrakci textu ze snímku obrazovky, nejprve použijte OCR nástroj a poté vložte rozpoznaný text do souboru ADOC.

Pro nejlepší kompatibilitu uchovávejte soubor PNG ve stejné složce jako soubor .adoc nebo použijte správnou relativní cestu. Při publikování se ujistěte, že je obrázek dostupný pro procesor AsciiDoc. Velké soubory PNG mohou zvýšit velikost dokumentu a zpomalit vykreslování, zatímco průhledné PNG obecně fungují v výstupech AsciiDoc dobře.

Pokud je vaším cílem upravovat samotný obrázek, převed’te jej raději do formátu pro rastrové úpravy; ADOC je určené pro dokumentaci, ne pro úpravy obrázků.