Use the checklists feature to add a list of checkboxes to your HTML5 help center, Zendesk, or PDF publications. The checklists work differently, depending on the type of publication.
In this article, we explain:
-
How the checklists work in the different types of output, see Checklists in HTML5 Help Center and Zendesk and Checklists in PDF.
-
How to create checklists, see Create a Checklist.
-
How to set up your checklist so that it is pre-checked in PDF outputs, see Create a Checklist.
Note
Checklists are only supported when publishing to PDF, HTML5 help centers, and Zendesk. They are not supported when publishing to other types of output, including other types of HTML.
In HTML5 and Zendesk publications, each list item has a container with a clickable checkbox and a close option that removes the step from view.
Where (1) is the clickable checkbox, (2) is the close option, and (3) is the refresh option. The refresh option returns the list to its original state, with all boxes unchecked and every checkbox in the list made visible.
To find out how to make your own checklists, see Create a Checklist.
Note
-
Make sure that your checklist has an
xml:id
attribute and value for theitemizedlist
root element. It will only work properly if it has an id. To find out how to generate an id, see IDs for Cross-References. You can also use the Editor Settings to set Paligo to generate ids for all lists automatically. -
This feature uses JavaScript that, in some browsers like Safari, will only run if published on a web server. So if you test it locally, you may need to try another browser first. But once published, it will work on all modern browsers.
-
If you are publishing to Zendesk, make sure that in Zendesk's Guide Admin settings, the Display unsafe content option is turned on. The HTML tags needed for checklists are not included in Zendesk's list of "safe tags".
In PDF publications, checklists appear as a list with a checkbox for each item. The checkbox is clear by default, so that if your readers print out the PDF, they can physically check the boxes as they complete each item. But if you prefer, you can set the boxes to be pre-checked, which can be a good idea if you only want to indicate a checklist symbolically.
To find out how to create a checklist and pre-set the checkboxes for PDF, see Create a Checklist.
Use the checklist toolbar to create a checklist in a topic.
When you select the checklist toolbar icon, Paligo adds the first item in a checklist. You can add text to that item and when you press Enter at the end, it will automatically create the next checklist item. The checklist is actually an itemizedlist
with a role
attribute of checklist
. So you could also make one by adding an itemized list (i.e. bullet list or undordered list) and giving it a role
attribute with checklist
as the value.
To set the list to have pre-checked checkboxes for PDF outputs, select the itemizedlist element in the element structure menu. Then add the value checked to the role
attribute. Use a semicolon as a separator, for example:
A checklist would usually be on the first level only, but it is possible to have nested checklists too. Each checklist item can also contain any other content just like a regular list, such as images, other lists, tables, etc. For these, add the block element, such as a list, inside the listitem
.
To end the list, position the cursor outside the the itemizedlist and then you can add another block element, such as a para
. This approach is common to all lists.
You can then add extra content after your checklist, if needed. Save your topic when you have finished.
Note
The checklist functionality only works if the itemizedlist
element for the checklist has an xml:id. To find out if it does, select the itemizedlist
element in the element structure menu and then look at the element atttibutes.
If there is an xml:id with a value, the list is fine. If there is no xml:id, you can add one. To do this, we recommend that you select itemizedlist in the elementstructure menu, then select the Generate id option.
Comments
0 comments
Article is closed for comments.