What would you like to know more about?

Linking Directly to an Element in a Topic

You can link directly to an element in a topic using an ID value.

This is similar to the "Copy link to highlight" feature in most browsers, where you can jump to a particular area of the topic, even if it's not one of the topic's sections.

To do this, add an ID to your element. Note that the text of this ID will display in your final link URL, so try to keep it short and sweet. For example, <dt id="mapping">.

Make sure the element you add an ID to has a presence on the help page. For example, you can link to a <dt> but not a <dlentry> because a definition term has text associated with it, whereas a definition list entry is just a container for the term and definition.

Then, you can format your share link URL as follows: https://help.acst.com/?resourceId=[resource-id]#[topic-id]__[element-id]
  • The resource-id is defined in the prolog of the topic.
  • The topic-id is defined at the very top of the topic.
  • The element-id is defined on the element.

Your link can then be shared externally, and, when clicked, it will jump directly to the element's text.

Example

Let's say I want to link directly to the "Form Response Field Mapping" definition term on this Help Center page.

So, I open this topic in Heretto, and I add id="mapping" to the <dt> element for Form Response Field Mapping. It looks like this:
Example showing code view of the topic c_mp_services_ready-made_solutions.dita with <dt id="mapping"> highlighted
The resource ID for this topic is "rms" and the topic ID is "mp.services.readymade.solutions", as you can see in code view:
Example showing code view of the topic c_mp_services_ready-made_solutions.dita with <concept id="rms"...> and <resourceid id="mp.services.readymade.solutions"/> highlighted

So that means the link is: https://help.acst.com/?resourceId=mp.services.readymade.solutions#rms__mapping

When I click this link, it takes me directly to the definition term in the help topic:
Example showing the MinistryPlatform Help Center with the Ready-Made Solutions topic opened and the Form Response Field Mapping definition showing