Site Section with Subsections

Site sections can contain up to five levels of nested subsections.

Tip: Site sections with subsections are useful if you publish complex content that may require additional levels of navigation.

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 subsections
The result of this structure is a site section that is displayed in the left pane menu. When you click on the sitesection, you can see two clickable tiles that represent its subsections.
Note: To see how to edit contents displayed in a tile, go to Add Section Tiles.
site section with subsections - online output example

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>
site section with content and subsections

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.

site section with content and subsections - online output example