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: Proposal 13007: New values for @toc attribute

Call for assistance coming...

This item is very low priority for me - I think I offered to look at it
because it seemed trivial, but even trivial items are difficult to fit in
right now.

Specifically, I believe that this was related to cascading values.
Currently, there is an expectation that setting toc="no" will cascade down
until it hits a topicref with toc="yes" -- effectively causing items in
that lower topicref to float up in the TOC. Likewise, toc="yes" will
cascade until it hits toc="no", without a way to override that lower
setting; this can be troublesome if referencing a nested map, such as the
<topicref href="parent" toc="yes">
  <topicref href="nested.ditamap" format="ditamap"/>

where nested.ditamap contains
  <topicref toc="no">...

In that case, there is no way for the outer map to force the TOC on in the
reused map.

The suggestion was to add values beyond yes/no for @toc, such as "always"
or "never", which forcibly override the values specified further down in
the cascade.

Is anybody else on the TC interested in helping out with a write-up of this
proposal? I'd still like to be involved in the review, but hoping for help
on the other bits.

The record we have of 13007 also suggests that the spec should explicitly
address how the yes/no values cascade, something that today is not
explicitly laid out in the spec (although I think the behavior is defined
as part of a general cascade definition). I think the stage 2 proposal will
probably need to address this explicit behavior, because it is so closely
intertwined with the always/never values; actual language for all of these
cascades would be needed in the stage 3 proposal.

Thanks -

Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit (http://dita-ot.sourceforge.net/)

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