# Supported Element Attributes

Each element in Paligo can have one or more attributes, which are properties that Paligo can use to apply different characteristics when publishing. A common example is using attributes for including or excluding content (filtering). For example, you could give an element the xinfo:product filter attribute and set its value to Acme 100 (or any other product name). When you publish your content, you can then instruct Paligo to include or exclude any content that has the xinfo:product attribute with Acme 100 as the value.

Filters are just one example of how you can use attributes. There are many other uses too, for example, you can use the role attribute to set Paligo to include a class name in an HTML output.

To learn how to add an element attribute, see Add Attributes to an Element.

To learn about the different element attributes you can use, see Supported Attributes and their Uses.

## Supported Attributes and their Uses

You can use the following attributes in Paligo:

• Attributes included in DocBook 5.0

Paligo is based on DocBook 5.0 and so supports most of the attributes that are included in that content model. But there are some differences to consider. Paligo uses the <article> element for publications and <section> for topics, so it is important to remember that when setting attributes on those elements. Also, Paligo does not support other root-level elements such as <book> and <set>.

### Note

The role attribute is a DocBook 5.0 attribute that allows any text as its value. In Paligo, the role attribute is used in specific ways, and the value is an important part of the functionality. To learn about the supported role values, see Role Attribute Values in Paligo.

• label

Use on a topic's section element to prevent it being numbered in a PDF output (a value of 0 means no numbering).

• xinfo:appid

Use on the section element when setting up context-sensitive help (see Context-Sensitive Help).

• xinfo:chunk

Use on the section element to instruct Paligo to keep a topic as a separate page in HTML outputs (see Create Subsections).

• xinfo:country

Use to filter content by country (see Filters (Profiling) and Filter Attributes).

• xinfo:keep-together

Use to control the flow of elements over two pages in PDF outputs (see Soft Page Breaks).

• xinfo:keep-with-next

Use to control the flow of elements over two pages in PDF outputs (see Soft Page Breaks).

• xinfo:market

Use to filter content by market (see Filters (Profiling) and Filter Attributes).

• xinfo:outname

Use on the section element to control the URL for the topic when it is converted into a page for HTML outputs. The value that you enter is used as the URL (see Topic File Names (HTML).)

• xinfo:pagebreak

Use to set a hard page break in PDF outputs (see Hard Page Breaks).

• xinfo:product

Use to filter content by product name (see Filters (Profiling) and Filter Attributes).

• xinfo:proglang

Use to filter content by programming language (see Filters (Profiling) and Filter Attributes).

• xinfo:version

Use to filter content by version (see Filters (Profiling) and Filter Attributes).

To learn how to give an element an attribute, see Add Attributes to an Element.

### Note

Paligo also supports some "internal attributes" such as xinfo:image, xinfo:resource, and xinfo:text. These "internal attributes" are created and maintained automatically by Paligo and are used for allocating IDs to elements. You should not edit them.

## Role Attribute Values in Paligo

You can use the role attribute with specific values to set Paligo to provide particular functionality. There are many possibilities, including adding class names to HTML outputs, adding extra-responsive features to HTML tables, and controlling wrapping in PDFs.

The following list shows the specific role attribute values that Paligo uses for various features. We have included cross-references to the sections that describe those features:

• column-count

Use to set the number of columns in a sidebar element in PDFs (see Multi-Columns for PDF Content).

• column-gap

Use to set the amount of space between columns in a sidebar element for PDFs (see Multi-Columns for PDF Content)

• extra-responsive

Use on table elements to set them to add a sticky header and column filter to a table for HTML5 outputs (see Column Filter and Sticky Header for Tables).

• font-size

Use to set the size of the lettering on a verbatim element, such as programlisting (see Verbatim (code and software)).

• <free text>

Can be used on any element and you can enter any text as the value, for example, role: online-image. The value is used as a class name in HTML outputs. This only applies if the HTML layout is set to include the role attribute as a class name, see Classes and attributes.

• img-thumbnail

Use on mediaobject elements to set them as small "thumbnail" images in HTML outputs (see Thumbnail Images).

• img-thumbnail-reset

Use on mediaobject elements to prevent them from being presented as small "thumbnail" images in HTML outputs (see Thumbnail Images).

• multi-publication-portal

Use on article elements when publishing multiple publications to the same help center (see Multiple Publications in the Same Portal).

• notintoc

Use on section elements to prevent a topic from appearing in the table of contents in PDF outputs (see PDF Layout Editor Options).

• portal-category

Use on the section element to create category panels for topics in HTML help center outputs (see Topics for Category Panels).

• promoted-content

Use on the section element to set a topic as "featured content" (see Topics for Featured Content).

• reuse-range

Use on procedure and orderedlist elements when you want the steps/items to continue the numbering sequence of a previous procedure or list (see Reuse Items in a List).

• swagger-topic

Use on the section element when embedding Swagger/Open API content in Paligo for publishing to:

• top-nav-link

Use on the section element to add a link to a topic from the top-navigation menu (see Add Top-Navigation Links to Topics).

• wrap-option

Use on verbatim elements, such as programlisting, to control line wrapping (see Verbatim (code and software).

To learn how to add an element attribute, see Add Attributes to an Element.