On 01/12/2011 10:31 PM, Auslynn Jack wrote: > This is a very basic question, and I apologize for that. I am very new > to the DocBook environment and am having a hard time getting a handle on > linking external documents. I’ve turned on the link editor. I’ve added > XInclude statements in the target doc. When I try to add the target doc > using the “add link context to list” icon, I get an error message that > says either the specified document does not reference the document being > edited or the document being edited does not contain any usable link > target. I’ve been to the DocBook site, I’ve been in the help file and I > can’t sort through it. Any assistance would be greatly appreciated! >
[[[My answer assumes that by "external document", you mean something like "Web resource". Example: "http://code.google.com/apis/maps/documentation/javascript/v2/reference.html";. If this is not the case, do no hesitate to ask your question again.]]] * XIncludes are not about links. XIncludes allow to create *modular* documents. Example: a book comprising many chapters, where the book element and the chapter elements are all found in different files. * To make it simple, the Link tool allows to create internal links and not external links. In DocBook v5, internal links look like this: <link linkend="TARGET_ID_HERE">BLAH BLAH BLAH</link> or like this: <xref linkend="TARGET_ID_HERE"/> Notice the linkend attribute. * In DocBook v5, external links look like this: <link xlink:href="http://www.xmlmind.com/xmleditor/";>XMLmind XML Editor</link> Notice the xlink:href attribute. I'll give you now two methods to insert such external links in a DocBook v5 document: ------------- First method: ------------- [1] Type "XMLmind XML Editor". [2] Select "XMLmind XML Editor". [3] Use the "underlined a" icon (see attached screenshot) found in the toolbar and select link[xlink:href] [4] Use the Attribute tool and give the value "http://www.xmlmind.com/xmleditor/"; to the attribute xlink:href. -------------- Second method: -------------- [1] Move the caret to the location where you want to insert the external link. [2] Press Ctrl-I (that is, menu item "Edit|Insert"). [3] Choose "link(href)" from the list displayed by the Edit tool. [4] Use the Attribute tool and give the value "http://www.xmlmind.com/xmleditor/"; to the attribute xlink:href. ----------- Useful tip: ----------- Instead of typing the value of attribute xlink:href, drag the URL from you Web browser and drop it in XMLmind XML Editor onto the <link> element.
<<attachment: underlined_a_icon.png>>
-- XMLmind XML Editor Support List [email protected] http://www.xmlmind.com/mailman/listinfo/xmleditor-support
