On 21 May 2017, at 12:29, Hussein Shafie wrote:
On 05/21/2017 11:01 AM, Leif Halvard Silli wrote:
There is a couple of ID reference errors in Section 3 («What is an
assembly»)
<http://www.xmlmind.com/tutorials/DocBookAssemblies/index.html#what_is_assembly>
of «DocBook Assemblies and Topics for the Impatient»:
In the resource and module elements of the assembly document example
refer to topic elements with xml:id="topic1", xml:id="topic2" and
xml:id="topic3".
However, in the very topic file examples (as well as in the realized
document example), the word 'topic' is shortened to just 't',
resulting
in xml:id="t1", xml:id="t3" and xml:id="t3".
These are not typos.
This xml:id attributes used internally in an assembly like in:
---
<resource href="topic1.xml" xml:id="topic1"/>
<module resourceref="topic1"/>
---
are not related in any way to the xml:id attributes found in the
referenced topic files.
Hence a realized pseudo-document like:
---
<UNKNOWN xmlns="http://docbook.org/ns/docbook"; version="5.1">
<topic version="5.1" xml:base="file:/home/john/samples/topic1.xml"
xml:id="t1">
<info>
<title>Title of topic #1</title>
</info>
...
---
is OK. I mean, generating <topic...xml:id="topic1"> in the realized
document because of the IDs specified in the assembly would be an
error.
I see. Thanks. Sorry for being dense. I guess that makes sense, from
more than one angle. May be, in next version of the guide, you should
make some comments about this - to point out that there is no link ...
Btw, the separation between 'resource' and 'structure', that is found in
assemblies, seems to be an important difference, and advantage, over
DITA map files. It allows you to create a very 'semantic' assembly file,
where resources such as 'meaninglessGibberish.xml' can become
xml:id="TheMainSubject" in the assembly.
--
Leif Halvard Silli
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
