Configuring Transformation Scenarios for a Framework
Edit online

When distributing a framework to users, it is a good idea to have the transformation scenarios already configured. This helps the content authors publish their work in various formats. By being contained in the framework configuration, the scenarios can be distributed along with the actions, menus, toolbars, and catalogs.

These are the steps that allow you to create a transformation scenario for your framework.

  1. Create an xsl folder inside your custom framework directory ([OXYGEN_INSTALL_DIR]\frameworks\[CUSTOM_FRAMEWORK_DIR]).

    The folder structure for the documentation framework should be:

    oxygen
  frameworks
     [CUSTOM_FRAMEWORK_DIR]
       schema
       css
       templates
       xsl
  2. Create the sdf.xsl file in the xsl folder. The complete content of the sdf.xsl file is found in the Example Files Listings.
  3. Open the Preferences dialog box (Options > Preferences) and go to Document Type Associations. Select the particular framework, click the Edit button to open Document Type Configuration dialog box, and choose the Transformation tab. Click the New button and choose the appropriate type of transformation (for example, XML transformation with XSLT).
    In the New scenario dialog box, fill in the following fields:
    • Fill in the Name field with the name of your transformation scenario.
    • Set the XSL URL field to path of your custom stylesheet (for example, ${framework}/xsl/mycustom.xsl).

    Figure: Configuring a New XSLT Transformation Scenario

  4. Change to the Output tab. Configure the fields as follows:
    • Set the Save as field to ${cfd}/${cfn}.html. This means the transformation output file will have the name of the XML file and the html extension and will be stored in the same folder.
    • Select the Open in Browser/System Application option.
      Note: To set the browser or system application that will be used, open the Preferences dialog box (Options > Preferences), go to Global, and set it in the Default Internet browser field. This will take precedence over the default system application settings.
    • Select the Saved file option.
  5. Click the OK button to save the new scenario.

Now the scenario is listed in the Transformation tab:

Figure: Transformation Tab

To test the transformation scenario that you just created, open the SDF XML sample from the Example Files Listings. Click the Apply Transformation Scenario(s) button to display the Transform with dialog box. The scenario list contains the scenario you defined earlier . Select the SDF to HTML scenario that you just defined and click the Apply associated button. The HTML file is saved in the same folder as the XML file and displayed in the browser.