How to Add an Edit Link to Launch Oxygen XML Web Author
Edit online

You can embed Edit links in the DITA WebHelp Responsive output that will automatically launch a particular document in Oxygen XML Web Author. A reviewer can then simply click the link and they will be redirected to the Oxygen XML Web Author editing page with that particular file open and editable.

Using a Publishing Template

To embed an Edit link in the DITA Map WebHelp Responsive output using an Oxygen Publishing Template, follow this procedure:
  1. If you haven't already created a Publishing Template, see Working with Publishing Templates.
  2. Open the template descriptor file associated with your publishing template and add the following parameters with their values set to the URLs:
    • editlink.remote.ditamap.url - The URL of the DITA Map suitable for opening in Oxygen XML Web Author.
    • editlink.web.author.url - The URL of the Oxygen XML Web Author installation.
    <publishing-template>
    ...
    <webhelp>
        ...                
        <parameters>
            <parameter name="editlink.remote.ditamap.url" 
                       value="webdav-https://dav.box.com/dav/my.ditamap"/>
            <parameter name="editlink.web.author.url" 
                       value="https://www.oxygenxml.com/webauthor.html"/>
        </parameters>
    </webhelp>
  3. Open the DITA Map WebHelp Responsive transformation scenario.
  4. Click the Choose Custom Publishing Template link and select your template.
  5. Click OK to save the changes to the transformation scenario.
  6. Run the transformation scenario.

    Result: In the WebHelp output, all topics will have an Edit link to the right side of the title and clicking the link will launch that particular document in Oxygen XML Web Author.

For example:
  • Windows:

    dita.bat -i c:\mySample.ditamap -f webhelp-responsive -Deditlink.remote.ditamap.url=webdav-https://dav.box.com/dav/my.ditamap -Deditlink.web.author.url=https://www.oxygenxml.com/webauthor.html

  • Mac OS X/ Linux:

    dita -i /mySample.ditamap -f webhelp-responsive -Deditlink.remote.ditamap.url=webdav-https://dav.box.com/dav/my.ditamap -Deditlink.web.author.url=https://www.oxygenxml.com/webauthor.html

Using a Transformation Scenario in Oxygen XML Editor/Author

To embed an Edit link in the DITA Map WebHelp Responsive output using a transformation scenario from within Oxygen XML Editor/Author, follow this procedure:
  1. Edit a DITA Map WebHelp Responsive transformation scenario and open the Parameters tab.
  2. Set values for the following parameters:
    • editlink.remote.ditamap.url - The URL of the DITA Map suitable for opening in Oxygen XML Web Author.
    • editlink.web.author.url - The URL of the Oxygen XML Web Author installation.
  3. Run the transformation scenario.

    Result: In the WebHelp output, all topics will have an Edit link to the right side of the title and clicking the link will launch that particular document in Oxygen XML Web Author.

For more information, see https://www.oxygenxml.com/doc/ug-waCustom/topics/webauthor-integrate-embedded-launch.html.