Introduction
Welcome to the User Manual of Oxygen XML Author 26.1
Getting Started
Information and resources to help you get started using Oxygen XML Author as quickly as possible
Installation
The requirements and installation instructions for each platform
Configuration
Description of all of the options that allow you to configure Oxygen XML Author
Perspectives
The Editor and Database perspectives
Editing Modes
The Text, Grid, and Author editing modes
Working With Documents
General information about features available when working with documents
Editing Supported Document Types
Details about the various types of supported documents and their unique editing features
Built-in Frameworks (Document Types)
The editing frameworks that are supported in Oxygen XML Author
Additional XML Editing Frameworks (Document Types)
The custom frameworks that are supported in Oxygen XML Author
Publishing
Details about transformation scenarios and customizing various types of output
Working with XPath Expressions
Information about using XPath Expressions in Oxygen XML Author
Working with Archives
Describes how to use the Archive Browser to work with various type of archives
Databases and SharePoint
Connecting to supported databases and integrating Oxygen XML Author with SharePoint
Importing Data
Information about how to import data from external sources into XML documents
Framework and Author Mode Customization
Tutorials and details about customizing frameworks and the visual Author editing mode
Extending Oxygen With the SDK
Information about extending Oxygen XML Author using the SDK
- Extending Oxygen XML Author with Plugins
  - General Configuration of an Oxygen XML Author Plugin
  - Installing an Oxygen XML Author Plugin
  - Types of Plugin Extensions Available with the SDK
    - Workspace Access Plugin Extension
      This type of plugin allows you to contribute actions to the main menu and toolbars, create custom views, interact with the application workspace, make modifications to opened documents, and add listeners for various events.
    - Workspace Access Plugin Extension (JavaScript-Based)
      This is a JavaScript-based plugin extension that allows you to contribute actions to the main menu and toolbars, create custom views, interact with the application workspace, make modifications to opened documents, and add listeners for various events.
    - Trusted Hosts Plugin Extension
      This type of plugin can be used by developers to automatically allow or reject remote connections that Oxygen XML Author would normally ask the user for confirmation.
    - Author Stylesheet Plugin Extension
      This type of plugin allows you to add a stylesheet (CSS or LESS) that renders elements in Author mode.
    - Additional Framework Plugin Extension
      This type of plugin allows you to add a new framework straight from the plugin.
    - Additional XProc Engine Plugin Extension
      This type of plugin contributes a folder that contains an external XProc engine.
    - Components Validation Plugin Extension
      This type of plugin allows you to customize the menus, toolbars, and other components by enabling or filtering them from the user interface.
    - Contribute Additional Languages Plugin Extension
      This type of plugin allows you to contribute new translation languages to the Oxygen XML Author UI.
    - Contribute External DITA-OT Distribution Plugin Extension
      This type of plugin allows you to contribute an external DITA-OT distribution to Oxygen XML Author.
    - Custom Protocol Plugin Extension
      This type of plugin allows you to work with a custom designed protocol for retrieving and storing files.
    - Lock Handler Plugin Extension
      This type of plugin extension is used for locking resources from a specific protocol.
    - Open Redirect Plugin Extension
      This type of plugin is useful for opening multiple files with only one open action.
    - Option Page Plugin Extension
      This type of plugin extension allows you to add custom Preferences pages.
    - Option Page Group Plugin Extension
      This type of plugin extension allows you to add a group of custom Preferences pages from a plugin.
    - Resource Locking Custom Protocol Plugin Extension
      This type of plugin allows you to work with a custom designed protocol for retrieving and storing files and it can lock a resource when opening it in Oxygen XML Author.
    - Styles Filter Plugin Extension
      This type of plugin allows you to dynamically modify the CSS styles used to render elements in the Author mode.
    - Targeted URL Stream Handler Plugin Extension
      This type of plugin can be used when it is necessary to impose custom URL stream handlers for specific URLs.
    - XML Refactoring Operations Plugin Extension
      This type of plugin allows you to specify one or more directories where the XML Refactoring operation resources are loaded.
    - XSLT Transformer Plugin Extension
      This type of plugin allows you to add an external XSLT transformer plugin.
    - Validator Plugin Extension
      This type of plugin allows you to add an external validation engine from a plugin.
    - Saxon XSLT Transformer Plugin Extension
      This type of plugin allows you to add an external Saxon XSLT transformer plugin.
    - XQuery Transformer Plugin Extension
      This type of plugin allows you to add an external XQuery transformer plugin.
    - Saxon XQuery Transformer Plugin Extension
      This type of plugin allows you to add the Saxon external XQuery transformer plugin.
    - Plugin Extensions Designed to Work only in the Text Editing Mode
      - General Plugin Extension
        This type of plugin allows you to invoke custom code to interact with the workspace in Text mode.
      - Selection Plugin Extension
        This type of plugin allows you to manage selections of text.
      - Document Plugin Extension
        This type of plugin allows you to manage the current document.
  - How to Write a CMS Integration Plugin
  - How to Write A Custom Protocol Plugin
  - How to Share a Class Loader Between a Framework and Plugin
  - Packing and Deploying Plugins as Add-ons
  - Testing Plugins and Java Extensions
  - Disabling a Plugin
- Oxygen XML Author Component
- Oxygen XML Web Author Component
- Developer Quick Start Guide
- SDK Common Use Cases
Add-ons
Information about extending Oxygen XML Author with add-ons
Tools
Specifics about the various tools that are included in Oxygen XML Author
Troubleshooting
A compilation of common problems and their solutions
DITA Authoring
A guide to help content authors who create and publish DITA content
Scripting Oxygen
Details about the scripting possibilities that are available with Oxygen XML Author
Glossary
Copyright
Legal information

Document Plugin Extension

This type of plugin allows you to manage the current document.

The document plugin type can only be applied to an XML document. It can modify the current document that is received as a callback parameter.

The plugin is started by selecting the corresponding menu item from the Plugins submenu in the contextual menu of Text mode. It provides the following API:

DocumentPluginExtension interface

Receives the context object containing the current document. The process(GeneralPluginContext) method can return a DocumentPluginResult object containing a new document.

DocumentPluginContext object

Represents the context and provides three methods:

getDocument() - Returns a javax.swing.text.Document object that represents the current document.
getFrame() - Returns a java.awt.Frame object that represents the editing frame.
getPluginWorkspace() - Returns access to the workspace of Oxygen XML Author.