Obrázky v dokumentaci

Obrázek má vysvětlit krok, který se textem popisuje obtížněji. Nemá nahrazovat celý postup ani zobrazovat více údajů, než zákazník potřebuje.

Příprava obrázku

• Pro snímek obrazovky s textem nebo průhledností použijte PNG.
• Pro fotografii použijte JPEG.
• Editor přijímá také WebP; animované obrázky nejsou podporovány.
• Ořízněte nepotřebné okraje a zvýrazněte pouze vysvětlovanou část.
• Zkontrolujte čitelnost při šířce článku, ne jen na velkém monitoru.

Bezpečnostní kontrola před uploadem

Odstraňte hesla, tokeny, ověřovací odkazy, celé webhook URL, Ticket ID, osobní údaje, platební údaje, soukromé identifikátory a nepotřebné herní souřadnice. Nahrané médium může být veřejně dostupné i tehdy, když článek ještě zůstává konceptem.

Nahrání v editoru

1. Na seznamu dokumentace otevřete článek a správný jazyk.
2. Umístěte kurzor na místo, kde má obrázek pomoci.
3. Použijte tlačítko obrázku a vyberte soubor.
4. Doplňte smysluplný alternativní text.
5. Uložte koncept a otevřete náhled.
6. Zkontrolujte desktop, mobil, popis a případnou průhlednost.

Jak napsat alt text

Popište význam obrázku v konkrétním kroku, například „Jazyková karta češtiny a tlačítko Uložit koncept“. Název souboru jako screenshot-01.png není užitečný. Důležitý postup musí zůstat vysvětlen iv textu pro člověka, který obrázek nevidí.

Automatické varianty

Po nahrání systém připraví zmenšené WebP varianty s kvalitou 80 a zachová průhlednost. Obrázek nezvětší nad původní rozměry. PNG nebo JPEG zůstává jako fallback; při WebP vstupu se připraví i PNG fallback. Jednotlivé velikosti proto není třeba vyrábět ručně.

Limity souboru

Když upload selže

Zkontrolujte formát, velikost a rozměry. Velký snímek zmenšete nebo rozdělte na logické výřezy. Staré soubory a varianty nemažte ručně – mohou být stále použity v publikované nebo historické revizi.