Gretyl's Portal

Heretto Help

Sitesection with Versions

Versioned sitesections can include multiple versions of the same content.

Tip: Sitesections with versions are useful if you want to publish different releases of the same content.You can reference resources from different Heretto CCMS branches. For more information about versioning in Heretto CCMS, see Versioning Overview.

Basic Sitesection with Versions

The following example shows the site output results of a sitemap with a <sitesection> that contains two version elements that reference two different versions of a map.

<sitemap>
    <!-- Sitemap title -->
    <title>Sitemap</title>
    <!-- A sitesection with versioned content -->
    <sitesection outputclass="view-toc">
        <topicmeta>
            <navtitle>Versioned Sitesection</navtitle>
            <shortdesc>Short Description</shortdesc>
            <data href="media/portal_icon_navy.png" name="thumbnail"/>
        </topicmeta>
        <!-- Version #1 container -->
        <version>
            <!-- Version details -->
            <topicmeta>
                <!-- Version information that will be visible in the version drop-down menu -->
                <navtitle>v1.0</navtitle>
            </topicmeta>
            <!-- Referenced DITA content -->
            <mapref href="content/map_c_v1_0.ditamap"/>
        </version>
        <!-- Version #2 container -->
        <version>
            <topicmeta>
                <navtitle>v2.0</navtitle>
            </topicmeta>
            <mapref href="content/map_c_v2_0.ditamap"/>
        </version>
    </sitesection>
</sitemap>
basic sitesection with versions

The result is that articles within your versioned map will be accompanied with a dropdown that enables readers to choose between different versions.

Note: To have the version dropdown show on desktop devices, be sure to add outputclass="view-toc" on the <sitesection> element that contains your versioned content.

Readers will be able to see a version number in the breadcrumbs section on the top of the screen.

output of a basic sitesection with versions

When you click the sitesection in the navigation menu, you will not be redirected to the first topic in a map as usual. Instead, you will be presented with a set of tiles. Each tile represents the top-level element in the versioned map. Tiles are accompanied with a dropdown for choosing between different versions.

output of a basic sitesections with versions
Note: The “v” phrase is added automatically before the version number. Therefore, you do not need to add it in the navtitle element of your versions.
Tip: You can version content on different sitemap levels. For more information, see Sitesection with Subsections.

To learn how to add versioned maps to the sitemap, refer to Add Versioned Content to Your Sitemap.