[PATCH 1/8] mdoc_html: Accessibility markup for ToC

["Anna “CyberTailor”" <cyber@sysrq.in>]

1. Wrap ToC in the "<nav>" tag
2. Add "doc-toc" DPUB-ARIA role
---
 html.c      | 4 ++++
 html.h      | 1 +
 mdoc_html.c | 4 +++-
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/html.c b/html.c
index 65c31b64..4710bab7 100644
--- a/html.c
+++ b/html.c
@@ -110,6 +110,7 @@ static	const struct htmldata htmltags[TAG_MAX] = {
 	{"munderover",	0},
 	{"munder",	0},
 	{"mover",	0},
+	{"nav",		HTML_NLALL},
 };
 
 /* Avoid duplicate HTML id= attributes. */
@@ -708,6 +709,9 @@ print_otag(struct html *h, enum htmltag tag, const char *fmt, ...)
 		case 'i':
 			attr = "id";
 			break;
+		case 'r':
+			attr = "role";
+			break;
 		case '?':
 			attr = arg1;
 			arg1 = va_arg(ap, char *);
diff --git a/html.h b/html.h
index dda19b8a..5e2adc06 100644
--- a/html.h
+++ b/html.h
@@ -70,6 +70,7 @@ enum	htmltag {
 	TAG_MUNDEROVER,
 	TAG_MUNDER,
 	TAG_MOVER,
+	TAG_NAV,
 	TAG_MAX
 };
 
diff --git a/mdoc_html.c b/mdoc_html.c
index 2dde0531..d85df753 100644
--- a/mdoc_html.c
+++ b/mdoc_html.c
@@ -515,7 +515,7 @@ static int
 mdoc_sh_pre(MDOC_ARGS)
 {
 	struct roff_node	*sn, *subn;
-	struct tag		*t, *tsec, *tsub;
+	struct tag		*t, *tnav, *tsec, *tsub;
 	char			*id;
 	int			 sc;
 
@@ -536,6 +536,7 @@ mdoc_sh_pre(MDOC_ARGS)
 					break;
 		if (sc < 2)
 			break;
+		tnav = print_otag(h, TAG_NAV, "r", "doc-toc");
 		t = print_otag(h, TAG_H1, "c", "Sh");
 		print_text(h, "TABLE OF CONTENTS");
 		print_tagq(h, t);
@@ -568,6 +569,7 @@ mdoc_sh_pre(MDOC_ARGS)
 			print_tagq(h, tsec);
 		}
 		print_tagq(h, t);
+		print_tagq(h, tnav);
 		print_otag(h, TAG_SECTION, "c", "Sh");
 		break;
 	case ROFFT_HEAD:
-- 
2.35.1

--
 To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv