Articles in this section

Quiz Topic

Avatar
Anders
  • Updated
Follow

Quizzes are a fun way to test your audience's knowledge at various stages of your eLearning course. You can create your quizzes in Paligo and add questions with numerical answers and multiple-choice questions, see Question Types.

When you upload your eLearning to a Learning Management System (LMS), users will be able to take the quizzes and the LMS will track their progress and scores, see Upload the eLearning Output to your LMS.

To create a quiz:

  1. Create a Quiz Topic

  2. Add More Questions to a Quiz.

  3. Add the answers to your questions, see:

Multiple choice question. Each possible answer has a checkbox. The user can select multiple answers.

Example of a multiple choice question with multiple correct answers.

Note

If you did not create the quiz topic from the publication structure, you will need to manually add the topic to the publication, see Organize the eLearning Publication.

Question Types

Before you add a question to your quiz, consider what type of answer formats are available. Paligo supports answers that require the user to:

Create a Quiz Topic

To create a quiz in Paligo, you create a topic and add a role attribute with the value set to: quiz. Then you add a qandaset element to contain the quiz structure.

The qandaset element is a container for all of the questions and answers you include in your quiz. When you add a qandaset, Paligo automatically adds some extra structure for the first question and one potential answer. The structure consists of:

  • qandaentry - Each question has to be inside its own qandaentry element. For example, if you have a quiz with 5 questions, the quiz is represented by the qandaset element and inside that you will have 5 qandaentry elements (1 for each question).

  • question and para - The question element represents a question in the quiz and it has to be inside a qandaentry element. The para inside the question is where you enter the text for the question.

  • answer and para - The answer element represents a possible answer to the question. It has to be inside the same qandaentry element as the question. The para inside the answer is where you enter the text for the answer.

Quiz topic in the Paligo editor. It has a title and a question and answer.
XML tree view of a sample quiz topic. It has section at the top level, then title, then qandaset, then qandaentry, then question, para, answer, and para.

To the left the structure in the Editor. To the right the structure in the XML Tree View.

To create a quiz topic:

  1. Create a Topic.

  2. 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.

  3. Select the section element in the Element Structure Menu.

    Close up of Element Structure Menu. It shows the section element is selected and the Go to element option is selected.

  4. Select Go to element.

  5. Add the role attribute in the Element Attributes Panel and set the value to quiz.

    Element attributes panel. The section element is selected and it has been given a role attribute. The value for the role attribute is quiz.

  6. Position the cursor where the quiz is to be inserted.

  7. 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.

  8. Enter qandaset and select it from the menu.

    Quiz topic in the Paligo editor. It has a title and a question and answer.

    Tip

    You can add extra para elements inside a question or answer to create multi-paragraph questions and answers. Add any extra para elements after the previous para element, inside the question or answer.

    If you have multiple para elements, the first one will be styled like a heading in the output. The other para elements will be styled as regular text.

    You can also insert other content structures inside a question or answer, such as mediaobject for an image and programlisting for code.

  9. Select Save. Save icon.

You now have the basic structure for a quiz, with one question and a single answer. This will be a numerical question and answer unless you add additional answers to turn it into a multiple-choice question / answer.

Tip

To learn how to add more questions, see Add More Questions to a Quiz.

We have included Example Quiz Topic that contains multiple questions and answers. You can use this example to see how the question and answers need to be structured in your quiz topic.

Set Up a Numerical Question / Answer

Numerical question/answers are quiz questions that require the user to enter a number for the answer. There is a question in text and below it, a field for entering the answer.

Example of a numerical quiz question. It has a question in text and a field to enter the answer. The answer is a number.

To set up a numerical answer for a quiz:

  1. Make sure your topic has the qandaset structure that is needed for a quiz (see Create a Quiz Topic). You also need to add the question structure for your numerical question (see Add More Questions to a Quiz).

  2. Enter the body text of the question inside the para that is inside the question element.

    Paligo topic for a quiz. It has a title and a qandaset element. In the element structure menu, it shows the content structure is section followed by qandaset, followed by qandaentry, followed by question, followed by para. The text for the question has been entered into the para.

  3. Enter the correct answer (a number) inside the para element that is inside the answer element.

    Paligo editor showing an example of a quiz topic with a numerical question and answer. There is a question in text and an answer as a number.

  4. Select Save. Save icon.

When you publish your eLearning, Paligo will detect that this is a numerical answer and make it a question with a text-entry field in the output.

Set Up a Multiple Choice Question / Answer

There are three types of multiple choice question that you can create:

  • A multiple choice question with one correct answer. The user is presented with a list of options and each one has a radio button.

    Multiple choice question. Each possible answer has a radio button. The user can only select one answer.

  • A multiple choice question with more than one correct answer. The user is presented with a list of options and each one has a check box.

    Multiple choice question. Each possible answer has a checkbox. The user can select multiple answers.

  • A trick multiple choice question. It presents the user with a list of options that have check boxes so it appears as if there are multiple correct answers. But there is only one correct answer.

    Multiple choice question. Each answer has a checkbox making it look like there is more than one correct answer. But it is a trick, there is only one correct answer.

The following instructions explain how to create all three types:

  1. Make sure your topic has the qandaset structure that is needed for a quiz (see Create a Quiz Topic). You also need to add the question structure for your numerical question (see Add More Questions to a Quiz).

  2. Enter the body text of the question inside the para that is inside the question element.

    Paligo topic for a quiz. It has a title and a qandaset element. In the element structure menu, it shows the content structure is section followed by qandaset, followed by qandaentry, followed by question, followed by para. The text for the question has been entered into the para.

  3. Enter the text for a possible answer inside the para element that is inside the answer element.

    Quiz topic in the Paligo editor. The Element Structure Menu shows section, qandaset, qandaentry, answer, para. This means the user has selected the para element inside an answer element.

  4. Position the cursor after the previous answer element but still inside the qandaentry element.

    Quiz topic in Paligo editor. The cursor is positioned after the previous qandaentry element.

  5. 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.

  6. Enter answer and select it from the menu.

    Element context menu showing a list of valid elements that can be added at the cursor position. Answer is one of the elements.

    Note

    If the answer element is not available in the list, then the cursor is in an incorrect position. Check that it is after the question but inside the qandaentry element. The correct structure should look like this in the XML tree:

    XML tree showing the valid structure for a multiple-choice question. It has structure at the top, then title, then qandaset, then qandaentry, then question and para, then answer and para, then another answer and para.

  7. Enter the text for a possible answer in the para inside the answer element that you have added.

    Quiz topic in Paligo editor. The element structure menu shows section, qandaset, qandaentry, answer, para. This means the user has selected the para element that is inside the answer element.

    Tip

    You can add extra para elements inside a question or answer to create multi-paragraph questions and answers. Add any extra para elements after the previous para element, inside the question or answer.

    If you have multiple para elements, the first one will be styled like a heading in the output. The other para elements will be styled as regular text.

    You can also insert other content structures inside a question or answer, such as mediaobject for an image and programlisting for code.

  8. Repeat steps 5 and 6 to add more possible answers, including the correct answer(s). The completed structure should look something like this in the XML tree:

    XML tree view of part of a quiz. It has qandaset at the top level. Inside that is qandaentry. Inside that there is question with a child para, answer with a child para, and another answer with a child para.

    Notice how the question and the potential answers are all inside the qandaentry element. Each question should have its own qandaentry element, with the question and potential answers inside it.

  9. Select the correct answer in the Editor.

  10. Select its answer element in the Element Structure Menu at the top and choose Go to element from the menu.

    Quiz topic in the Paligo editor. The element structure menu shows that the para element inside an answer element is selected. The context menu shows that the go to element option is being selected.

  11. Add the role attribute in the Element Attributes Panel and set the value to correct.

    Element attributes side panel. It shows the answer element has a role attribute. The value of the role attribute is set to correct.
    Quiz topic in the Paligo editor. There is a question with three possible answers. The correct answer has a green box around it and a green check icon.

    When you set an answer to correct, a green box and checkmark appear for that answer in the Paligo editor.

  12. If a question has multiple correct answers, repeat steps 9 and 10 for each correct answer.

  13. This step only applies if you want to make your multiple choice question a "trick" question. A trick question is where it looks like there is more than one correct answer but actually only one answer is correct.

    To turn a multiple choice question into a trick question:

    1. Select the question element for the trick question.

    2. Add the role attribute in the Element Attributes Panel and set the value to multi-choice.

      Element attributes side panel shows the question element has a role attribute. The value of the role attribute is set to multi-choice. This sets the question to be a trick question.

  14. Select Save. Save icon.

When you publish your eLearning, Paligo uses the role attributes to determine what type of multiple-choice questions you have added. It then creates those in the published output.

Add More Questions to a Quiz

To add more questions to a quiz topic:

  1. Make sure your topic contains the structure for a quiz (as described in Create a Quiz Topic).

  2. Position the cursor so that it is after the previous qandaentry element but inside the qandaset element.

    Note

    If you cannot find the qandaentry element in the element context menu, it is because the cursor is in an incorrect position. Try repositioning the cursor so that the selection point is after the previous qandaentry element but still inside the qandaset element.

    When the cursor is in the correct position, the Element Structure Menu shows section > qandaset. You will then be able to add qandaentry from the element context menu.

  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 qandaentry and select it from the menu to add another question.

    Paligo editor shows a quiz topic. The cursor is positioned after the previous qandaentry element, but inside the same qandaset element. The context menu shows the user has searched for qandae and is about to add a qandaentry element.

    You have now added the structure for an additional question. By default, the structure contains one answer element. You can add more answer elements to turn it into a multiple-choice question. Alternatively, you can use a single answer for a numerical question.

    Paligo editor showing a topic quiz. There are two question and answer pairs shown in the topic. The topic contains a single qandaset and inside that there are two qandaentry elements - one for each question and answer pair.

  5. Repeat step 2 to 4 for as many questions as you need.

  6. Select Save. Save icon.

Remove a Question from a Quiz

To remove a question and its answers from a quiz:

  1. Open the quiz topic in the Editor.

  2. Select the question that you want to remove.

    Quiz topic in the Paligo editor. A Question is highlighted to show that a user has selected a question in the quiz.

  3. Select the qandaentry element In the Element Structure Menu and choose Delete.

    Quiz topic in the Paligo editor. The user has selected a qandaentry element in the Element Structure Menu. The dropdown menu is shown and the Delete option is highlighted.

    Paligo removes the structure for the question and its answers (qandaentry, question and para, and each answer and para pair).

  4. Select Save. Save icon.

Remove an Answer from a Quiz

To remove an answer from a question in a quiz:

  1. Open the quiz topic in the Editor.

  2. Select the answer that you want to remove.

    Quiz topic in the Paligo editor. An answer is highlighted to show that the user has selected the answer text.

  3. Select the answer element in the Element Structure Menu and choose Delete.

    Quiz topic in the Paligo editor. The user has selected the answer element in the Element Structure Menu. This reveals a dropdown menu and the Delete option is highlighted.

  4. Select Save. Save icon.

Example Quiz Topic

This example shows the underlying structure of a Paligo quiz topic called "Quiz - Creating Content in Paligo". It contains multiple choice questions with single correct answers, multiple choice questions with several correct answers, a trick multiple choice question, and a numerical question too.

By looking at the code, you can see the valid structure for the quiz and the various question types. If you have problems setting up your own quiz, referring to this example may help you spot any structural problems.

Note

We have removed the database IDs to make the code simpler, but in your topics the IDs will be included in the code, for example, xinfo:text="1169436".

Example 28. Quiz structure

The following source code shows the structure for a valid quiz.

<?xml version="1.0"?>
<section xmlns="http://docbook.org/ns/docbook" xmlns:xinfo="http://ns.expertinfo.se/cms/xmlns/1.0" version="5.0" xinfo:resource="UUID-9921a762-7cd2-093a-3583-c1f8206fcf0d" xinfo:resource-id="1169399" xinfo:resource-type="component" xinfo:resource-title="Quiz - Creating Content in Paligo copy 1" xinfo:resource-titlelabel="" xinfo:version-major="1" xinfo:version-minor="0" role="quiz" xml:id="UUID-9921a762-7cd2-093a-3583-c1f8206fcf0d" xml:lang="en">
  <title>Quiz - Creating Content in Paligo</title>
  <qandaset>
    <qandaentry>
      <question>
        <para>When you check out a topic in Paligo, can another Author edit that topic at the same time?</para>
      </question>
      <answer>
        <para>Yes, Paligo supports simultaneous editing by multiple authors.</para>
      </answer>
      <answer role="correct">
        <para>No, the topic is locked for editing by others when it is checked out.</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is an informal topic?</para>
      </question>
      <answer>
        <para>A selection of content or images that must have a title</para>
      </answer>
      <answer role="correct">
        <para>A selection of content or images that do not need a title</para>
      </answer>
      <answer>
        <para>A special type of admonition that the user can select to ignore</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is a fork?</para>
      </question>
      <answer>
        <para>A container where you organize your topics into a table of contents</para>
      </answer>
      <answer role="correct">
        <para>A reference to a source topic, reused in a publication</para>
      </answer>
      <answer>
        <para>A building block for a section of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What interface is shown when you open a publication?</para>
      </question>
      <answer>
        <para>The Editor View</para>
      </answer>
      <answer role="correct">
        <para>The Structure View</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>To open a topic and work on it, which interface would you use?</para>
      </question>
      <answer role="correct">
        <para>The Editor View</para>
      </answer>
      <answer>
        <para>The Structure View</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question role="multi-choice">
        <para>What is a topic?</para>
      </question>
      <answer>
        <para>A container where you organize your topics into a table of contents</para>
      </answer>
      <answer>
        <para>A reference to a source topic, reused in a publication</para>
      </answer>
      <answer role="correct">
        <para>A building block for a section of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>Which of the following statements are true?</para>
        <para>Topic-based authoring ...</para>
      </question>
      <answer>
        <para>... is similar to document writing and formatting in Microsoft Word</para>
      </answer>
      <answer role="correct">
        <para>... encourages breaking down documents into smaller pieces of content</para>
      </answer>
      <answer role="correct">
        <para>... makes it possible to reuse content as building blocks in multiple publications</para>
      </answer>
      <answer role="correct">
        <para>... enables you to update content in one place, and the update applies wherever the content is used</para>
      </answer>
      <answer>
        <para>... does NOT encourage the reuse of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is the correct order (from largest to smallest, left to right) of the following Paligo structures?</para>
      </question>
      <answer>
        <para>Topic, Publication, Element, Section</para>
      </answer>
      <answer>
        <para>Section, Publication, Element, Topic</para>
      </answer>
      <answer role="correct">
        <para>Publication, Topic, Section, Element</para>
      </answer>
      <answer>
        <para>Publication, Section, Topic, Element</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>How many floating content panels can you have open at once?</para>
      </question>
      <answer>
        <para>4</para>
      </answer>
    </qandaentry>
  </qandaset>
</section>

Notice that:

  • The entire quiz is inside one qandaset element

  • Each question is inside a qandaentry element

  • Each question has a question element with a para element for its text

  • Each answer is in an answer element with a para element for its text

  • role="correct" is added to the answer element for each correct answer. Paligo does this automatically when you give an answer element the role attribute and set its value to correct.

  • role="multi-choice" is added to the question element for a trick question. This tells Paligo to make this multiple choice question look like it has several correct answers (it presents the options as check boxes) but it actually only has one correct answer. Paligo applies this code when you give a question element the role attribute and set its value to multi-choice.

  • The answer element for a numerical question contains the answer in the para element. Paligo detects that this is a numerical question/answer automatically. When you publish, the question will have a text box for the user to enter a number. They will not see the correct answer.


Related articles

Comments

0 comments

Article is closed for comments.

Powered by Zendesk