Re: [docbook-apps] Supporting WAI-ARIA specification

["Bob Stayton" <bobs@sagehill.net>]

Hi Robert,

I don't have any experience implementing WAI-ARIA conformance, but I can tell you what would need customization to replace <dl> lists.

 

For TOCs, you can reset the value of two params:

 

<xsl:param name="toc.list.type">div</xsl:param>

<xsl:param name="toc.listitem.type">div</xsl:param>

 

For indices, you will need to modify the XSL templates.  There are three indexing methods available in the stylesheet, and they use different templates.  See this reference for the list of methods:

 

http://docbook.sourceforge.net/release/xsl/current/doc/html/index.method.html

 

If you did not set this param, then you are getting the 'basic' index method.  Those templates are in xhtml/autoidx.xsl.  You will need to search through that file, copy any templates that make use of dl, dt, or dd to your customization layer, and change the element names to div, perhaps with class attributes.

 

The formatting of glossary and qandaset also uses dl, and those templates are in glossary.xsl and qandaset.xsl, respectively.

 

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

 

 

----- Original Message -----

From: robert

To: docbook-apps@lists.oasis-open.org

Sent: Tuesday, June 26, 2012 5:23 AM

Subject: [docbook-apps] Supporting WAI-ARIA specification

Hi,

I'm using DocBook XSL stylesheets to generate XHTML files. Those must conform to the WAI-ARIA specification. I've noticed that by default HTML files output by the DB XSL violate the specification. For example, the specification forbids the use of list elements for formatting and DB XSL use <dl><dt></dt></dl> constructs for index files and TOCs.

I have two questions. The first one is very general. Has any of you have any experience with implementing support for WAI-ARIA in DB XSL? If so, could you please share your experience?

Second question is technical. Where/what should I modify to fix the issue mentioned above, i.e. change the rendering of indecies and TOCs from <dl><dt></dt></dl> to <ul><li></li></ul> for example?

Thanks

Robert