Skip to main content

List Styling (PDF)

For PDF outputs, use a PDF Layout to style your lists and procedures. Each PDF Layout has a Lists category that contains subcategories. There are subcategories for General (applies to all lists), Unordered lists (bullet lists), Ordered lists (numbered lists), Simple lists, and Procedures.

Close-up of PDF Layout editor's Lists settings. There is a Lists category with General, Unordered lists, Ordered lists, Simple lists, and Procedures subcategories.

We recommend that you start by styling the General list settings. Then use the other subcategories to style the specific types of list, such as procedure and unordered list.

Tip

When styling lists, it is a good idea to create a test topic that contains each type of list. Then use the preview feature in the Layout Editor to see the effect of any changes. In the Layout editor, select Choose document and select your test topic. When you make a change to a list setting, select Save and then Update preview. The preview will show the effect of the change you made.

For details on the preview feature, see Preview a PDF Publication in Layout Editor).

PDF Layout Editor. There are callout boxes around the preview area, the Choose document button and the Update preview button.

Layout editor. The highlighted frames show where you can load a topic and preview any changes you make.

Set the General Preferences for Lists

PDF Layouts have General list settings that apply to many types of list. For example, if you set the spacing in the General list settings, the same spacing will apply to ordered lists, bullet lists, and procedures. The idea is that you set your General preferences for all lists and then use the other subcategories to define the settings for each type of list.

To set your preferences for all lists:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select the Lists category and then select the General subcategory.

  4. Set the amount of space above and below each list. This spacing applies to entire lists, not the list items inside the lists.

    Use:

    • Margin before list blocks to set the amount of space above each list

    • Margin after list blocks to set the amount of space below each list.

    For both settings, enter a value that is relative to the body font size, for example, 1.5 to add a space that is 1.5 times larger than the font size. Do not include units of measurement, enter the value only.

  5. Set the amount of space above and below each list item in lists that have normal list spacing.

    Element attributes panel. The orderedlist element is selected. It has the spacing attribute with the value set to normal.

    Use:

    • Space before list items in normal lists to set the space above each list item

    • Space after list items in normal lists to set the space below each list item.

    For both settings, enter a value that is relative to the body font size, for example, 1.5 to add a space that is 1.5 times larger than the font size. Do not include units of measurement, enter the value only.

  6. Set the amount of space above and below each list item in lists that have compact list spacing.

    Element attributes panel. The orderedlist element is selected. It has a spacing attribute and its value is set to compact.

    Use:

    • Space before list items in compact lists to set the space above each list item

    • Space after list items in compact lists to set the space below each list item.

    For both settings, enter a value that is relative to the body font size, for example, 1.5 to add a space that is 1.5 times larger than the font size. Do not include units of measurement, enter the value only.

  7. Choose your preferred behavior for the Space-after (optimum) for paragraphs inside list items or procedure steps setting. By default, this setting applies to block elements inside a list item or step, with the exception of the last block element. For example, if you have a step that contains three paragraphs, the space-after will apply to the first and second paragraphs, but not the third. This is for compliance with the XSL FO specification.

    space-after-apply-selected-space-after-property.png

    List on the left has space after third paragraph inside a list item. The list on the right does not have a space after the third paragraph.

    Use the Apply selected space after property for last block child elements in lists setting to control the behavior.

    Choose:

    • Enabled to apply the space-after (optimum) to all block elements inside a step or list item, including the last block.

    • Disabled to keep the default behavior, where the space-after (optimum) does not apply to the last block inside a step or list item.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

  8. Set the preferred amount of space after paragraphs and other block elements that are inside a list item or step. Enter the amount and its units of measurement in the Space-after (optimum) for paragraphs inside list items or procedure steps field. For example, 0.6em.

    Note

    By default, Paligo does not apply the spacing after the last block element inside the list item or step. To change this behavior, set Apply selected space after property for last block child elements in lists to Enabled (see previous step).

  9. Set the Left margin for list blocks. This is an indent to move the list in from the regular starting position. Enter the amount and include the units of measurement, for example, 3em.

    A paragraph that is left-aligned followed by a list and another paragraph. The list is indented on the left by 5em. There are two-headed callout arrows to highlight the indentation of the list.

  10. Set the Font family for list titles. This is the style of lettering for each list's title element.

    Choose a typeface from the list of available fonts.

    Note

    The effect of font-related settings, such as weight and style, varies depending on the font family.

    Note

    By default, lists do not have a title element, but you can add one manually if required (see Add Elements ).

  11. Set the Font size for list titles. This is the size of the text in each list's title element (if a title element is in place).

  12. Set the Font weight for list titles. This sets the boldness of the font. The effect varies depending on what font-family is set for list titles.

  13. Set the Font style for list titles.

    Choose from:

  14. Set the Font variant for list titles to Normal for regular sized, mixed case letters or Small-caps for smaller, upper-case letters.

  15. Use Color for list titles to apply a custom color to the text in the title.

    1. Clear the Use default color checkbox to select a color of your own choice.

    2. Set the color either by:

      • Entering an RGBA code for the color you want (1).

      • Selecting the Color square to display the color selector (2).

        1. Choose the color with the spectrum bar (3).

        2. Control the transparency with the opacity bar (4).

        3. Choose the color shade with the main color panel (5).

        Color selector. There is a field for entering an rgba value. It is labelled 1. There is a black square labelled 2. There is a popup dialog that contains three sections. The sections are labelled with numbers. Label 3 points to a narrow bar that shows the colors of the spectrum. Label 4 points towards an opacity bar ranging from black to transparent. Label 5 points to a color selector with various shades of a single color.

  16. Set the Capitalization for list titles. This controls whether title characters are shown in upper case, lower case, or a combination of the two.

  17. Set the Letter-spacing for list titles. This is the amount of horizontal spacing between each letter in the title.

    To increase the amount of spacing, enter:

    • A relative amount and units of measurement, for example, 0.2rem

    • An absolute amount and units of measurement, for example, 1px

    To decrease the amount of spacing, enter a negative relative or absolute amount, for example, -1px.

  18. Select Save.

You have now defined the default settings for lists. If you want different styling for each type of list, define that styling in the Unordered lists, Ordered lists, Simple lists, and Procedures subcategories. Any settings you define in those subcategories will take priority over the settings in the General subcategory.

When you use this Layout to publish to PDF, Paligo will apply your choices when it creates the PDF output file.

Style List Labels Individually

You can use the role attribute to adjust the list label width and alignment for individual lists. This way you override the default Layout Editor settings.

If you have sublists, these will inherit the width and alignment from the parent list (but can be overridden with the role attribute if needed).

Note

The qandaset also have labels that will inherit the label alignment if there is an ancestor list.

However, it will not inherit the width, since width of the list label for the qandaset has a complex logic to set the width depending on type, descending labels and more.

You cannot set the default alignment or width for qandaset in the Layout Editor, but you can use the role attribute to set the label alignment for an individual quandaset: role=”label-align:end;”

To set the list label for an individual numbered list:

  1. Select the topic or component in the Content Manager to open it in the Editor.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternatively, you can Create a Topic and edit that.

  2. Position the cursor in the numbered list.

  3. Select the orderedlist in the Element Structure Menu and choose Go to element.

  4. Add the role attribute in the Element Attributes Panel.

    Adjust_List_Label_Width_Alignment_small.jpg

  5. Enter label-width:2em;label-align:end; as value.

  6. Change the number in label-width:2em; to adjust the space between the list label and list item text.

    The default width is 1.75em.

  7. Replace "end" in label-align:end; to adjust the list label positioning.

    The default alignment is start.

  8. Select Save. Save icon.

Style an Ordered (Numbered) List

For PDF outputs, use your PDF Layout to style the ordered lists in your content.

Note

Ordered lists are affected by the styles in the General and Ordered Lists subcategories of the Lists settings.

To learn about the General settings, see Set the General Preferences for Lists.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select the Lists category and then select the Ordered lists subcategory.

  4. Use The default width of the label (number) in an ordered list setting to define the margin between the number and the text for the list item.

    Ordered list. There is a large amount of space between the numbers and the text for each list item. A double-headed callout arrow shows that this space is the space that is affected by the setting.

    Enter the margin value as an integer or a decimal number, followed by its unit of measurement. You can use any of these units:

    • cm (centimeters)

    • mm (millimeters)

    • in (inches)

    • pt (points)

    • pc (picas)

    • px (pixels)

    • em (relative to font size)

    Examples: 1.5em, 12pt, 1cm.

    Note

    Ordered lists can also have their label styling defined in an attribute on each individual list. The attribute styling takes priority over the Layout settings (see Style List Labels Individually).

  5. Set the Default alignment of the label (number) in an ordered list. This alignment applies in the space from the left margin of the ordered list block to the text of each entry. For example, if you choose End, the number will move to the right margin of the space allocated to the "list label" (which you can control by using The default width of the label (number) in an ordered list setting.

    Choose from:

    Note

    Ordered lists can also have their label styling defined in an attribute on each individual list. The attribute styling takes priority over the Layout settings (see Style List Labels Individually).

  6. Choose whether you want to use language-specific numbering.

    By default, Paligo uses 1,2,3, and a, b, c for sub-procedures. Some languages use different characters for numbering. Use the Render ordered list and procedure item labels in language-specific number system setting to control which numbers and letters are used.

    Choose:

    • Enable to use language-specific numbers and letters

    • Disable to use 1,2, 3, and a, b, c numbers and letters

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

  7. Select Save.

When you use this Layout to publish to PDF, Paligo will apply your choices.

Style an Unordered (Bullet) List

For PDF outputs, use your PDF Layout to style the unordered lists in your content. Unordered lists are also called bullet lists or itemized lists. They use the itemizedlist element in Paligo XML (see Create a List or Procedure).

Note

Bullet lists are affected by the styles in the General and Unordered lists subcategories of the Lists settings. The Unordered lists settings take priority over the General settings.

To learn about the General settings, see Set the General Preferences for Lists.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select the Lists category and then select the Unordered lists subcategory.

  4. Set the margin between the bullet point and the text for the list item.

    Bullet list. There is a large amount of space between the bullet points and the text for each list item. A double-headed callout arrow shows that this space is the space that is affected by the setting.

    Enter the margin and its units of measurement in The default width of the label (bullet) in an itemized list field. For example, enter 1.5em to make the margin 1.5× the width of the body text character size.

  5. Set the alignment of the bullet point. This alignment applies in the space from the left margin of the itemizedlist block to the text of each entry. For example, if you choose End, the bullet point will move to the right margin of the space allocated to the "list label" (which you can control by using The default width of the label (bullet) in an itemized list setting.

    Choose from:

  6. Set the color of the bullet point. For this, use The color of the label (bullet) in an itemized list setting.

    1. Clear the Use default color checkbox to select a color of your own choice.

    2. Set the color either by:

      • Entering an RGBA code for the color you want (1).

      • Selecting the Color square to display the color selector (2).

        1. Choose the color with the spectrum bar (3).

        2. Control the transparency with the opacity bar (4).

        3. Choose the color shade with the main color panel (5).

        Color selector. There is a field for entering an rgba value. It is labelled 1. There is a black square labelled 2. There is a popup dialog that contains three sections. The sections are labelled with numbers. Label 3 points to a narrow bar that shows the colors of the spectrum. Label 4 points towards an opacity bar ranging from black to transparent. Label 5 points to a color selector with various shades of a single color.

  7. Set the size of the bullet icon.

    Enter the value and the units of measurement in The size of the label (bullet) in an itemized list field. For example, 1.4em.

    Note

    Increasing the size of the bullet point can cause the text in the list item to become misaligned with the bullet point. For this reason, we recommend that you only change the bullet size by a small amount.

  8. Set the amount of space between the items in the bullet list.

    Enter the value and the units of measurement in the Line height of the label (bullet) in an itemized list field. For example, 2em.

  9. Set the style of Bullets for each level. Enter the terms for the style of bullets at each level and separate them with commas. For example:

    disk, circle, square

    This means that the top-level of a bullet list will use a disk, the second level will use a circle, and the third level will use a square.

    A three-level bullet list. The top level has a disk as the bullet. The second level has a circle (outline) as a bullet. The third level has a square as the bullet.

    You can use the following bullet types: none, disk (bullet), circle (white bullet), square (black small square), white small square, endash, emdash, +, -, and most of the characters in the Zapf Dingbats font family. You can copy the character from https://www.unicode.org/charts/PDF/U2700.pdf. Do not use the code, just copy the actual icon and paste it into the field on the Layout.

    Close-up of Bullets field. It contains the word circle followed by a comma, then then a scissors icon copied from the unicode standard. The scissors are followed by a comma and then there is a star icon, also copied from the unicode standard.

  10. Select Save.

When you publish with this Layout, Paligo will apply your choices to the bullet lists in your PDF output.

Style a Simple List

Use the settings in your PDF Layout to style simple lists for PDF outputs. Simple lists are lists that you create by inserting the simplelist element, where each list item is a member.

Note

The simple list settings only apply to simple lists that have the type attribute with a value of inline.

To style a simplelist for PDF outputs, use the settings on your PDF Layout.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select the Lists category and then select the Simple lists subcategory.

  4. Set the Simplelist inline separator. This is the character that will appear between each item (member) in the list. By default, Paligo uses a comma.

    Either:

    • Leave the default character, a comma, in place

    • Enter a different character to use instead of the comma

    • Clear the field completely to set the Layout to inherit the inline separator from the base Layout.

      You can learn about Layouts inheriting their values from Base Layouts in Layout Relationships - Base, New, Duplicate.

  5. Set the Simplelist inline separator length. This defines the amount of space between each list item (member) in the list.

    A paragraph with a simplelist. The list items are displayed horizontally and there are large spaces between each item in the list. Callout arrows point at the spaces.

    Enter a value and its units of measurement, for example, 8pt. You can also use relative values, such as em.

  6. Select Save.

When you publish with this Layout, Paligo will apply your choices to the simple lists (that are set to type: inline) in the PDF output.

Style a Procedure

For PDF outputs, use your PDF Layout to style the procedures in your content.

Note

Procedures are affected by the styles in the General and Procedures subcategories of the Lists settings. The Procedures settings take priority over the General settings.

To learn about the General settings, see Set the General Preferences for Lists.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select the Lists category and then select the Procedures subcategory.

  4. Set the margin between the number and the text for the step.

    Procedure. There is a large amount of space between the numbers and the text for each step. A double-headed callout arrow shows that this space is the space that is affected by the setting.

    Enter the margin and its units of measurement in The default width of the label (number) in a procedure field. For example, enter 1.5em to make the margin 1.5× the width of the body text character size.

  5. Set the Default alignment of the label (number) in a procedure. This alignment applies in the space from the left margin of the procedure block to the text of each entry. For example, if you choose End, the number will move to the right margin of the space allocated to the "list label" (which you can control by using The default width of the label (number) in a procedure setting.

    Choose from:

  6. Set the Font weight for procedure step number. This is the line thickness for the step number.

  7. Choose whether you want Numbering for a single-step procedure.

    By default, a procedure with a single step will use a bullet point instead of a number. If you prefer, you can set it to use a number.

    Choose from:

    • Enable to use a number

    • Disable to use a bullet point

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Note

    Lists and procedures are designed to have many steps. If you have a single-step list or procedure, consider making it a regular paragraph instead.

  8. Set the Font family for procedure titles. This is the style of lettering for the procedure's titleelement.

    Choose a typeface from the list of available fonts.

    Note

    By default, procedures do not have a title element, but you can add one manually if required (see Add Elements ).

  9. Set the Font size for procedure titles. This is the size of the text in the procedure's title element (if a title element is in place).

  10. Set the Font weight for procedure titles. This sets the thickness of the characters in the procedure titles.

  11. Set the Font style for procedure titles.

    Choose from:

  12. Set the Font variant for procedure titles to normal for regular sized, mixed case letters or small-caps for smaller, upper-case letters.

  13. Use Color for procedure titles to apply a custom color to the text in the title.

    1. Clear the Use default color checkbox to select a color of your own choice.

    2. Set the color either by:

      • Entering an RGBA code for the color you want (1).

      • Selecting the Color square to display the color selector (2).

        1. Choose the color with the spectrum bar (3).

        2. Control the transparency with the opacity bar (4).

        3. Choose the color shade with the main color panel (5).

        Color selector. There is a field for entering an rgba value. It is labelled 1. There is a black square labelled 2. There is a popup dialog that contains three sections. The sections are labelled with numbers. Label 3 points to a narrow bar that shows the colors of the spectrum. Label 4 points towards an opacity bar ranging from black to transparent. Label 5 points to a color selector with various shades of a single color.

  14. Set the Capitalization for procedure titles. This controls whether characters are shown in upper case, lower case, or a combination of the two.

  15. Set the Letter spacing for procedure titles. This is the amount of horizontal spacing between each letter.

    To increase the amount of spacing, enter:

    • A relative amount and units of measurement, for example, 0.2rem

    • An absolute amount and units of measurement, for example, 1px

    To decrease the amount of spacing, enter a negative relative or absolute amount, for example, -1px.

  16. Select Save.

When you publish with this Layout, Paligo will apply your chosen settings.

Change the Bullet Icon in a List (PDF)

For PDF outputs, you can swap out the regular bullet "disc" character for another character. For instructions, see Style an Unordered (Bullet) List.

Change the Spacing in a List (PDF)

For PDF outputs, use the PDF Layout to change the spacing in and around a list. This includes margins, space above and below the list as well as spacing above and below each list item or step. For details, see List Styling (PDF).

Change the Title Styling for Lists (PDF)

For PDF outputs, use the PDF Layout to change the styling of list titles and procedure titles. For details, see List Styling (PDF).

Control the Numbering in Lists

To control the numbering in ordered lists, use the following attributes:

  • To start an ordered list at a specific number, select the orderedlist element and give it the startingnumber attribute. Set the value to the starting number you want. For details, see Set Starting Number.

  • To get an ordered list to continue its numbering from the previous ordered list, select the orderedlist element and give it the continuation attribute. Set the value to continues. For details, see Set Starting Number.

  • To get a procedure to continue the numbering from a parent procedure, select the procedure element and give it the role attribute. Set the value to reuse-range. This is useful if you want to reuse a procedure inside another procedure. For example, if you have some common steps saved in an informal topic and you insert the informal topic into another procedure.

    For details, see Reuse a Sequence of List Items.