Under maintenance

Heretto Help

Sitemap Attributes Reference

You can control some aspects of the page layout and behavior by setting specific attributes on select elements in a sitemap.

<sitesection> attributes and <topichead> attributes

Note: <sitesection> elements are specialized <topichead> elements.
@outputclass="view-tiles"

Default for <sitesection> elements.

  • Rendered as a navigation tile
  • Present in the main Table of Contents (TOC)
@outputclass="hidden"

Default for <topichead> elements.

  • Not rendered as a navigation tile
  • Present in the main TOC
@outputclass="view-toc"

Default for <sitesection> elements with multiple versions of content. If you add this to the <sitesection> element, the version dropdown selector will render in the portal.

Tip: The following element pairs render in the same way:
  • <sitesection outputclass="hidden"> and <topichead>
  • <sitesection> and <topichead outputclass="tile">

<topicref> attributes

@toc="no"
Hide a topic and its children from the main (left) TOC.
@chunk="to-content"
Chunk children topics to the parent topic. The parent topic displays as a single entry in the main (left) TOC.
Important:

Applying the chunk attribute within an already chunked structure causes unexpected results in outputs. For example, in this structure, the chunk attribute added to <topicref href="topic-3---child.dita"> is redundant and will cause issues. For correct results in output, apply the chunk attribute once, to a top-level element which in this example is the first topicref element.

<topicref href="topic-1---parent.dita" chunk="to-content">
    <topicref href="topic-2---child.dita"/>
    <topicref href="topic-3---child.dita" chunk="to-content">
        <topicref href="topic-4---child.dita"/>
    </topicref>
    <topicref href="topic-5---child.dita"/>
</topicref>
@outputclass="full-content"

Default and exclusive for <topicref> elements.

  • Rendered in the central content area
@format="pdf"

Publish a PDF file to Heretto Portal. Also works when set on the xref element. For more information, see Heretto Portal PDF Handling.