{% if description %}{% endif %} {% include "_doc_styles.html" %} {% if mathjax %} {% endif %} {% if has_draft_alts %}
Author note: Some image descriptions below are still automated drafts. Review and rewrite each one to convey the image's purpose before publishing this guide to end users.
{% endif %} {% if (segments | selectattr('include') | list | length) > 1 %} {% endif %}
{# Only sections the editor left included are published. An excluded section carries over neither to the body nor the table of contents. #} {% for seg in segments if seg.include %}

{{ seg.section_title }}

{% if not seg.untimed %}

–

{% endif %} {# Per-element include flags decide what carries over. A scene description (when present AND included) is the long-form image description, so the drops to "" — screen readers skip the image and read the description in body text. Alt-text is only emitted when its own include flag is on AND no description is carrying the meaning. We never add role="presentation" — alt="" alone is the WAI-recommended decorative pattern. #} {% set show_description = seg.description and seg.description.strip() and seg.description_included %} {% set show_alt = seg.alt_text_included and not show_description %} {% set img_alt = seg.alt_draft if show_alt else '' %} {% set draft_attr = ' data-alt-draft="true"' if (show_alt and not seg.alt_text_reviewed) else '' %}
{% if inline_images and seg.image_data_uri %} {{ img_alt }} {% else %} {{ img_alt }} {% endif %} {% if show_alt and not seg.alt_text_reviewed %}
Alt-text needs author review.
{% endif %}
{# Scene description — open paragraph(s) below the figure that serve as the long-form image description for everyone. #} {% if show_description %}
{% for para in seg.description.split('\n\n') if para.strip() %}

{{ para.strip() }}

{% endfor %}
{% endif %} {% if seg.ocr_text and seg.on_screen_text_included %} {# No aria-label on the
: the is the accessible name. Adding aria-label would either override the summary (inconsistent visual/AT names — WCAG 2.5.3 violation) or just duplicate it. #}
On-screen text from video
{{ seg.ocr_text|format_ocr }}
{% endif %} {% set show_transcript = seg.narration and seg.transcript_included %} {% if seg.audio_included and (seg.audio_data_uri or seg.audio_filename) %} {% set audio_label = 'Narration audio for ' ~ seg.section_title ~ ' at ' ~ (seg.start_seconds | timestamp) %} {# Only reference the transcript via aria-describedby when it's actually rendered. A dangling describedby is an ARIA validity bug (WCAG 4.1.2 / 1.3.1) some screen readers silently swallow. #} {% set audio_describedby = ' aria-describedby="narration-' ~ seg.index ~ '"' if show_transcript else '' %} {% if seg.audio_data_uri %} {% else %} {% endif %} {% endif %} {% if show_transcript %} {# Transcript — collapsed by default. The labels the block for AT, replacing the prior sr-only

. The narration body keeps a stable id so the section's

{% endfor %}