Getting Started with Paligo

Creating Lists and Procedures

To get the full benefit of Paligo, you should try to follow the principles of structured authoring, and use the proper type of list depending on the content you are creating. This is often called semantic structure.

So for instance, if you are writing an instruction, use the procedure element. If you are just writing a list enumerating tools, principles, or the like, use an orderedlist, and so on.

Check out this video for a quick overview:

There are also a number of specialized lists, here are just some examples:

  • Variablelist: a list of terms and definitions.

  • Calloutlist: For use with code elements, to place callout "bugs" and link to the corresponding description in the list. See here for more information about how to use this type of list: Callouts.

    This can be useful for code examples as it is also interactively linked. Clicking a callout highlights the callout bug in the code:

  • Qandaset: This is a "Q & A" list. I.e a list of questions and answers, useful for quizzes, FAQs, etc.

  • Simplelist: a list type with many options for creating lists of different kinds, using attributes to decide how it works. See more here: Simplelist.

To create a list or procedure
  1. Create a list of the type you need. 

    Tip

    You can of course use the Element context menu where you have all elements. But you also have convenient toolbar icons for the most common lists:

    You can also use shortcut keys:

    AltL

    Create itemizedlist (bullet list)

    AltShiftL

    Create orderedlist (numbered list)

    AltShiftP

    Create procedure

  2. Simply hit Enter to add new steps/list items.

  3. If you need to include any auxiliary information in a step or list item, such as an image, a separate paragraph, etc, use the arrow keys or mouse to move out of the para in the step or list item. Add the new element after the para element.

Modifying or converting lists

Paligo makes it very easy to work with lists and procedures using the toolbar icons and keyboard shortcuts.

If you have created a list, but decide that you created the wrong type, you want to indent or outdent lists, split or merge them, or if you have started creating a set of paragraphs, and then decide you want a list instead, it's easy to fix:

  1. To convert one list type to another:

    1. simply place the cursor in the list. Either inside a para element, or directly at the top of the list (so that the list is the current element in the Structure Menu:

    2. Click the toolbar icon for the type of list you want to convert to, or use the keyboard shortcut for the list type (same as above).

      You will see a dialog to confirm if you want to convert the list.

  2. To create a list from a set of paragraphs:

    1. Place the cursor in the first para element.

    2. Click the toolbar icon for the list you want to create from the set of paragraphs.

      The cursor will automatically jump to the next para element if there is one, allowing you to just keep clicking until you have created a list of them all.

      You can also use the list keyboard shortcuts as described above instead.

  3. To indent list items or steps:

    1. Place the cursor in the list item you want to indent (except the first one, since there would otherwise not be anything to indent the items under).

    2. Click the Indent toolbar icon  (or use the shortcut keys AltT)

    3. Repeat for any items you want to indent.

  4. To outdent a sub list:

    1. Place the cursor at the top element of the nested list.

    2. Click the Outdent toolbar icon  (or use the shortcut keys AltShiftT)

  5. To move a list item up or down:

    1. Either use the Move commands in the Structure menu, or 

    2. place the cursor in the list item element (not in the para, but in the actual list item), and use the keyboard shortcuts (AltShift to move down, AltShift to move the list item up.

  6. To split a list:

    1. Place the cursor between two list items or steps.

    2. Click the Split toolbar icon .

  7. To merge two lists:

    1. Place the cursor at the top of the first list.

    2. Click the Merge toolbar icon