Gretyl's Portal

Heretto Help

Show Page Sections

Map Elements Attributes

Assigning attributes changes the properties of elements in a map. These attributes add details and descriptions to your map. This enhances the deliverable with more details. Map element attributes include grouping, which changes how separate topics appear in deliverables.

Edit Map Element Attributes

Edit the attributes of an element in a map to manage its properties.

  1. In the Content Library, double-click a map to open it in the Content Editor.
  2. Hover over an element in the map tree and click the gear icon to opens the element properties pop-up.
    Hovering over an element shows a list of icons, including the information icon which opens the properties window.
  3. In the properties pop-up, do any of the following:
    • To change the element type, select a different option from the Element drop-down menu.
      Changing the type of an element in a map
    • To assign, modify, or remove an attribute, edit the attribute field in the Attribute section.
      Editing DITA attributes of an element in a map
    • To edit the element in the Source Editor, click the pencil button.
      Editing the source code of an element in a map

      For more information, see Source Editor Overview.

Chunk Attribute

Chunk your content to control how topics appear on a page when published.

When you specify a chunking attribute value, it overrides the default chunking behavior, which is to show each topic on its own page. For example, if you have a parent topic with several children, you can use the chunking attribute to specify if the topics appear on a single page or separate pages when publishing to Heretto Portal or HTML.

Here's an example map with some hierarchy:

example map with a parent topic and two child topics

When you publish this map with no chunking attribute applied, the parent topic shows on the page with links to each of the child topics. This HTML example highlights this behavior.

example PDF output of a map with a parent topic and two child topics

When you publish this map with the to-content value for the chunking attribute, the parent topic and each of its children show on the same page. This PDF example highlights this behavior.

example PDF output with a parent topic and two child topics, but with the chunking attribute applied

You can apply the chunk attribute to a single topic or to a map. When you apply a chunk attribute to a topic, the chunking behavior applies only to the topic and any children of that topic. When you apply a chunk attribute to a map, the chunking behavior is established for the entire map.

Collection-Type Attribute

Use a collection-type attribute to define the type of hierarchical relationship parent and children topics have to one another and to determine the way content and related links display when published. The collection-type attribute can be applied to topics or submaps in a map to control the linking behavior between child topics and how the structure of the output displays.
Unordered
Links generate from parents to children and from children to parents.
Family
Links generate from parents to children, from children to parents, and from sibling to sibling. Parent topic shows on a different page than children topics.
Sequence
Links generate from parents to children and from sibling to sibling in sequential order. Parent topic shows on a different page than children topics.
Choice
Links generate from parents to children and from children to parents, but where one child topic is selected to proceed.

Unordered Collection Type

If you're documenting unrelated items that don't follow a specific order, use an unordered collection type. For example, each topic is about a different aspect of a software that is unrelated to the others. In this map, Classic Software is the parent topic and the other topics are children of Classic Software:

example map structure with a parent topic and a few child topics

When published the parent topic contains links to each of the children topics:

example PDF output of a map with a parent topic and a few child topics

Each of the children contains a link to the parent topic, but not to one another:

automatically-generated link added with the collection-type attribute set to "unordered"

Family Collection Type

In a family collection type, all items are related to one another. For example, you have a map discussing troubleshooting strategies for a printer. In this map, Printer Troubleshooting is the parent topic and each of the strategies are children of that parent topic:

example map structure with a parent topic and a few child topics

When published, the parent topic contains links to each of the children topics:

Automatically-generated links in a parent topic added with the collection-type attribute set to "family"

Each of the children topics contains links to the parent topic and all related topics:

automatically-generated links in a child topic added with the collection-type attribute set to "family"

Sequence Collection Type

A sequence collection type is good for information that must be presented in a specific order. For example, you have a series of software installation tasks that need to be completed in order. In this map, Classic Software is the parent topic and each of the procedure topics are children of that parent topic:

example map structure with a parent topic and a few child topics

When published, the parent topic contains numbered links to each of the children topics:

automatically-generated links in a parent topic added with the collection-type attribute set to "sequence"

Each of the children topics contains links to the parent topic and to the previous and next topics in sequence:

automatically-generated links in a child topic added with the collection-type attribute set to "sequence"

Choice Collection Type

A choice collection type is good for information that requires you to choose from two or more options. For example, you are creating a new file in Classic Software and have the option to choose from a blank file, default template, or uploaded template. In this map, Creating a New File is the parent topic and each of the options for creating a file are children of that parent topic:

example map structure with a parent topic and a few child topics

When published, the parent map contains links to each of the children topics:

automatically-generated links in a parent topic added with the collection-type attribute set to "choice"

Each of the children topics contains links to the parent topic, but not to one another:

automatically-generated links in a child topic added with the collection-type attribute set to "sequence"