Oxygen XML Author Eclipse plugin includes powerful dynamic publishing
features that allow you to easily integrate Word, Excel, OpenAPI, HTML,
Markdown documents into a DITA project and have them automatically converted to DITA at
the time of publishing. This is especially helpful for teams that have contributors who work
with non-DITA documents but want their output to be generated from DITA projects.
Attention: These features are available with no restrictions
when the publishing process is done using the default publishing engine that is bundled in
Oxygen XML Author Eclipse plugin or if you have integrated the DITA-OT dynamic converter plugin into
a custom DITA-OT distribution.
Working with DITA-Compatible Documents in the DITA Maps Manager
Oxygen XML Author Eclipse plugin has some specialized features that allow you to integrate DITA-compatible documents directly into your DITA project using the DITA Maps Manager. The following features are available in the DITA Maps Manager view:
- Insert References to DITA-Compatible Documents - You
can use the New, Reference, and
Reference to the currently edited file actions from the
Append Child, Insert Before, or
Insert After submenu when invoking the contextual menu in the
DITA Maps Manager to insert a reference to a Word, Excel,
OpenAPI, HTML or Markdown document at the selected location in the map. A topic
reference (
<topicref>) element with the appropriate@formatattribute value will be inserted. - Title of Referenced Resources is Displayed - The title of each referenced DITA-compatible resource is presented in the DITA Maps Manager view.
- Validate DITA-Compatible Documents in DITA Maps -
When you use the
Validate and Check for Completeness action from
the DITA Maps Manager toolbar to check the integrity of the
structure of a DITA map, DITA-compatible documents that are referenced in
the DITA map are converted to DITA topics in the background and validated
the same as any other DITA topic. - IDs Presented When Inserting References - When inserting topic references, cross references, or content references to content inside DITA-compatible documents, the application presents a list of DITA-specific IDs from the target document.
- Transform DITA Maps with DITA-Compatible Documents - When transforming DITA maps that have DITA-compatible documents referenced, the transformation converts the documents to normal DITA output without you needing to manually convert the documents to DITA topics.
Resources
For more information about working with DITA-compatible resources, see
the following resources: