Context-sensitive help support in content migrated from Astoria

Last Updated : Apr 08, 2024 |
Prolog information
In GIS, the team used multiple methods to support context-sensitive help. You can use one of the supported methods only if you must migrate from Astoria to Trisoft, the old name of Tridion Docs.
If you are creating a new GIS project that requires context-sensitive help, see Supporting context-sensitive help for HTML outputs without context IDs.

Projects that used the Astoria filename as the base for context-sensitive help

Many GIS projects used the Astoria filename as the base for context-sensitive help. Tridion Docs preserves the Astoria filename in the base attribute on the root element in the topic so that the HTML output filenames remain the same. This attribute is represented by the Override Output File Name, a read-only field. For new topics in context-sensitive help, you must use the base attribute to specify the filename to be used in the context-sensitive help. For information on using the base attribute to add a help ID, see the topic Supporting context-sensitive help for HTML outputs without context IDs.

Heritage Nortel projects that use mapping for context-sensitive help

Writers who supported Heritage Nortel projects, applied the help ID for the topic on the topic title element. In Tridion Docs (erstwhile Trisoft), the way the help ID is applied is changed because Tridion Docs does not support IDs on topic titles. In Tridion Docs, if you must add an ID to a topic to support context-sensitive help, you add a resourceid to the topic prolog. See the topic Supporting context-sensitive help for HTML outputs that use context IDs (Eclipse Help, .chm, and Heritage Nortel projects). This change is implemented in topics migrated from Astoria.

Projects that used the copy-to attribute on topicrefs to support context-sensitive help

Some GIS projects applied the copy-to attribute to topicrefs in DITA Maps to support context-sensitive help. The copy-to attribute has been preserved in the migration to Trisoft, so the HTML filenames in the output continues to use the contents of the copy-to attribute. The copy-to attribute does not appear in Publication Manager. Instead, you must check out the map in Oxygen XML Author to modify the copy-to attribute. See the topic Supporting context-sensitive help for HTML outputs without context IDs for information on using the base attribute to supply a help ID. To change your project to use the base attribute instead, submit an issue to the Infosolutions project.
Note:
The copy-to attribute method is deprecated. Therefore, use the base attribute.