Sitesection with Versions
Versioned sitesections can include multiple versions of the same content.
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>
The result is that articles within your versioned map will be accompanied with a dropdown that enables readers to choose between different versions.
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.
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.
navtitle
element of your versions.To learn how to add versioned maps to the sitemap, refer to Add Versioned Content to Your Sitemap.