Прескочи на главни садржај

Како технички писци могу пронаћи алтернативни текст који недостаје у Маркдовну

Аутор: Converty Team

Сазнајте како технички писци могу пронаћи алтернативни текст који недостаје у Маркдовн-у пре него што се објаве документи, РЕАДМЕ датотеке, белешке о издању или ЦМС садржај.

Како технички писци могу пронаћи алтернативни текст који недостаје у Маркдовну

Недостајући алтернативни текст је лако превидети у Маркдовну јер извор и даље може изгледати комплетан. Синтакса слике је присутна, путања датотеке је присутна и документ се може приказати са видљивим снимком екрана. Део који недостаје је текст унутар заграда.

Технички писци би то требали схватити прије објављивања. Цонверти-јев Маркдовн Валидатор може да прикаже алтернативни текст који недостаје заједно са другим ауторским упозорењима, тако да је проблем видљив док је извор још увек лако поправити.

Зашто се алтернативни текст који недостаје крије у Маркдовну

Синтакса Маркдовн слике изгледа овако:

![Useful description](/path/to/image.png)

Када опис недостаје, слика и даље може да прикаже:

![](/path/to/image.png)

Због тога је проблем лако пропустити током визуелног скенирања. Аутору страница може изгледати добро, али извор је изгубио користан контекст за читаоце који зависе од алтернатива текста и за рецензенте који покушавају да схвате улогу слике.

Проверите слике током прегледа

Практични ток рада докумената треба да садржи један корак прегледа фокусиран на слику:

  1. Налепите Маркдовн у Маркдовн Валидатор.
  2. Прегледајте приказани преглед да бисте потврдили да се слика појављује.
  3. Прочитајте листу упозорења за недостајући алтернативни текст.
  4. Вратите се извору и напишите сажет опис који објашњава сврху слике.
  5. Поново проверите документ пре објављивања или обавезивања.

Ово је брже од чекања да рецензент ухвати проблем у захтеву за повлачење или објављеној страници.

Добар алтернативни текст зависи од контекста

Алтернативни текст треба да описује зашто је слика важна у документу. Снимку екрана ЦСВ валидатора није потребан сваки описани видљиви пиксел. Можда ће морати да се каже да валидатор приказује дуплирана упозорења заглавља или рашчлањени преглед увезених редова.

Најбољи опис зависи од околног текста. Ако пасус већ у потпуности објашњава слику, алтернативни текст може бити кратак. Ако слика носи нове информације, алтернативни текст би требало да помогне у очувању тих информација.

Упарите алт провере са ширим Маркдовн КА

Недостатак алтернативног текста је један од неколико ауторских проблема. Добар пролаз за преглед такође треба да провери структуру наслова, везе, табеле и ограде кода.

За шири ток посла прочитајте Како ухватити проблеме са смањењем вредности пре објављивања. За тимски преглед користите Како тимови за производе и документе могу да прегледају маркдовн без губитка форматирања.

Отворите Маркдовн Валидатор пре него што објавите Маркдовн када су снимци екрана или дијаграми део документа.

Можда ће вам се свидети