[PATCH 2/8] mdoc_html: Add DPUB-ARIA roles to sections

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

---
 html.h                             | 26 ++++++++++++++++++++++++++
 mdoc_html.c                        |  5 +++--
 regress/mdoc/Er/tag.out_html       |  2 +-
 regress/mdoc/Rs/paragraph.out_html |  2 +-
 regress/mdoc/Sh/paragraph.out_html |  2 +-
 regress/mdoc/Sh/tag.out_html       |  8 ++++----
 regress/mdoc/Tg/warn.out_html      |  2 +-
 7 files changed, 37 insertions(+), 10 deletions(-)

diff --git a/html.h b/html.h
index 5e2adc06..dc4febf2 100644
--- a/html.h
+++ b/html.h
@@ -74,6 +74,32 @@ enum	htmltag {
 	TAG_MAX
 };
 
+static	const char * const dpubroles[SEC__MAX] = {
+	NULL,			/* SEC_NONE */
+	"doc-abstract",		/* SEC_NAME */
+	"doc-abstract",		/* SEC_LIBRARY */
+	"doc-part",		/* SEC_SYNOPSIS */
+	"doc-part",		/* SEC_DESCRIPTION */
+	"doc-part",		/* SEC_CONTEXT */
+	"doc-part",		/* SEC_IMPLEMENTATION */
+	"doc-part",		/* SEC_RETURN_VALUES */
+	"doc-part",		/* SEC_ENVIRONMENT */
+	"doc-part",		/* SEC_FILES */
+	"doc-part",		/* SEC_EXIT_STATUS */
+	"doc-example",		/* SEC_EXAMPLES */
+	"doc-part",		/* SEC_DIAGNOSTICS */
+	"doc-part",		/* SEC_COMPATIBILITY */
+	"doc-part",		/* SEC_ERRORS */
+	"doc-part",		/* SEC_SEE_ALSO */
+	"doc-part",		/* SEC_STANDARDS */
+	"doc-part",		/* SEC_HISTORY */
+	"doc-aknowledgments",	/* SEC_AUTHORS */
+	"doc-part",		/* SEC_CAVEATS */
+	"doc-part",		/* SEC_BUGS */
+	"doc-part",		/* SEC_SECURITY */
+	"doc-part",		/* SEC_CUSTOM */
+};
+
 struct	tag {
 	struct tag	 *next;
 	int		  refcnt;
diff --git a/mdoc_html.c b/mdoc_html.c
index d85df753..31cfaac2 100644
--- a/mdoc_html.c
+++ b/mdoc_html.c
@@ -525,7 +525,8 @@ mdoc_sh_pre(MDOC_ARGS)
 		if ((h->oflags & HTML_TOC) == 0 ||
 		    h->flags & HTML_TOCDONE ||
 		    n->sec <= SEC_SYNOPSIS) {
-			print_otag(h, TAG_SECTION, "c", "Sh");
+			print_otag(h, TAG_SECTION, "cr",
+			    "Sh", dpubroles[n->sec]);
 			break;
 		}
 		h->flags |= HTML_TOCDONE;
@@ -570,7 +571,7 @@ mdoc_sh_pre(MDOC_ARGS)
 		}
 		print_tagq(h, t);
 		print_tagq(h, tnav);
-		print_otag(h, TAG_SECTION, "c", "Sh");
+		print_otag(h, TAG_SECTION, "cr", "Sh", dpubroles[n->sec]);
 		break;
 	case ROFFT_HEAD:
 		print_otag_id(h, TAG_H1, "Sh", n);
diff --git a/regress/mdoc/Er/tag.out_html b/regress/mdoc/Er/tag.out_html
index 80daa28b..276bf29b 100644
--- a/regress/mdoc/Er/tag.out_html
+++ b/regress/mdoc/Er/tag.out_html
@@ -4,7 +4,7 @@
 </dl>
 <a class="permalink" href="#two"><code class="Er" id="two">two</code></a>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-part">
 <h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
 <dl class="Bl-tag">
   <dt id="ENOENT">[<a class="permalink" href="#ENOENT"><code class="Er">ENOENT</code></a>]</dt>
diff --git a/regress/mdoc/Rs/paragraph.out_html b/regress/mdoc/Rs/paragraph.out_html
index bfb0a724..9c197182 100644
--- a/regress/mdoc/Rs/paragraph.out_html
+++ b/regress/mdoc/Rs/paragraph.out_html
@@ -4,7 +4,7 @@
 <p class="Pp">in a paragraph: <cite class="Rs"><span class="RsA">another
     author</span>, <i class="RsB">another book</i>.</cite></p>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-part">
 <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
   ALSO</a></h1>
 <p class="Pp">initial reference:</p>
diff --git a/regress/mdoc/Sh/paragraph.out_html b/regress/mdoc/Sh/paragraph.out_html
index 82ede5be..604153cd 100644
--- a/regress/mdoc/Sh/paragraph.out_html
+++ b/regress/mdoc/Sh/paragraph.out_html
@@ -5,5 +5,5 @@
 <p class="Pp">subsection paragraph</p>
 </section>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-example">
 <h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
diff --git a/regress/mdoc/Sh/tag.out_html b/regress/mdoc/Sh/tag.out_html
index 0dd39398..88f65803 100644
--- a/regress/mdoc/Sh/tag.out_html
+++ b/regress/mdoc/Sh/tag.out_html
@@ -1,11 +1,11 @@
 <p class="Pp">Text in the subsection.</p>
 </section>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-part">
 <h1 class="Sh" id="DESCRIPTION~2"><a class="permalink" href="#DESCRIPTION~2">DESCRIPTION</a></h1>
 <p class="Pp">Text in duplicate description section.</p>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-example">
 <h1 class="Sh" id="examples"><a class="permalink" href="#examples">EXAMPLES</a></h1>
 <p class="Pp">Text introducing examples.</p>
 <section class="Ss">
@@ -17,11 +17,11 @@
 <p class="Pp">More example text.</p>
 </section>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-part">
 <h1 class="Sh" id="WEIRD_SECTION"><a class="permalink" href="#WEIRD_SECTION">	
   WEIRD SECTION	 </a></h1>
 <p class="Pp">Text in weird section.</p>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-part">
 <h1 class="Sh">&#x00A0;</h1>
 <p class="Pp">Text in section with empty header.</p>
diff --git a/regress/mdoc/Tg/warn.out_html b/regress/mdoc/Tg/warn.out_html
index a7f92574..7c7d7943 100644
--- a/regress/mdoc/Tg/warn.out_html
+++ b/regress/mdoc/Tg/warn.out_html
@@ -6,6 +6,6 @@
 <p class="Pp">subtext</p>
 </section>
 </section>
-<section class="Sh">
+<section class="Sh" role="doc-example">
 <h1 class="Sh" id="examples"><a class="permalink" href="#examples">EXAMPLES</a></h1>
 <p class="Pp">example text</p>
-- 
2.35.1

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