Please review Erik’s email before
the meeting on Monday. I’ve asked Erik to attend the meeting to explain,
if he is available.
JoAnn
JoAnn T. Hackos, PhD
President
Comtech Services, Inc.
710 Kipling Street, Suite 400
Denver, CO 80215
303-232-7586
joann.hackos@comtech-serv.com
joannhackos Skype
www.comtech-serv.com
From: Erik Hennum
[mailto:ehennum@us.ibm.com]
Sent: Friday, July 07, 2006 9:04
AM
To: dita@lists.oasis-open.org
Subject: [dita] subelement instead
of translatable label attribute of <data> element?
Hi,
Translation-Aware TC:
My colleague, Mike Temple, alerted me to a potential translation issue with
respect to the <data> element.
The current <data> element has a label attribute for providing a
human-readable title for the property. That's convenient for processing because
it can be defaulted but, of course, isn't optimal for translation.
I understand that we plan in DITA 1.2 to provide subelement equivalents for
every translatable attribute. In conformance with that impending policy, I'd
propose that, in DITA 1.1, the <data> element not have a label attribute
but instead have a <title> subelement (with processing aggregating one
<title> in output processing the same way as <section>).
In DTD syntax:
<!ELEMENT data (#PCDATA|%title;|%keyword;|%term;|%image;|%object;|%ph;|%data-about;|%data;)*>
<!ATTLIST data %univ-atts;
name CDATA #IMPLIED
datatype CDATA #IMPLIED
value CDATA #IMPLIED
href CDATA #IMPLIED
format CDATA #IMPLIED
type CDATA #IMPLIED
scope (local | peer | external)
#IMPLIED
outputclass CDATA #IMPLIED
>
In Schema syntax:
<xs:complexType
name="data.class" mixed="true">
<xs:choice minOccurs="0"
maxOccurs="unbounded">
<xs:group
ref="title"/>
<xs:group
ref="keyword"/>
<xs:group ref="term"/>
<xs:group
ref="image"/>
<xs:group
ref="object"/>
<xs:group ref="ph"/>
<xs:group
ref="data-about"/>
<xs:group
ref="data"/>
</xs:choice>
<xs:attributeGroup ref="univ-atts"/>
<xs:attribute name="name"
type="xs:string"/>
<xs:attribute name="datatype"
type="xs:string"/>
<xs:attribute name="value"
type="xs:string"/>
<xs:attribute name="href"
type="xs:string"/>
<xs:attribute name="format"
type="xs:string"/>
<xs:attribute name="type"
type="xs:string"/>
<xs:attribute name="scope"
type="scope-att.class"/>
<xs:attribute name="outputclass"
type="xs:string"/>
</xs:complexType>
Prior threads about the <data> element:
http://www.oasis-open.org/apps/org/workgroup/dita/download.php/14073/Issue9.html
http://www.oasis-open.org/apps/org/workgroup/dita/email/archives/200602/msg00083.html
http://www.oasis-open.org/apps/org/workgroup/dita/email/archives/200606/msg00072.html
Thanks,
Erik Hennum
ehennum@us.ibm.com