Sharing a Framework (Document Type)

Oxygen XML Author plugin allows you to share customizations of a specific XML document type by creating your own framework in the Document Type Association preferences page.

A framework (document type) can be shared with other authors by using the following method:

Save it in a Custom Folder

To share your customized framework with other members of your team, you can save it to a separate folder inside the [OXYGEN_INSTALL_DIR]/frameworks directory by following these steps:
Important: For this approach to work, the application must be installed in a folder with full write access.
  1. Go to [OXYGEN_INSTALL_DIR]/frameworks and create a directory for your new framework (for example, custom_framework). This directory will contain the resources for your customized framework. See the DocBook framework structure from [OXYGEN_INSTALL_DIR]/frameworks/docbook as an example.
  2. Create your custom document type (framework) and specify the custom_framework directory for the External storage option.
  3. Configure the custom document type according to your needs. Take special care to make all file references relative to the [OXYGEN_INSTALL_DIR]/frameworks directory by using the ${frameworks} editor variable. See the Author Mode Customization section for more details on creating and configuring a new document type (framework).
  4. Add any additional resources (CSS files, new file templates, schemas used for validation, catalogs, etc.) to the directory you created in step 1.
  5. After completing your customizations in the Document Type Association preferences page, you should have a new configuration file saved in: [OXYGEN_INSTALL_DIR]/frameworks/custom_framework/custom.framework.
  6. To share the new framework directory with other users, have them copy it to their [OXYGEN_INSTALL_DIR]/frameworks directory. The new framework will be available in the list of document types when Oxygen XML Author plugin starts.
    Note: If you have a frameworks directory stored on your local drive, you can also go to the Document Type Association > Locations preferences page and add your frameworks directory in the Additional frameworks directories list.