Re: Ditafile with referenced content

Hussein Shafie <[email protected]> Fri, 17 Dec 2021 21:10:58 +0100
Newsgroups gmane.editors.xxe.general
Message-ID <[email protected]>
Melanie A. wrote:
> 
> I'm working with XMLMind XML Editor Professional Edition 9.5.0.
> 
> When I create a ditafile with referenced content as topicref on my ditamap and create a navtitle with locktitle=yes on the topicref, then the navtitle is not taken over when I'm converting the ditamap.

Yes. See below.



> 
> The problem only occurs if the topicref is a ditafile with referenced content.
> 
>  

Not sure to understand  "the topicref is a ditafile with referenced 
content".

In our tests, the problem occurs in all cases. A <navtitle> 
locktitle="yes" is rarely taken into account. See below.



> 
> The same problem occurs with XML Editor Professional Edition 10.0.0.
> 

That's right.



> 
> Is this a bug or is this intentional?
> 

This is intentional but on the other hand, may be this a bug. That is, 
may be we have misunderstood the DITA specification.

It's all about the exact meaning of <navtitle> (or similarly attribute 
@navtitle).

See 
http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part2-tech-content/langRef/base/navtitle.html#navtitle 


The spec says:
---
This navigation title might differ from the first level heading that 
shows in the main browser window. Use <navtitle> when the actual title 
of the topic isn't appropriate for use in a table of contents, 
navigation pane, or online content (for example, because the actual 
title is too long).
---

We currently interpret this spec very strictly and use a <navtitle> 
locktitle="yes" only in the generated table of content of multi-page 
HTML, Web Help, etc, (and also in some of the navigation links often 
found in such pages).

A <navtitle> locktitle="yes" is ignored when generating PDF, RTF, DOCX, 
etc, as there is no concept of "navigation title" in such formats.

May be this is not the intended use of a <navtitle> locktitle="yes". We 
are not 100% sure as we are not the authors of the DITA spec.




--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support