Niels Grundtvig Nielsen wrote: > Hope this is something I'll only need to learn once! >
We plan to add a tutorial to http://www.xmlmind.com/tutorials.html DITA for the impatient By reading it, you'll see that authoring DITA documents is quite easy. > 1. I wrote a number of DITA topics, and gave each one a unique ID in the > format [letter][five digit-number] > > 2. In topic o33790 [top-level topic id] I want to add an xref* to the > title of concept e91103. > > I've tried various approaches and not quite succeeded :-{ The following > looks the closest to doing what I want, but from DITA > Go to I see it's > ignoring both the filename and the type and setting up a link to the > title element of the current file: > > Insert > xref and specify the attributes href (picking the topic-file > from the Browse Files ... window inserts the filename), element id > "title" and type "concept" > > Various attempts to enter a "fully-qualified ID" as mentioned in the XML > Mind help fail, apparently because the / is not an acceptable character. > > Any tips on how to set up an xref correctly will be appreciated! > > [1] Add an id attribute to the title element of concept e91103. Let's suppose this id is "foo". [2] Insert an xref element in topic o33790. [3] Specify the *href* attribute of the xref element as follows: file_containing_the_concept#e91103/foo If topic o33790 and concept e91103 are contained in the same file (which is not recommended), please specify the href attribute of the xref element as follows: #e91103/foo Forget about the id and type attributes of xref. Such attributes are not useful. --> In a nutshell, it works like HTML's <a href=""> element pointing to a fragment (URL#target_ID or in some cases, simply #target_ID). The only difference is that * the ID of a topic is, as expected, the value of its id attribute; * the ID of any element contained inside a topic (or concept, reference, task, etc) is: id_of_its_topic_ancestor/value_of_its_id_attribute
