← Prev in month ← Prev in thread

Allowing metadata to precede title in 13097 troubleshooting section specializations

From
Bob Thomas <>
Date
2013-12-21T16:48:35+00:00
ID
CAORtF5bao-6rjr=
Thread
Allowing metadata to precede title in 13097 troubleshooting section specializations
Hi,

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:

Current:

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

  "(((%indexterm;)*, (%title;))?,
   (%basic.block; |

   %data.elements.incl; |

   %foreign.unknown.incl; |

   %sectiondiv; |

   %txt.incl;)*)

  "

>

Proposed:

<!ENTITY % section.blocks.only.cnt 

  "(((%data.elements.incl; | %foreign.unknown.incl; |

      %indexterm; | %indextermref;)*, (%title;))?,

    (%basic.block; |
    %data.elements.incl; |
    %foreign.unknown.incl; |

    %sectiondiv; |
    %txt.incl;)*)
  "

>

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

Best Regards,
-- 
Bob Thomas

+1 720 201 8260

Skype: bob.thomas.colorado

Instant messaging: Gmail chat () or Skype

Time zone: Mountain (GMT-7)
← Prev in month ← Prev in thread