On 12/04/2012 07:24 PM, Jeff Hooker wrote:
What's the recommended way of creating cross-references between DITA
topics or within topics. We're transitioning from Docbook to DITA, and
so far I can't find a way of creating xrefs that won't get me shelled
when I try to demo it to our user community.
There must be some solutions in place for this, but between Googling,
surfing the tutorials, and searching the Help, I've come up dry.
[1] Convert the text to an xref using the corresponding toolbar button.
[2] Use the topmost form found in the Attribute tool (keyboard shortcut
Ctrl-E) to specify the value of the href attribute.
The topmost form of the Attribute tool supports auto-completion for the
attribute name (href), as well as for the attribute value (something
like topic_id/element_id).
More information in
http://www.xmlmind.com/xmleditor/_distrib/doc/help/attributes_form.html
If you need your xref to point to an element found in another DITA topic
file, then make sure to first open the DITA map as a Document Set
(File|Document Set|Open Document Set).
More information in
http://www.xmlmind.com/xmleditor/_distrib/doc/help/documentSet_open.html
Tutorial about document sets:
http://www.xmlmind.com/xmleditor/_tutorial/document_set/index.html
When you'll do this, the auto-completion for the href attribute value
will suggest link targets (something like topic_id/element_id) found in
the current file, as well as link targets found in the other topic files
(something like file_name#topic_id/element_id).
This is demoed in this screencast:
http://www.xmlmind.com/xmleditor/_tutorial/document_set/video2/document_set2.html
The element used in the above demo is link and not xref, but it will
work exactly like this with xref too.
--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
