If
locktitle = "no" or is unspecified, I don't believe the processor is
expected to use other criteria to determine whether or not to use the navtitle in
the map. My understanding is that in this case, the processor is supposed to ignore
any navtitle in the map.
We
can't change the behaviour until DITA 2.0 at the earliest, but currently everything
about this attribute is un-intuitive.
Su-Laine
Su-Laine Yeo
Solutions
Consultant
JustSystems
Canada, Inc.
Office:
778-327-6356
syeo@justsystems.com
www.justsystems.com
XMetaL Community Forums: http://forums.xmetal.com/
From: Bruce Nevin (bnevin)
[mailto:bnevin@cisco.com]
Sent: Wednesday, September 01, 2010 8:55 AM
To: dita@lists.oasis-open.org
Subject: RE: [dita] Clarification needed on @locktitle behaviour
I don't know where I was looking, that I couldn't see the default.
Weird.
The purpose of @locktitle is to compel the processor to use the
navtitle. By default (when locktitle="no"), the processor uses other
criteria to determine whether or not to use the navtitle if it is present.
So we talk about what those other criteria might be?
If locktitle="yes" but there is no navtitle specified, do
we leave it up to the implementer to decide whether to ignore it or report a
user error?
/B
From: Doug Morrison
[mailto:dmorrison@dita4all.com]
Sent: Friday, August 27, 2010 5:08 PM
To: dita@lists.oasis-open.org
Subject: Re: [dita] Clarification needed on @locktitle behaviour
On 27/08/2010 16:41, Bruce Nevin (bnevin) wrote:
I assume the default value for @locktitle is "yes". (I
see #IMPLIED in the description but I don't see the default value stated.)
The default value for @locktitle is "no". To quote from its
description in http://docs.oasis-open.org/dita/v1.2/cd03/spec/common/topicref-atts.html
:
This attribute makes sure the navtitle element or attribute is used if it is
present. If locktitle isn't set to "yes", the navtitle is ignored and text is retrieved
from the target.
I.e. if you want to use a navtitle you have to explicitly set locktitle to
"yes" - hence its default, implied value must be "no".
Regards,
Doug Morrison
Information Architect
http://dita4all.com