]> git.cameronkatri.com Git - mandoc.git/commit
Improve accessibility of -T html -O toc output by using the <nav> element
authorIngo Schwarze <schwarze@openbsd.org>
Fri, 24 Jun 2022 11:15:53 +0000 (11:15 +0000)
committerIngo Schwarze <schwarze@openbsd.org>
Fri, 24 Jun 2022 11:15:53 +0000 (11:15 +0000)
commit775d26d8d971fc94e1220bd3c8f87e4a1409a2ca
tree32a9a794f2256527eabce00439cb226c70a6e996
parent57d5a8a3f3e52ca15b81371ea3b38c3124a45ec4
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.
html.c
html.h
mandoc_html.3
mdoc_html.c