I actually want to create links to other documents, but I don't want a modular document. In reading the information on olinks it sounded like I still needed to use XInclude statements.
Here's what I want to do. Document A is a user interface guide that describes how certain program features should look. Document B is a specification for a certain piece of the program. Instead of rehashing what's covered in doc A, I want to reference it in doc B, and provide a link to that particular feature in doc A. Is that possible? -----Original Message----- From: Hussein Shafie [mailto:[email protected]] Sent: Thursday, January 13, 2011 3:59 AM To: Auslynn Jack Cc: '[email protected]' Subject: Re: [XXE] Adding links to external docs in DocBook v5 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. -- XMLmind XML Editor Support List [email protected] http://www.xmlmind.com/mailman/listinfo/xmleditor-support
