Oxygen XML Author plugin 13.2.0

Predefined Document Types | 137Dragging a file from the Project view or from the DITA Maps Manager view and dropping it into a DocBook 4 documentthat is edited in Author mode creates a link to the dragged file (the ulink DocBook element) at the drop location.Dragging an image file from the default file system application (Windows Explorer on Windows or Finder on Mac OSX, for example) and dropping it into a DocBook 4 document inserts an image element (the inlinegraphic DocBookelement with the fileref attribute) with the location of the dragged file at the drop location (similar with the InsertGraphic toolbar action).Transformation ScenariosDefault transformation scenarios allow you to convert DocBook 4 to DocBook 5 documents and transform DocBookdocuments to HTML, HTML Chunk, PDF, XHTML, XHTML Chunk, WebHelp (experimental) and EPUB.TemplatesDefault templates are available in the New File wizard and can be used for easily creating a skeletal form of a DocBook4 book or article. These templates are stored in the ${frameworks}/docbook/templates/DocBook 4 folder.Here are some of the DocBook 4 templates available when creating new documents from templates.• Article• Article with MathML• Article with SVG• Article with XInclude• Book• Book with XIncludeInserting olink Links in Docbook DocumentsAn olink is a type of link between two Docbook XML documents.The olink element is the equivalent for linking outside the current Docbook document. It has the attribute targetdocfor the document ID that contains the target element and the attribute targetptr for the ID (the value of an id orxml:id attribute) of the target element. The combination of those two attributes provides a unique identifier to locatecross references.For example, the Administrator Guide is a book with the document ID MailAdminGuide and it contains a chapterabout user accounts like the following:Administering User Accountsblah blah...You can form a cross reference to that chapter by adding an olink in the User Guide like the following:You may need to update youruser accountswhen you get a new machine.1. Decide what documents are included in the domain for cross referencing.An ID should be assigned to each document that will be referenced with an olink. Usually it is added as an id orxml:id attribute to the root element of the document. A document ID is a string that is unique for each documentin your collection. For example the documentation may include a user's guide, an administrator's guide, and a referencedocument. These could have simple IDs like ug, ag, and ref or more specific IDs like MailUserGuide,MailAdminGuide, and MailReference.2. Decide the output hierarchy.For creating links between documents, the relative locations of the output documents must be known. Generally theHTML files for multiple documents are output to different directories if chunking is used. Before going further youmust decide the names and locations of the HTML output directories for all the documents from the domain. Each