Edit online

Editing XProc Scripts

XProc is an XML pipeline language that can be used to script transformations. An XProc script is edited as an XML document that is validated against a RELAX NG schema, or if the script has an associated validation scenario, then the XProc engine selected in the scenario is used as the validating engine (if the XProc engine supports validation). The default engine for XProc scenarios is a version of the Calabash engine that comes bundled with Oxygen XML Developer version 26.1. The default engine supports content completion and validation of XProc 1.0 and 3.0 files.
Note: If a custom engine is used, the validation support for XProc version 3.0 depends on whether it is available for the particular custom engine.

XProc Content Completion

Oxygen XML Developer helps you edit a XProc scripts through the Content Completion Assistant, offering proposals that are valid at the cursor position. It can be manually activated with the Ctrl + Space shortcut.

The content completion inside the <input/inline> element from the XProc namespace http://www.w3.org/ns/xproc offers elements from the following schemas depending both on the @port attribute and the parent of the <input> element. When invoking the content completion inside the <inline> XProc element, the list of content completion proposals is populated as follows:

  • If the value of the @port attribute is stylesheet and the <xslt> element is the parent of the <input> elements, the Content Completion Assistant offers XSLT elements.
  • If the value of the @port attribute is schema and the <validate-with-relax-ng> element is the parent of the <input> element, the Content Completion Assistant offers RELAX NG schema elements.
  • If the value of the @port attribute is schema and the <validate-with-xml-schema> element is the parent of the <input> element, the Content Completion Assistant offers XML Schema schema elements.
  • If the value of the @port attribute is schema and the <validate-with-schematron> element is the parent of the <input> element , the Content Completion Assistant offers either ISO Schematron elements or Schematron 1.5 schema elements.
  • If the above cases do not apply, then the Content Completion Assistant offers elements from all the schemas from the above cases.
Figure 1. XProc Content Completion

XProc Syntax Highlighting

The XProc editor assists you in writing XPath expressions by offering dedicated coloring schemes for syntax highlighting.

To customize the colors or styles used for the syntax highlighting colors for XProc, follow these steps:
  1. Open the Preferences dialog box (Options > Preferences).
  2. Go to Editor > Syntax Highlight.
  3. Select and expand the XML section in the top pane.
  4. Select the component you want to change and customize the colors or styles using the selectors to the right of the pane.
  5. Select the XML tab in the Preview pane to see the effects of your changes.

Enabling Extensions in Calabash

If you are using the default Calabash engine, it is possible to configure extensions (for a list of the valid extensions, see http://xmlcalabash.com/docs/reference/cfg.extension.html).

To configure an extension:
  1. Edit the following file: OXYGEN_INSTALL_DIR/lib/xproc/calabash/engine.xml.
  2. Add the extension and its value as a system-property, as in the following example:
    <system-property name="com.xmlcalabash.allow-text-results" value="true"/>