[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Errata in grammar files for <colspec>
I ... am not sure.
The reason to use colspec/@rowheaders is to indicate that the designated column is a header. For example, if you want the second (or last) column to be a header column, you'd set rowheaders="headers" on that column -- a way to say "This column is full of header cells". That's what the current language says, and the markup makes sense (provided we remove the default that currently turns every cell of every column into a header). That basically means that to make your table accessible, in order of complexity, you would:
Those two items have been available from DITA 1.0 and cover most tables that I've seen. For the exceptions, the following options are available in DITA 1.3:
Knowing only what you've said about the DocBook version - it sounds like in DocBook, the "headers" value is basically a way to say "I want to maintain this manually with id/headers attributes on every entry" - which we definitely don't want as the default in DITA.
Eliot Kimber ---09/27/2017 04:51:48 PM---I’m wondering if the text of the topic is actually what’s wrong. From: Eliot Kimber <ekimber@contrext.com> To: DITA Technical Committee <dita@lists.oasis-open.org> Date: 09/27/2017 04:51 PM Subject: Re: [dita] Errata in grammar files for <colspec> Sent by: <dita@lists.oasis-open.org> I’m wondering if the text of the topic is actually what’s wrong. Looking at the DocBook documentation for colspec, it says for @rowheader value “headers”: “Indicates that row headers are identified by use of the headers attribute on entries in the table.” Which is a sensible default (because it means that if @headers is not specified on entries there are no row headers for that column. However, DocBook 5.1 does not appear to define a default for @rowheader on <colspec>, so probably also correct to remove the default. I think the DITA text should match the DocBook text (assuming that we did not intend to change the meaning of “headers” in this context, which I wouldn’t think we intended). Cheers, E. -- Eliot Kimber http://contrext.com From: <dita@lists.oasis-open.org> on behalf of Robert D Anderson <robander@us.ibm.com> Date: Wednesday, September 27, 2017 at 3:53 PM To: DITA Technical Committee <dita@lists.oasis-open.org> Subject: [dita] Errata in grammar files for <colspec> I was trying out some of the accessibility features added for very complex tables. One of the features is the ability to set colspec/@rowheader="headers" -- doing so indicates that the specified column should be treated as a header for all entries in that row. This enhances the DITA 1.0 level support that just allowed you to designate the first column as a header column. Here's the description of that value from the spec topic:
Turns out the grammar files actually set this as a default, which is very clearly not the intent. This means every processor that gets a parsed version of a table will view every column as having this attribute ... thus every column is a header column. This occurs in all versions of the shipped grammar (RNG, DTD, XSD). It's clearly not the intent, based on the description in the spec and based on the fact that the results are nonsensical. We should fix this in the errata by removing the default value. Relevant spec topic: http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/langRef/attributes/calsTableAttributes.html#oet-atts__rowheader
--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_portal_my-5Fworkgroups.php&d=DwIBAg&c=jf_iaSHvJObTbx-siA1ZOg&r=eBihWDTS2oOizc2d2LrsewiOpn69Mu6rPwmmRMM_aAU&m=F9GBkOLT5WrvU9DblEcHQxRu9wH6_fn6EvK4by0lI1w&s=s0Ub0itoPmC99QZK7r77MgbT59T3nDEYtslhaySI6-Y&e= |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]