← Prev in month ← Prev in thread
Next in thread → Next in month →

subelement instead of translatable label attribute of <data> element?

From
Erik Hennum <>
Date
2006-07-07T15:15:01+00:00
ID
Thread
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

← Prev in month ← Prev in thread
Next in thread → Next in month →