Lipsa textului alternativ este ușor de trecut cu vederea în Markdown, deoarece sursa poate părea completă. Sintaxa imaginii este prezentă, calea fișierului este prezentă, iar documentul poate fi randat cu captura de ecran vizibilă. Partea care lipsește este textul dintre paranteze.
Scriitorii tehnici ar trebui să prindă asta înainte de a publica. Markdown Validator de la Converty poate evidenția textul alternativ lipsă împreună cu alte avertismente de creație, astfel încât problema este vizibilă în timp ce sursa este încă ușor de remediat.
De ce lipsește textul alternativ se ascunde în Markdown
Sintaxa imaginii Markdown arată astfel:
Când descrierea lipsește, imaginea poate în continuare redată:
Acest lucru face ca problema să fie ușor de ratat în timpul unei scanări vizuale. Pagina poate părea bine pentru autor, dar sursa a pierdut contextul util pentru cititorii care depind de alternativele de text și pentru recenzorii care încearcă să înțeleagă rolul imaginii.
Verificați imaginile în timpul trecerii de previzualizare
Un flux de lucru practic pentru documente ar trebui să includă un pas de examinare axat pe imagine:
- Lipiți Markdown-ul în Markdown Validator.
- Examinați previzualizarea redată pentru a confirma că apare imaginea.
- Citiți lista de avertismente pentru lipsa textului alternativ.
- Reveniți la sursă și scrieți o descriere concisă care explică scopul imaginii.
- Verificați din nou documentul înainte de a-l publica sau de a le efectua.
Acest lucru este mai rapid decât așteptarea ca un examinator să detecteze problema într-o cerere de extragere sau într-o pagină publicată.
Un text alternativ bun depinde de context
Textul alternativ ar trebui să descrie de ce este importantă imaginea în document. O captură de ecran a unui validator CSV nu are nevoie de fiecare pixel vizibil descris. Poate fi necesar să spună că validatorul afișează avertismente de antet duplicat sau o previzualizare analizată a rândurilor importate.
Cea mai bună descriere depinde de textul din jur. Dacă paragraful explică deja pe deplin imaginea, textul alternativ poate fi scurt. Dacă imaginea conține informații noi, textul alternativ ar trebui să contribuie la păstrarea acelei informații.
Asociați verificările alternative cu un QA Markdown mai amplu
Lipsa textului alternativ este una dintre problemele de creație. O trecere bună de previzualizare ar trebui să verifice, de asemenea, structura titlurilor, legăturile, tabelele și gardurile de cod.
Pentru un flux de lucru mai larg, citiți Cum să detectați problemele de reducere înainte de publicare. Pentru evaluarea în echipă, utilizați Cum pot revizui echipele de produse și documente Markdown fără a pierde formatarea.
Deschideți Markdown Validator înainte de a publica Markdown când capturile de ecran sau diagramele fac parte din document.
