How to add an edit link to launch Oxygen XML Web Author using a publishing template

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

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 temaplates.
  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 Component.
    • editlink.web.author.url - The URL of the oXygen XML Web Author Component 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.
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 Component.
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

  • Linux:

    dita -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