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

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Author</strong> for DITA | 112• Validate each referred topic and map. Each topic file is opened and validated against the appropriate DITA DTD. Ifother map is referred in the main map, it is checked recursively applying the same algorithm as for the main map.You can customize the operation setting the following options:• Check the existence of non-DITA references resources - extends the validation of referred resources to non-DITAfiles. You can also choose to include in the validation also the remote resources;• Use DITAVAL filters - the content of the map is filtered by applying a profiling condition set before validation.• From the current condition set - the map is filtered using the condition set applied currently in the DITA MapsManager view.• From all available condition sets - for each available condition set, the map content is filtered using the conditionset before validation.• From the associated transformation scenario - the filtering condition set is specified explicitly as a DITAVALfile in the current transformation scenario associated with the DITA map.• Other DITAVAL files - for each DITAVAL file, the map content is filtered using the DITAVAL file beforevalidation.If a link is invalid in the content that resulted from the filtering process, then it is reported as error.• Check for duplicate element IDs within a topic - if an ID is duplicated after assembling all topics referred in themap, it is reported as error.• Report links to topics not referenced in DITA Maps - checks that all referred topics are linked in the DITA map.• Identify possible conflicts in profile attribute values - when a topic's profiling attributes contain values that arenot found in parent topics profiling attributes, the content of the topic is overshadowed when generating profiledoutput. This option reports such possible conflicts.• Report attributes and values that conflict with profiling preferences - looks for profiling attributes and valuesnot defined in the Profiling / Conditional Text preferences page. It also checks if profiling attributes defined assingle-value have multiple values set in the searched topics.Create a Topic in a MapYou add a new topic to a DITA map with the following steps:1. Run the action Insert Topic Reference in the view DITA Maps Manager.The action Insert Topic Reference is available on the toolbar and on the contextual menu of the view. The actionis available both on the submenu Append Child (when you want to insert a topic reference in a map as a child ofthe current topic reference) and on the submenu Insert After (when you want to insert it as a sibling of the currenttopic reference). The toolbar action is the same as the action from the submenu Insert After.2. Select a topic file in the file system dialog called Insert Topic Reference.3. Press the Insert button or the Insert and close button in the dialog.A reference to the selected topic is added to the current map in the view.4. If you clicked the Insert button you can continue inserting new topic references using the Insert button repeatedlyin the same file system dialog.5. Close the dialog using the Close button.Organize Topics in a MapYou can understand better how to organize topics in a DITA map by working with a populated map. You should openthe sample map called flowers.ditamap, located in the samples/dita folder.1. Open the file flowers.ditamap.2. Select the topic reference Summer Flowers and press the Move Down button to change the order of the topicreferences Summer Flowers and Autumn Flowers.3. Make sure that Summer Flowers is selected and press the Demote button. This topic reference and all the nestedones are moved as a unit inside the Autumn Flowers topic reference.4. Close the map without saving.

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

Saved successfully!

Ooh no, something went wrong!