Re: [dita] Publishing <topichead>

[ian balanza-davis <ibalanza_davis@yahoo.co.uk>]

That may be possible, but is it desirable?

From the spec:
"The <topichead> element provides a title-only entry in a navigation map, which should appear as a heading when the map is rendered as a table of contents. In print contexts it should also appear as a heading in the rendered content."

"The <topicref> element identifies a topic (such as a concept, task, or reference) or other resource."

If those are accurate statements, it would seem to me (and I am happy to be corrected) that <topicref navtitle="sample"/>, while supported, should be expressed as <topichead navtitle.../>

It would also seem imply that @href should be mandatory on a topicref.

Ian

---

From: Robert D Anderson <robander@us.ibm.com>
To: Tarun Garg <tarung@adobe.com>
Cc: dita <dita@lists.oasis-open.org>
Sent: Tue, 25 January, 2011 10:19:06
Subject: Re: [dita] Publishing <topichead>

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
>


---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php