Πώς οι τεχνικοί συγγραφείς μπορούν να βρουν εναλλακτικό κείμενο που λείπει στο Markdown

Το εναλλακτικό κείμενο που λείπει είναι εύκολο να παραβλεφθεί στο Markdown, επειδή η πηγή μπορεί να φαίνεται ολοκληρωμένη. Η σύνταξη της εικόνας υπάρχει, η διαδρομή του αρχείου υπάρχει και το έγγραφο μπορεί να αποδοθεί με ορατό το στιγμιότυπο οθόνης. Το μέρος που λείπει είναι το κείμενο μέσα στις αγκύλες.

Οι τεχνικοί συγγραφείς θα πρέπει να το πιάσουν αυτό πριν το δημοσιεύσουν. Το Markdown Validator της Converty μπορεί να εμφανίσει το εναλλακτικό κείμενο που λείπει μαζί με άλλες προειδοποιήσεις συγγραφής, επομένως το πρόβλημα είναι ορατό όσο η πηγή εξακολουθεί να είναι εύκολο να διορθωθεί.

Γιατί λείπει το εναλλακτικό κείμενο κρύβεται στο Markdown

Η σύνταξη εικόνας Markdown μοιάζει με αυτό:

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

Όταν λείπει η περιγραφή, η εικόνα μπορεί να αποδοθεί:

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

Αυτό καθιστά εύκολο να χαθεί το ζήτημα κατά τη διάρκεια μιας οπτικής σάρωσης. Η σελίδα μπορεί να φαίνεται ωραία στον συγγραφέα, αλλά η πηγή έχει χάσει το χρήσιμο πλαίσιο για τους αναγνώστες που εξαρτώνται από εναλλακτικές λύσεις κειμένου και για τους αναθεωρητές που προσπαθούν να κατανοήσουν τον ρόλο της εικόνας.

Ελέγξτε τις εικόνες κατά τη διάρκεια του πάσου προεπισκόπησης

Μια πρακτική ροή εργασίας εγγράφων θα πρέπει να περιλαμβάνει ένα βήμα ανασκόπησης εστιασμένη στην εικόνα:

1. Επικολλήστε το Markdown στο Markdown Validator.
2. Ελέγξτε την προεπισκόπηση της απόδοσης για να επιβεβαιώσετε ότι εμφανίζεται η εικόνα.
3. Διαβάστε τη λίστα προειδοποιήσεων για λείπει εναλλακτικό κείμενο.
4. Επιστρέψτε στην πηγή και γράψτε μια συνοπτική περιγραφή που να εξηγεί τον σκοπό της εικόνας.
5. Ελέγξτε ξανά το έγγραφο πριν από τη δημοσίευση ή τη δέσμευση.

Αυτό είναι πιο γρήγορο από το να περιμένετε έναν αναθεωρητή να εντοπίσει το ζήτημα σε ένα αίτημα έλξης ή μια δημοσιευμένη σελίδα.

Το καλό εναλλακτικό κείμενο εξαρτάται από το περιβάλλον

Το εναλλακτικό κείμενο πρέπει να περιγράφει γιατί η εικόνα έχει σημασία στο έγγραφο. Ένα στιγμιότυπο οθόνης ενός εργαλείου επικύρωσης CSV δεν χρειάζεται κάθε ορατό pixel που περιγράφεται. Ίσως χρειαστεί να πούμε ότι το εργαλείο επικύρωσης εμφανίζει διπλότυπες προειδοποιήσεις κεφαλίδας ή μια αναλυμένη προεπισκόπηση εισαγόμενων σειρών.

Η καλύτερη περιγραφή εξαρτάται από το περιβάλλον κείμενο. Εάν η παράγραφος εξηγεί ήδη πλήρως την εικόνα, το εναλλακτικό κείμενο μπορεί να είναι σύντομο. Εάν η εικόνα φέρει νέες πληροφορίες, το εναλλακτικό κείμενο θα βοηθήσει στη διατήρηση αυτών των πληροφοριών.

Συνδυάστε ελέγχους alt με ευρύτερο Markdown QA

Η έλλειψη εναλλακτικού κειμένου είναι ένα θέμα συγγραφής μεταξύ πολλών. Ένα καλό πάσο προεπισκόπησης θα πρέπει επίσης να ελέγχει τη δομή επικεφαλίδων, τους συνδέσμους, τους πίνακες και τις περιφράξεις κώδικα.

Για την ευρύτερη ροή εργασιών, διαβάστε το How to Catch Markdown Issues Before Publishing. Για ομαδικό έλεγχο, χρησιμοποιήστε το Πώς οι ομάδες προϊόντων και εγγράφων μπορούν να αξιολογήσουν το Markdown Without Losing Formatting.

Ανοίξτε το Markdown Validator πριν δημοσιεύσετε το Markdown όταν τα στιγμιότυπα οθόνης ή τα διαγράμματα αποτελούν μέρος του εγγράφου.