24.08.2015 Views

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>Author</strong> for DITA | 128The CSS styles in which the elements are rendered should also work on the specialized topics without additionalmodifications.The toolbar/menu actions should be customized to insert the correct element names if this is the case. You can go to theDITA document type from the Document Type Association page and edit the actions to insert the element names asspecified in your specialization. See this section for more details.Use a New DITA Open Toolkit in <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong><strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> comes bundled with a DITA Open Toolkit, located in the[<strong>Oxygen</strong>-install-folder]/frameworks/dita/DITA-OT directory. To use a new DITA Open Toolkit,follow these steps:1. Edit your transformation scenarios and in the Parameters tab change the value for the dita.dir directory to pointto the new directory.2. If you want to make changes in the libraries that come with the new DITA Open Toolkit and are used by the ANTprocess you can go to the Advanced tab, click the Libraries button, uncheck the checkbox Allow <strong>Oxygen</strong> to addhigh priority libraries to classpath.3. If there are also changes in the DTD's and you want to use the new versions for content completion and validation,go to the <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> preferences in the Document Type Association page, edit the DITA andDITA Map document types and modify the catalog entry in the Catalogs tab to point to the custom catalog filecatalog-dita.xml.If the transformation fails after completing these steps please also take a look at this note about upgrading the DITA OTwhich comes bundled with <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> .Reusing ContentThe DITA framework allows reusing content from other DITA files with a content reference in the following ways:• You can select content in a topic, create a reusable component from it and reference the component in other locationsusing the actions Create Reusable Component and Insert Reusable Component. A reusable component is a file,usually shorter than a topic. You also have the option of replacing the selection with the component that you are inthe process of creating.• You can add, edit, and remove a content reference (conref) attribute to/from an existing element. The actionsAdd/Edit Content Reference and Remove Content Reference are available on the contextual menu of the <strong>Author</strong>editor and on the DITA menu. When a content reference is added or an existing content reference is edited, you canselect any topic ID or interval of topic IDs (set also the conrefend field in the dialog for adding/editing the contentreference) from a target DITA topic file.• You can insert an element with a content reference (conref or conkeyref ) attribute using one of the actionsInsert Content Reference and Insert Content Key Reference that are available on the DITA menu, the <strong>Author</strong>custom actions toolbar and the contextual menu of the <strong>Author</strong> editor.DITA makes the distinction between local content, that is the text and graphics that are actually present in the element,and referenced content that is referred by the element but is located in a different file. You have the option of displayingreferenced content by setting the option Display referred content that is available from menu Options > Preferences> Editor > Edit modes > <strong>Author</strong>.Working with Content ReferencesThe DITA feature called conref (short for content reference) enables a piece of content to be included by referencein multiple contexts. When you need to update that content, you do it in only one place. Typical uses of content referencesare for product names, warnings, definitions or process steps.You can use either or both of the following strategies for managing content references:• Reusable components - With this strategy, you create a new file for each piece of content that you want to reuse.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!