A hiányzó alternatív szöveget könnyű figyelmen kívül hagyni a Markdownban, mert a forrás továbbra is teljesnek tűnhet. Megvan a kép szintaxisa, a fájl elérési útja, és a dokumentum megjelenhet úgy, hogy a képernyőkép látható. A hiányzó rész a zárójelben lévő szöveg.
A műszaki íróknak ezt meg kell érteniük a közzététel előtt. A Converty Markdown Validator megjelenítheti a hiányzó alternatív szöveget más szerzői figyelmeztetések mellett, így a probléma látható, miközben a forrás még mindig könnyen javítható.
Miért rejtőzik el a hiányzó alternatív szöveg a Markdownban?
A Markdown kép szintaxisa így néz ki:
Ha a leírás hiányzik, a kép továbbra is megjeleníthető:
Ez megkönnyíti a problémát a vizuális vizsgálat során. Az oldal jónak tűnhet a szerző számára, de a forrás elvesztette a hasznos kontextust a szövegalternatívákra támaszkodó olvasók és a kép szerepét megérteni próbáló lektorok számára.
Ellenőrizze a képeket az előnézeti folyamat során
A gyakorlati dokumentumok munkafolyamatának tartalmaznia kell egy képközpontú felülvizsgálati lépést:
- Illessze be a Markdown-t a [Markdown Validator]-ba (/hu/markdown-validator).
- Tekintse át a renderelt előnézetet a kép megjelenésének megerősítéséhez.
- Olvassa el a hiányzó alternatív szövegre vonatkozó figyelmeztetések listáját.
- Térjen vissza a forráshoz, és írjon egy tömör leírást, amely elmagyarázza a kép célját.
- Közzététel vagy kötelezettségvállalás előtt ellenőrizze újra a dokumentumot.
Ez gyorsabb, mint arra várni, hogy egy lekérő vagy közzétett oldal észrevegye a problémát.
A jó alternatív szöveg a kontextustól függ
A helyettesítő szövegnek le kell írnia, hogy miért számít a képnek a dokumentumban. A CSV-ellenőrző képernyőképéhez nincs szükség minden látható képpontra. Lehet, hogy azt kell mondania, hogy az érvényesítő duplikált fejléc-figyelmeztetéseket vagy az importált sorok elemzett előnézetét jeleníti meg.
A legjobb leírás a környező szövegtől függ. Ha a bekezdés már teljesen elmagyarázza a képet, az alternatív szöveg lehet rövid. Ha a kép új információt hordoz, az alternatív szövegnek segítenie kell az információ megőrzését.
Párosítsa az alternatív ellenőrzéseket a szélesebb Markdown QA-val
A hiányzó alternatív szöveg egy szerzői probléma a sok közül. A jó előnézeti átvizsgálásnak ellenőriznie kell a címsor szerkezetét, a hivatkozásokat, a táblázatokat és a kódkerítéseket is.
A szélesebb körű munkafolyamat érdekében olvassa el a Hogyan észlelje a leértékelési problémákat a közzététel előtt című részt. A csoportos felülvizsgálathoz használja a Hogyan tekinthetik át a termék- és dokumentumcsapatok a jelöléseket a formázás elvesztése nélkül lehetőséget.
Nyissa meg a Markdown Validator elemet a Markdown közzététele előtt, ha képernyőképek vagy diagramok szerepelnek a dokumentumban.
