Admonition Styling (PDF)

Select Layout in the top menu.

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

Select the Admonitions category and then select the General subcategory.

Choose whether the admonitions will use graphical icons.

Set Use graphics in admonitions to:

Choose whether Paligo will add a title to any admonition that does not already have a title. Set Use auto-title in admonitions to:

Set the Default font family for admonition text. This is the style of lettering for each admonition's main body content.

Choose a typeface from the list of available fonts.

Set the Default font size for admonition text. This is the size of the main body text in each admonition.

Set the Default font size for admonition title. This is the size of the text in each admonition's title element.

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

Set the left and right margins for the main body text of your admonitions.

Set the margins for the admonition titles.

Use the following settings to set a background color for each type of admonition.

Use the following settings to set the text color for the various types of admonition.

Again, clear the Use default color checkbox for each color that you want to set. Use the color box to display the color selector and choose the color you want.

Select Save.

Select Layout in the top menu.

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

Select the Admonitions category and then select the Graphical subcategory.

Use Background color for Graphical admonitions to choose one color for all graphical admonitions.

Use these settings to define the amount of space above and below graphical admonitions:

For all of these settings, enter a scaling value. Paligo uses the value in relation to the size of body text in your PDF. For example, if you enter 2.5, Paligo will add spacing that is 2.5 times bigger than the body text size. If you enter 0.5, Paligo will add spacing that is half the size of the body text.

Paligo will try to apply the preferred amount of space, but in some cases may need to use less. For example, a page break might result in Paligo applying different spacing.

Use the following settings to define the amount of space inside the graphical admonitions. This is the "padding".

Use these settings to set margins for graphical admonitions. The margins apply to the whole admonition, not just the content inside it.

For both settings, enter a value and the units of measurement, for example, 2cm.

Use the Margin-left for graphical admonition icon setting to control the position of the admonition icons. Enter a value and the units of measurement, for example, 1.5em. Paligo applies the margin from the default position of an icon.

Set the Border width for graphical admonitions. This is the thickness of the border line around the edge of the admonition box. It applies to all types of admonition, such as note, caution, and warning.

Enter a value and the units of measurement, for example, 0.5pt.

Choose the Border style for graphical admonitions from the list. The options are:

Set the Border color for graphical admonitions.

Again, to choose your own color, clear the Use default color checkbox and then use the color selector to set the color.

Use the Border radius for graphical admonitions setting to set the amount of curve on the corners of the border box. Set it to 0pt for no curves or enter a value and a unit of measurement to add curves. For example, you could use 10pt to give the box curved corners.

Use Admonition icon width to set the size of the admonition icons.

Enter a value and the units of measurement, for example, 24pt. Paligo will set the width of the icon image container and will scale the image to fit. When it scales the image, Paligo keeps the aspect ratio so that the image is not stretched in height or width.

Use the following settings to upload an icon graphic for each type of admonition. We recommend that you use graphics that are square and the same size (or close to) that you want them to be in your output.

For each setting, select the Upload button to display an image upload dialog. Drag the image file on to the dialog.

Select Save.

Select Layout in the top menu.

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

Select the Admonitions category and then select the Nongraphical subcategory.

Choose whether Paligo should allow an admonition to have a user-defined title and an auto-generated title.

In the General settings for admonitions, there is a Use auto-title in admonitions setting. When it is set to Activate, Paligo will generate automatic titles for your admonitions, such as "Note" and "Caution". The auto-generated titles will replace any existing titles, by default. But if you prefer, you can set Paligo to include both auto-generated titles and manually-added titles.

Example of an admonition that has an auto-generated title (Caution) and a user-defined title (Risk of injury)

Set the Render label on a separate line for nongraphical admonitions setting to:

Use Background color for nongraphical admonitions to choose one color for all nongraphical admonitions.

Set the amount of space above (before) and below (after) the nongraphical admonitions.

Enter an amount, relative to the body font size in the following fields. For example, 1.2. Do not include any units of measurement as the size is always relative to the body font size.

Set the amount of padding for nongraphical admonitions. The padding is the internal margin between the content in the admonition and the boundaries of the admonition box.

Enter an amount and the units of measurement in the following fields:

Use the margin settings to set left and right indents for nongraphical admonitions. The margins apply to the admonitions as a whole, not the content inside it.

For both settings, enter a value and the units of measurement, for example, 2cm.

Select Save.