Site Section with Subsections
Site sections can contain up to five levels of nested subsections.
The following example shows the site output results of a sitemap with a site section that contains two subsections. “Subsection A” references a DITA map and “Subsection B” references three DITA topics.
<sitemap>
<!-- Sitemap title -->
<title>Sitemap</title>
<!-- A sitesection with subsections -->
<sitesection>
<topicmeta>
<navtitle>Site Section with Subsections</navtitle>
<shortdesc>Short Description</shortdesc>
<data href="media/portal_icon_yellow.png" name="thumbnail"/>
</topicmeta>
<!-- Subsection #1 -->
<sitesection outputclass="view-tiles">
<topicmeta>
<navtitle>Subsection A</navtitle>
<shortdesc>Short Description</shortdesc>
<data href="media/portal_icon_yellow.png" name="thumbnail"/>
</topicmeta>
<mapref href="content/map_b.ditamap"/>
</sitesection>
<!-- Subsection #2 -->
<sitesection outputclass="view-tiles">
<topicmeta>
<navtitle>Subsection B</navtitle>
<shortdesc>Short Description</shortdesc>
<data href="media/portal_icon_yellow.png" name="thumbnail"/>
</topicmeta>
<topicref href="content/concept_a.dita"/>
<topicref href="content/concept_b.dita"/>
<topicref href="content/concept_c.dita"/>
</sitesection>
</sitesection>
</sitemap>
Site Section with Content and Subsections
This example shows a sitemap with a site section that references a DITA topic and contains two subsections. The first site section references a DITA topic. “Subsection A” references a DITA map and “Subsection B” references a DITA map and a DITA topic.
<sitemap>
<!-- Sitemap title -->
<title>Sitemap</title>
<!-- A basic sitesection that renders as a tile on the home page -->
<sitesection>
<!-- Site section details container -->
<topicmeta>
<navtitle>Basic Site Section</navtitle>
</topicmeta>
<!-- Referenced DITA content -->
<topicref href="content/concept_a.dita"/>
<!-- Sitesection tile #1 -->
<sitesection>
<topicmeta>
<navtitle>Subsection A</navtitle>
</topicmeta>
<mapref href="content/map_a.ditamap"/>
</sitesection>
<!-- Sitesection tile #2 -->
<sitesection>
<topicmeta>
<navtitle>Subsection B</navtitle>
</topicmeta>
<mapref href="content/map_b.ditamap"/>
</sitesection>
<!-- Referenced DITA content -->
<topicref href="content/concept_b.dita"/>
</sitesection>
</sitemap>
The result is a site section that is displayed in the left pane menu together with its child items: topics and site sections. While in case of topics you can see their content, subsections are represented with clickable tiles.