Updated 11/22/2023
You can setup embedded links to topics in other publications, output from either CLC or Trisoft. The target needs to belong to the same product-release-language space and must have a topic ID in the yaml.
At the top of a topic use the following pattern
---
topicid: yourtopicid
---
For example
---
topicid: GUID-DBB775D1-EC66-4178-BC90-CFFD55A1C6A3
---
If the topic originated from CLC you can use the CLC generated guid created from the file path. For example:
BIM360D_Cost_Management_about_payments_pay_app_status_html
Use the following target pattern
topicid=<the actual topicid>
For example
[xpub link](topicid=GUID-081B7FFA-F313-464B-85A5-A060AA9EB44A)
The Markdown above was used to setup the link to this topic xpub link.
When link text is not provided, the title of the target topic is injected as link text.
Use the following target pattern
[](topicid=GUID-42EA9825-C1D3-4DC3-B213-BA171F239E59)
The Markdown above was used to setup the link to this topic Card Thumbnails (DITA)
Use the following target pattern
[xpub link with anchor](topicid=GUID-42EA9825-C1D3-4DC3-B213-BA171F239E59#GUID-42EA9825-C1D3-4DC3-B213-BA171F239E59__GUID-2E6B274F-F30A-48AB-BE0B-9588D35FF440)
The Markdown above was used to setup the link to this topic xpub link with anchor
[a xpub link to junk that doesn't work](topicid=junk)
The Markdown above was used to setup a xpub link to junk that doesn't work.
When the target cannot be found, the link itself is dropped and the link text is inserted in its stead (asterisks were used to offset the link text in boldface).
Use the related metadata in the yaml header.
related:
- topicid=whatsnewcard-two
When the target cannot be found, the link is dropped, implementing "graceful degradation" supported in DITA.