OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [dita] Allowing metadata to precede title in 13097 troubleshooting section specializations

These seem minor adjustments that should be able to go along in the approved proposal.

JoAnn T. Hackos, PhD
Comtech Services Inc.
710 Kipling Street, Suite 400
Denver, CO 80215


Comtech Logo 2005 small

CIDM will be hosting the Content Management Strategies/DITA NA Conference 2014 in Seattle, Washington April 28-30. More information at:


From: Bob Thomas <bob.thomas@tagsmiths.com>
Date: Saturday, December 21, 2013 9:48 AM
To: dita <dita@lists.oasis-open.org>
Subject: [dita] Allowing metadata to precede title in 13097 troubleshooting section specializations


In a thread about example and section on the Yahoo DITA group, I offered the opinion that when mixed content is removed from the section model, title ought to be only available at the beginning of section preceded only by an optional indexterm. Jeremy Griffith pointed out that the data element ought to be allowed there as well for the same reasons as indexterm. In general, an optional mix of metadata markup needs to be allowed before title.

The timing for this realization is regrettable. My hope is that it is not too late to tweak the content models.

Here is a tentative list of elements that we should consider allowing to precede title:
  • data
  • data-about
  • foreign
  • indexterm
  • indextermref
  • unknown
I would be happy to have the TC argue away any of these elements. Failing that, I am advocating the following change to the DTD:


<!-- used in cause and condition -->
<!ENTITY % section.blocks.only.cnt 

  "(((%indexterm;)*, (%title;))?,
   (%basic.block; |
   %data.elements.incl; |
   %foreign.unknown.incl; |
   %sectiondiv; |


<!ENTITY % section.blocks.only.cnt
%data.elements.incl; | %foreign.unknown.incl; |
      %indexterm;%indextermref;)*, (%title;))?,
    (%basic.block; |
    %data.elements.incl; |
    %foreign.unknown.incl; |
    %sectiondiv; |

I also propose allowing the same mix to precede title in remedy.

Best Regards,
Bob Thomas
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]