On 01/13/2011 02:24 PM, Auslynn Jack wrote: > 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? >
--> Yes, this is possible using olinks. More info about the olink facility here: http://www.sagehill.net/docbookxsl/Olinking.html Olinks are not related to XIncludes or to modular documents. An olink found in doc B, which references an element of doc A, looks like this: <olink targetdoc="SYMBOLIC_NAME_FOR_DOC_A" targetptr="ID_INSIDE_DOC_A"/> * If you have few olinks to create, you may create them by hand. That is, using the Edit tool and the Attributes tool. * If you have many olinks to create, then the Link tool will help you in doing that. The very first thing to do is to create by hand, using a text editor, a description of your document set. This short description looks like this: --- <documents xmlns="http://www.xmlmind.com/xmleditor/schema/olinked_docs";> <document name="guide" location="docA/docA.xml"/> <document name="spec" location="docB/docB.xml"/> </documents> --- Let's suppose that this description is found in "C:\docs\docset.xml". Then you need to: * Open docB.xml. * Select "olink" in the combobox found at the top of the Link tool. * Click [+] in the Link tool and specify "C:\docs\docset.xml" as the link context of docB.xml. >From now, the links you'll create in docB.xml using the Link tool will be properly initialized olinks. More info about the Link tool and olinks here: http://www.xmlmind.com/xmleditor/_distrib/doc/help/linkPane.html#olinked_docset --> Creating a set of documents containing olinks is relatively easy. The hard part is properly converting them to formats such as HTML, RTF, PDF. XMLmind XML Editor cannot help you in doing that. Therefore, unless you are or want to become a DocBook expert, I strongly discourage the use of olinks in your documents. However, if you insist on using olinks in your documents, then first carefully read http://www.sagehill.net/docbookxsl/Olinking.html and then, setup a tool chain which will be able to process such documents. -- XMLmind XML Editor Support List [email protected] http://www.xmlmind.com/mailman/listinfo/xmleditor-support
