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

From
Bob Stayton <>
Date
2012-06-26T16:55:38+00:00
ID
037201cd53bc$7e2bd010$6600a8c0@pazu
Thread
Re: [docbook-apps] Supporting WAI-ARIA specification
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


 

 

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

  
From: 
  robert 

  
To:  
  

  
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