DITA and XMetaL Discussion
nlpharrison April 11, 2012 at 2:02 am
hrefs and ID strings truncated in generating XHTMLApril 11, 2012 at 2:02 amParticipants 0Replies 1Last Activity 10 years, 9 months ago
note – I'm running XMetal 6.0.
I'm generating XHTML (multiple files) and the @href values are being truncated and mangled.
For example, in my ditamap, I have an entry like this:
In the resulting .html file, I find:
- Electrical Characteristics and AC Operating Conditions
So 2 problems are there:
1. The processor seems to be treating the compound href – a combination of filename and topic @id string – as a single file name, instead of a compound href.
2. The actual topic @id value is being truncated
Can you suggest ways of avoiding these two problems? The one fix I can't make is simply using the filename as the @href value and leaving out the topic @id string; the corporate guidelines don't allow for that.
NancyDerek Read April 11, 2012 at 5:36 pm
Reply to: hrefs and ID strings truncated in generating XHTMLApril 11, 2012 at 5:36 pm
I can reproduce what you are seeing with both DITA OT version 188.8.131.52 (included with XMetaL Author Enterprise 6.0) and DITA OT version 1.5.4 (included with 7.0).
However, it isn't clear to me if this is really a bug in the DITA OT or whether it should even be supported. The DITA Language Reference is not entirely clear to me, as it states the following (see the text I've coloured blue):
A pointer to the resource represented by the
. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the format attribute to identify the kind of resource being referenced.
DITA 1.2 rewrites that paragraph, but that sentence is the same:
[quote=http://docs.oasis-open.org/dita/v1.2/os/spec/langref/topicref.html#topicref]A pointer to the resource represented by the
. See The href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the format attribute to identify the kind of resource being referenced.
See also [url=http://docs.oasis-open.org/dita/v1.2/os/spec/common/thehrefattribute.html]184.108.40.206 The href attribute[/url] (which does not clarify things for me).
The ambiguity for me stems from the fact that it is not clear what “topic level” means. If it means “the referenced topic file in its entirety” then the Language Reference is saying you can't reference any elements, including
, inside the file (as you are doing). However, if it is referring to the actual topic elements (anything with @class=”- topic/topic “) then what you are doing seems to be allowed and you should file a bug report here: http://sourceforge.net/tracker/?group_id=132728
- You must be logged in to reply to this topic.