Edit online

Oxygen XML Web Author supports DITA specializations that allow you to design your own markup. The DITA specialization can be defined with any of the following:
To integrate a DITA specialization into Oxygen XML Web Author, follow this procedure:
  1. Open a standalone version of Oxygen XML Editor/Author.
  2. Extend an existing DITA framework:
    1. In a location where you have full write access, create a folder for your extended framework (for example, my_dita_framework).
    2. Open the Preferences dialog box (Options > Preferences) and go to Document Type Association > Locations. In this preferences page, add the path to the my_dita_framework folder in the Additional frameworks directories list.
    3. Go to the Document Type Association preferences page and select an existing DITA framework configuration and use the Extend button to create an extension for it.
    4. Give the extension an appropriate name (for example, DITA - Custom), select External for the Storage option, and specify an appropriate path (for example, path/to/.../my_dita_framework/dita-custom.framework).
    5. Click OK to close the dialog box and then OK or Apply to save the changes.
      Tip: For more information about framework customization, see Integrating Web Author with Your Content by Creating Custom Frameworks.
  3. Create a folder inside your extended framework folder (for example, my_dita_framework/my_dita_specialization). This folder should contain your DTD or schema files and a catalog.xml file that references them.
  4. Create another catalog file inside the extended framework folder (my_dita_framework/catalog.xml) that points to the catalog file in your specialization folder. For example, this new catalog.xml file should look like this:
    <?xml version="1.0" encoding="UTF-8"?>
    <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
       <nextCatalog catalog="my_dita_specialization/catalog.xml"/>
  5. Create an archive that contains your extended framework folder (for example, my_dita_framework). The archive should contain exactly one folder on the first level.
  6. Upload the framework to Web Author.
  • For a resource to help you with creating the DITA specialization, see the DITA for Practitioners DITA Configuration and Specialization Tutorials.
  • If you need to define custom profiling attributes in your specialization, the domains attribute of the root element should contain:
    a(props ATTR)

    where ATTR is the name of the custom profiling attribute.