Obrázky v dokumentácii

Obrázok má vysvetliť krok, ktorý sa textom opisuje ťažšie. Nemá nahrádzať celý postup ani zobrazovať viac údajov, než zákazník potrebuje.

Príprava obrázka

• Pre snímku obrazovky s textom alebo priehľadnosťou použite PNG.
• Pre fotografiu použite JPEG.
• Editor prijíma aj WebP; animované obrázky nie sú podporované.
• Orežte nepotrebné okraje a zvýraznite iba vysvetľovanú časť.
• Skontrolujte čitateľnosť pri šírke článku, nie iba na veľkom monitore.

Bezpečnostná kontrola pred uploadom

Odstráňte heslá, tokeny, overovacie odkazy, celé webhook URL, Ticket ID, osobné údaje, platobné údaje, súkromné identifikátory a nepotrebné herné súradnice. Nahraté médium môže byť verejne dostupné aj vtedy, keď článok ešte zostáva konceptom.

Nahranie v editore

1. Na zozname dokumentácie otvorte článok a správny jazyk.
2. Umiestnite kurzor na miesto, kde má obrázok pomôcť.
3. Použite tlačidlo obrázka a vyberte súbor.
4. Doplňte zmysluplný alternatívny text.
5. Uložte koncept a otvorte náhľad.
6. Skontrolujte desktop, mobil, popis a prípadnú priehľadnosť.

Ako napísať alt text

Popíšte význam obrázka v konkrétnom kroku, napríklad „Jazyková karta slovenčiny a tlačidlo Uložiť koncept“. Názov súboru ako screenshot-01.png nie je užitočný. Dôležitý postup musí zostať vysvetlený aj v texte pre človeka, ktorý obrázok nevidí.

Automatické varianty

Po nahraní systém pripraví zmenšené WebP varianty s kvalitou 80 a zachová priehľadnosť. Obrázok nezväčší nad pôvodné rozmery. PNG alebo JPEG zostáva ako fallback; pri WebP vstupe sa pripraví aj PNG fallback. Jednotlivé veľkosti preto netreba vyrábať ručne.

Limity súboru

Keď upload zlyhá

Skontrolujte formát, veľkosť a rozmery. Veľkú snímku zmenšite alebo rozdeľte na logické výrezy. Staré súbory a varianty nemažte ručne – môžu byť stále použité v publikovanej alebo historickej revízii.