Migrating a Framework from Oxygen XML Editor/Author to Web Author
Edit online

Frameworks developed for Oxygen XML Editor/Author have a high degree of compatibility with Oxygen XML Web Author. However, in some cases, additional work is required to make the framework compatible with both products.

General Recommendations

You can use the Web Author Test Server add-on to test your framework in both products with minimal overhead.
Note: It is always useful to check out the server log. It can be found in the plugin's folder in: tomcat/logs/oxygen.log.

Document Styles

The CSS styles used to render the document in the desktop application can be re-used in Web Author, although there are some limitations.

Toolbar and Contextual Menu Actions

Actions in Oxygen XML Web Author can be specified in two ways:

Some of the toolbar actions may not appear in Web Author. The most common reason is that the toolbar actions use a custom AuthorOperation that is not marked as compatible with Web Author.

This is how the toolbar structure is built:
  • The default structure of the toolbar is defined in the *.framework file and is common with the one in the desktop editor. You can visualize it using the Document Type Configuration dialog box.
  • The client-side component of Web Author retrieves this configuration using an HTTP request to something like ./rest/VERSION/actions/actionsConfig/docNNN.NNN. Actions that are not compatible are removed from this configuration. You can check it in the browser's Dev Tools Network tab.
  • If you are extending another framework, it can override the configuration of the toolbar using JavaScript code.
  • When the contextual menu is shown, actions that are not enabled at a specific position are not shown.
Note: The actions on the Web Author toolbar are not disabled based on the location of the cursor. However, they always try to find a valid position for that element in a position that is close to the cursor location.

New Document Templates

When editing a DITA map, there is a Insert New DITA Resource toolbar button that opens a dialog box where you can choose the type of DITA document to create and inserts a reference to it at the current position within the map. The templates that are listed include:
  • Templates that have type=dita specified in its .properties file.
  • Templates that do not have a type specified in its .properties file.
  • Templates that do not have a .properties file.

If you want to hide a particular template from appearing in the dialog box, you should modify the .properties file for the particular template and make sure it has a type and that the type is not set to dita. For more details about configuring the .properties file for a template, see Customizing Document Templates.