Add Section Tiles

Most important parts of your documentation can be represented with tiles on the Heretto Deploy Portal home page.

Tiles can be linked to sections of different complexity. To learn how to manage different types of sections, see Basic Site Section.

A tile is a clickable box that consists of a title, short description, and icon. On larger screens, tiles are displayed in three columns. On mobile devices, tiles are displayed either in two or in one column depending on the resolution

Figure 1. Tiles Example
tiles that you can see at help.heretto.com

The minimum required to render a tile is a navigational title added within a site section.

  1. Open the sitemap connected to your portal.
  2. Right-click the sitemap element and append it with the sitesection element.
    Figure 2. Appending Operation
    appending sitemap element with sitesection element
  3. Right-click the sitesection element and append it with the topicmeta element.
  4. Right-click the topicmeta element and append it with the navtitle element.
  5. Right-click the topicmeta element and append it with the shortdesc element.
  6. Right-click the topicmeta element and append it with the data element.

Your tile structure has been successfully introduced. Now, edit the contents of the displayed elements.

  1. Edit the navtitle element to display the name that you want.
    1. Hover over the navtitle element and click the gear icon. On the right, the attributes pane appears.
    2. In the top-right corner of the attributes pane, click the pencil icon to edit the contents of the navtitle element.
    3. Edit the contents of the navtitle tag.
      <navtitle>My First Section</navtitle>
    4. Click Save.
  2. Follow the same steps to edit the short description element.

To edit contents of the data element that represents tile's icon, do the following:

  1. Hover over the data element and click the gear icon to open the attributes pane.
    1. Fill in the name attribute with the thumbnail value.
    2. Find the href attribute and click Change to select the icon that you would like to display in a tile.
    data element with proper attributes applied
  2. Append your site section with a proper ditamap file that you would like to link to the created tile.
    Figure 3. Site Section Example
    example of properly prepared site section

    An example of a basic site section. Elements marked in red are responsible for the contents displayed within a tile.

Go to the home page of your Heretto Deploy Portal and refresh it to see the newly created tile.

tile example