Edit online

Opening a Document at a Specific Location Using a Command-Line Interface

Oxygen XML Editor offers support for opening a file at a specific position using a command-line interface to transmit parameters to the Oxygen XML Editor application launching script file (oxygen.bat/oxygen.sh ). The following methods are available, depending on how you identify the position that is needed:

  1. Specific position values (line and column number, or character offset)

    Oxygen XML Editor supports the following position parameters:
    • line - The line number.
    • column - The column number (has meaning if the line parameter is also defined).
    • char - The character offset.

    Examples for Windows:

    The following examples show how you can open an XML document in Oxygen XML Editor from a Windows command-line interface:
    oxygen.bat  file:samples/personal.xml#line=4
oxygen.bat  file:samples/personal.xml#line=4column=5
oxygen.bat  file:samples/personal.xml#line=4;column=5
oxygen.bat  file:samples/personal.xml#char=334

  2. Simplified XPath index path

    Oxygen XML Editor will open an XML file and select one of its elements identified by a simplified XPath index path. For example, an index path of the form 1/5/7 identifies the seventh child of the fifth child of the root element.
    Restriction: Oxygen XML Editor will display a selection that starts with the first character of the content of the identified element and spans until the end of the line.

    Examples for Windows:

    The following example shows how you can open an XML document in Oxygen XML Editor and select the third child of the root element using a Windows command-line interface:
    oxygen.bat  file:samples/personal.xml#element(1/3)

  3. Anchors identified by ID attribute values

    Oxygen XML Editor will open an XML file and select the element whose @id attribute value is an exact match of the anchor attached to a command-line instruction.

    Examples for Windows:

    The following example shows how you can open an XML document in Oxygen XML Editor and select the element that has the @id set to titleID using a Windows command-line interface:
    oxygen.bat  file:samples/personal.xml#titleID