Skip to main content

Create a Task

Use task elements to create a more formal structure for step-by-step procedures, where there is a task title as well as the procedure. You can also add other task-related elements.

To create a task:

  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 at a valid position for a task element.

    This is similar to other types of lists, where the cursor has to be between block elements, for example, after a para element but before the next para element.

    Topic that has a title and two para elements in it. A callout arrow is pointing to the cursor position which is between the two para elements.
  3. Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.

    Element context menu shows a search field and a list of elements that are valid at the current position.
  4. Enter task and select it.

    Paligo adds a task element. It has a title element and a procedure element with a step inside it.

    A topic with a task element added. Inside the task element, there is a title element for the task and a procedure element with a single step.
  5. Enter the text for the task title and the procedure steps.

    To add another step, press Enter at the end of the currently selected step.

    You can also add other elements, for example, you might want to add a para element for some text between the task title and the procedure. To do this, place the cursor at the end of the title and press Enter. You can then use the element context menu to add other elements.

  6. To add a tasksummary element, position the cursor inside the task structure, between two block elements and use the Element Context Menu to add a tasksummary element.

    If the tasksummary element is not available, the cursor is not in the correct position.

  7. Position the cursor inside the tasksummary element, and use the Element Context Menu to add elements.

    This could be one or more para elements for text, or you could add other types of content structure such as itemizedlist for a bullet list. Enter the content for the summary in the elements.

    A topic that contains a task element. Inside the task element, a tasksummary element has been added, and inside that, there is a para element. A callout arrow points to the paragraph text that has been added.
  8. To add prerequisites, position the cursor inside the task structure, between two block elements and use the Element Context Menu to add a taskprerequisites element.

    Paligo adds a taskprerequisites element, and inside that there is a para element. Enter text in the para. You can also use the element context menu to add other elements inside the taskprerequisites element, such as an itemizedlist.

    A topic that contains a task. Inside the task element, there is a taskprerequisites element. In the taskprerequisites element, there is a para element and an itemized list with two list items. A callout arrow points to the itemized list.
  9. To add taskrelated elements, position the cursor inside the task structure, between two block elements and use the Element Context Menu to add a taskrelated element.

  10. Position the cursor inside the taskrelated element and use the Element Context Menu to add other types of content structure, such as para elements or an itemizedlist.

    Typically, you would use these to add text and you can then add links by using the Insert > Link menu in the toolbar.

    A topic containing a task. Inside the task element, there is a task summary, task prerequisites, a procedure, and a taskrelated element. Inside the taskrelated element, there is an itemized list, with each listitem containing a link to another section. A callout arrow points at the list in the taskrelated element.
  11. Select Save. Save icon.

Note

The tasksummary, taskprerequisites, and taskrelated elements are all optional. You can also add other types of content structure inside a task, such as an example. The Element Context Menu provides access to those elements that are valid at the cursor's current location.

Here, we have covered the elements that are only available for use in a task.

In this example, we'll guide you through the steps for creating a task in an informaltopic. The task will have a task summary, prerequisites, and related tasks. You will learn how to add the various task elements and then you can apply the same techniques when creating your own tasks.

Example 1. Create a task that has a task summary, prerequisites and related tasks
  1. Create an informaltopic. You could use a regular topic instead if you prefer. The informaltopic has a para element inside it by default. That's not needed for the task, so delete the para element.

    informaltopic-task-example1.jpg
  2. Next, use the element context menu to add a task element.

    To access the element context menu, press Alt and Enter (Windows) or Option ⌥ and Enter (Mac).

    add-task-to-sidebar.jpg

    When you add the task element, Paligo adds a task, and a title and a procedure inside the task element.

    task-title-procedure-added.jpg
  3. Enter the text for the title.

  4. Position the cursor after the task's title element but before the next element (procedure, in this case). Then use the element context menu to add the tasksummary element.

    informaltopic-task-example3.jpg
  5. Select the tasksummary element and then use the element context menu to add an element for your summary content. There are many different types of element that you could use here, as explained in the DocBook schema, see DocBook task summary.

    For this example, use the para element and enter your summary text in that.

    example-task-summary-added.jpg
  6. For prerequisites, place the cursor after the tasksummary but still inside the task element. In the element structure menu, you should see that task is the last element shown.

    task-cursor-position-for-prerequisites.jpg

    Then use the element context menu to add the taskprerequisite element.

  7. Select the taskprerequisite element and use the element context menu to add the elements you want to use. There are many possibilities here, including different types of list and paragraph elements too.

    For this example, add a paragraph with the text "Prerequisites" followed by an itemized list. Add the prerequisites as list items.

    informaltopic-task-example5.jpg
  8. Enter the text for your procedure steps. Press Enter at the end of a step to create the next step in the procedure, or you can manually add a step and a para element for each one if you prefer.

  9. For related tasks, add the taskrelated element. For this example, add it after the procedure and use it to add links to other related tasks. Then select the taskrelated element and use the element context menu to add the elements for a paragraph and an itemized list. Insert links to other topics as list items.

    informaltopic-task-example6.jpg
    task-completed.jpg
  10. Select Save.

    You should now have a complete and valid task. In the underlying code, which you can see in the source code editor, the task should look something like this:

    <?xml version="1.0"?>
    <sidebar xmlns="http://docbook.org/ns/docbook" xmlns:xinfo="http://ns.expertinfo.se/cms/xmlns/1.0" xml:id="UUID-9fa6db45-2e2d-09b6-11f5-2bda3215f17b" version="5.0" xml:lang="en" xinfo:resource="UUID-9fa6db45-2e2d-09b6-11f5-2bda3215f17b" xinfo:resource-id="110111" xinfo:resource-type="component" xinfo:resource-subtype="informaltopic" xinfo:resource-title="Replace ACME 100 Battery" xinfo:resource-titlelabel="" xinfo:version-major="1" xinfo:version-minor="0">
      <task>
        <title xinfo:text="110123">Replace ACME 100 battery</title>
        <tasksummary>
          <para xinfo:text="110124">How to replace the battery in an ACME 100 device.</para>
        </tasksummary>
        <taskprerequisites>
          <para xinfo:text="110125">Prerequisites:</para>
          <itemizedlist>
            <listitem>
              <para xinfo:text="110126">ACME 100 replacement battery</para>
            </listitem>
            <listitem>
              <para xinfo:text="110127">ACME 100 unit key</para>
            </listitem>
          </itemizedlist>
        </taskprerequisites>
        <procedure xml:id="procedure-idm4679030963721632366065195995">
          <step>
            <para xinfo:text="110128">Use the ACME 100 unit key to unlock the 4 corner locks on the rear panel of the ACME 100. Turn the key anticlockwise to unlock.</para>
          </step>
          <step>
            <para xinfo:text="110129">Press the release latch and then gently pull the cover towards you.</para>
          </step>
          <step>
            <para xinfo:text="110130">Remove the battery from the ACME 100 device.</para>
          </step>
          <step>
            <para xinfo:text="110131">Insert the replacement battery, making sure that the positive and negative terminals of the battery are positioned correctly. The battery compartment has plus (positive) and minus (negative) markings to show the appropriate connections.</para>
          </step>
          <step>
            <para xinfo:text="110132">Close the hatch and make sure the latch clicks into place.</para>
          </step>
          <step>
            <para xinfo:text="110133">Use the ACME 100 unit key to lock the corner locks.</para>
          </step>
        </procedure>
        <taskrelated>
          <para xinfo:text="110152">See also:</para>
          <itemizedlist>
            <listitem>
              <para xinfo:text="110153">
                <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://RANDOM">Recharge ACME 100 battery</link>
              </para>
            </listitem>
            <listitem>
              <para xinfo:text="110154">
                <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://RANDOM">Mains power for ACME 100</link>
              </para>
            </listitem>
          </itemizedlist>
        </taskrelated>
      </task>
    </sidebar>

    Note

    The XML ids will be different in your topic.