Improve accessibility of -T html -O toc output by using the <nav> element
authorschwarze <schwarze@openbsd.org>
Fri, 24 Jun 2022 11:15:19 +0000 (11:15 +0000)
committerschwarze <schwarze@openbsd.org>
Fri, 24 Jun 2022 11:15:19 +0000 (11:15 +0000)
commit88e033f9985d9aec739c4497f51fb9348247d4db
treef6413e2c39dd4f397c5f07956b9388b72aeb661d
parent6cd7ecd829033adcb05d5d83db0e956615a384a9
Improve accessibility of -T html -O toc output by using the <nav> element
in the DPUB-ARIA doc-toc role.
Patch from Anna Vyalkova <cyber at sysrq dot in> slightly tweaked by me.

This is hopefully the start of a collaboration to improve accessibility
of Unix manual pages using the WAI-ARIA, HTML-ARIA, and DPUB-ARIA standards.
Progress appears to be possible without changing *anything* with respect to
the way manual pages are written.  Instead, it seems sufficient to properly
translate semantic cues already implied by existing mdoc(7) markup into the
appropriate HTML elements and ARIA attributes.  Overall, the total length
of HTML output is likely to increase slightly, but not much.
usr.bin/mandoc/html.c
usr.bin/mandoc/html.h
usr.bin/mandoc/mdoc_html.c