Re: [dita] Publishing <topichead>

[Robert D Anderson <robander@us.ibm.com>]

Hi Tarun,

A topichead does imply a container heading, so for a TOC this results in a
hierarchy change. The same is true of other topicref elements that specify
a title, but do not reference a topic; that is, <topichead
navtitle="Sample"/> with no other attributes is equivalent to <topicref
navtitle="Sample"/> with no other attributes.

Using the Example in the specification [1]:
<map>
  <topichead>
    <topicmeta><navtitle>Computers</navtitle></topicmeta>
    <topicref href="eniac.dita"/>
    <topicref href="system360.dita"/>
    <topicref href="pdp8.dita"/>
  </topichead>
  <topichead navtitle="Books">
    <topicref href="hardback.dita"/>
    <topicref href="paperback.dita"/>
  </topichead>
</map>

This would typically be rendered in a TOC as something like:
Computers
...ENIAC
...System/360
...PDP-8
Books
...Hard back books
...Paperback books

[1] http://docs.oasis-open.org/dita/v1.2/os/spec/langref/topichead.html

Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit

Tarun Garg <tarung@adobe.com> wrote on 01/25/2011 10:05:33 AM:

> From: Tarun Garg <tarung@adobe.com>
> To: dita <dita@lists.oasis-open.org>
> Date: 01/25/2011 10:20 AM
> Subject: [dita] Publishing <topichead>
>
> I am asking something very basic and I am not sure if this has been
> discussed earlier on this forum.
>
> While publishing, does <topichead> element imply a hierarchy change
> for the contained <topicref> elements ?
>
> Regards,
> Tarun Garg
>