Astoria supports the EditLink plugin from Oxygen, which allows you to supply Astoria named parameters as values for the plugin parameters to embed links in PDF output that open a topic in the repository for editing in Oxygen WebApp editor.
Organizations who have licensed the Oxygen WebApp may want to install the EditLink plugin, compatible with DITA-OT 2.x and above. See Installing the EditLink Plugin.
| EditLink Parameter Name | Value | Description |
|---|---|---|
| editlink.present.only.path.to.topic | false | The EditLink default value. |
| editlink.remote.ditamap.url | documentEditURL | Substitutes the repository URL for the EditLink plugin to identify the map being composed. |
| editlink.web.author.url | oxygenAuthorURL | Substitutes the URL required to launch the Oxygen WebApp browser. |
EditLink parameters are registered as watched parameters during an Astoria upgrade or installation. The presence of a registered parameter will alter the naming of output files to be of the format _id_[astoria_object id]_[name].[extension]. This naming convention is required for the EditLink plugin to work correctly. For more information about an administrator script that manages watched parameters, see registerAlternativeNamingParams.py in Administrator Scripts.
- Use a composition profile that defines the parameters. See Creating a Composition Profile Supporting the EditLink Plugin.
- In the Custom Parameters field of the Compose with DITA-OT dialog, enter the string:
-Deditlink.present.only.path.to.topic=false -Deditlink.web.author.url=${oxygenAuthorURL} -Deditlink.remote.ditamap.url=${documentEditURL}
