Specifying a unique output filename for multiple topic instances to support breadcrumbs

Last Updated : May 28, 2021 |
This topic provides information on using the copy-to attribute to specify a unique filename when you include a topic more than once in a publication.
Prolog information
You must specify a unique output filename when you use a topic more than once in a publication that uses the HTML5 output format. The HTML5 output format support breadcrumbs at the top of each topic. If you use a topic more than once in a publication and you do not use the copy-to attribute to specify a unique output filename, the breadcrumbs for each instance of the topic will include multiple paths.
Apply the copy-to attribute only on the additional instances of the topic. However, you can use the copy-to attribute for every instance of the topic.
Note:
The copy-to attribute might fail the Avaya DocPortal output generation, therefore, use it only when required.
  1. Start Publication Manager.
  2. Open the publication and locate the map that contains the additional instance of the topic.
  3. Right-click the map, click Check out with, and select Oxygen XML Author.
  4. Double-click or select the topicref to which you want to specify the copy-to attribute.
  5. In the Attributes window, select the copy-to field and enter the filename to which you want to assign this instance of the topic.
  6. Click OK.
  7. Check in the DITA Map.
  8. Repeat these steps for any additional instances of the topic.