diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2022-06-24 11:15:53 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2022-06-24 11:15:53 +0000 |
commit | 775d26d8d971fc94e1220bd3c8f87e4a1409a2ca (patch) | |
tree | 32a9a794f2256527eabce00439cb226c70a6e996 /mandoc_html.3 | |
parent | 57d5a8a3f3e52ca15b81371ea3b38c3124a45ec4 (diff) | |
download | mandoc-775d26d8d971fc94e1220bd3c8f87e4a1409a2ca.tar.gz mandoc-775d26d8d971fc94e1220bd3c8f87e4a1409a2ca.tar.zst mandoc-775d26d8d971fc94e1220bd3c8f87e4a1409a2ca.zip |
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.
Diffstat (limited to 'mandoc_html.3')
-rw-r--r-- | mandoc_html.3 | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/mandoc_html.3 b/mandoc_html.3 index a77d0e04..a7c8d796 100644 --- a/mandoc_html.3 +++ b/mandoc_html.3 @@ -1,4 +1,4 @@ -.\" $Id: mandoc_html.3,v 1.23 2020/04/24 13:13:06 schwarze Exp $ +.\" $Id: mandoc_html.3,v 1.24 2022/06/24 11:15:53 schwarze Exp $ .\" .\" Copyright (c) 2014, 2017, 2018 Ingo Schwarze <schwarze@openbsd.org> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: April 24 2020 $ +.Dd $Mdocdate: June 24 2022 $ .Dt MANDOC_HTML 3 .Os .Sh NAME @@ -221,6 +221,10 @@ option. Print an .Cm id attribute. +.It Cm r +Print an ARIA +.Cm role +attribute. .It Cm \&? Print an arbitrary attribute. This format letter requires two |