Meclib tutorial: Basic Question Setup - mkraska/meclib GitHub Wiki

Back to My first Meclib question

Editor Settings

  • In your Moodle profile, select „Preferences“
  • Select „Editor preferences“
  • Select „Marklar“ or „Plain text area“, Save changes.
  • If you selected Marklar, you get a link to it‘s preferences.
    • Make sure that HTML format is checked
    • Save changes

image

Create a quiz

  • Enter a moodle course where you are trainer with editing rights.
  • Turn editing on
  • Add a quiz activity
  • Name it „Meclib Demo by <your name>“
  • Set Question behaviour to „Adaptive mode“
  • Save and display

This creates a quiz with no question.

Create a question template

In the quiz administration page, go to the "Questions" tab.

  • Press "Add"
  • Select "a new question"
  • In the Dialog select "STACK"
  • Press "Add" to create an empty unsaved question

Create minimum question context

The question must be filled with minimum contents to be saveable.

  • Category
    • Select as you prefer. In the STACK 2024 conference course, the category "Meclib Workshop" is appropriate
  • Question name:
    • Meclib Demo
    • Must be unique in the question bank and should be meaningful
  • Question variables: empty for now
  • Question text:
    • remove everything and add <p>[[input:S_Ha]] [[validation:S_Ha]] [[feedback:Ha]]</p>
    • This places input, validation and feedback fields for the analytical expression for the hypotenuse of the triangle.
  • Specific feedback:
    • Remove all content. We will create feedback in the Response trees later.
  • Press "Verify the question text and update the form". This creates setting fields for input and feedback
  • Open Input: ans1 and confirm removal (Generic names for input and feedback are hard to track in more complex questions).
  • Open Input: S_Ha
    • Model answer: Ha
    • Syntax hint: expression (optional, can be done later)
    • Hint attribute: Placeholder (optional, can be done later)
  • Open Potential response tree: prt1 and confirm removal
  • Open Potential response tree: Ha
    • In Node 1 enter SAns S_Ha and TAns Ha image
  • Press Save changes and continue editing. The Preview button should appear.
  • Press Preview

In the preview window:

  • Set Preview options> How questions behave to "Adaptive mode"
  • Press Start again with these options
  • Press Fill in correct responses
  • Press Check

image

Now we have a minimum question which is the starting point to make it more useful. This is save point P1.

Adding solution and instruction

  • Question variables: Add a line:
    Ha: sqrt(a^2+b^2);
  • Question text: Add the following text:
    <p>Give the general formula for the length of the hypotenuse \(c\) 
    of a right-angled triangle with sides \(a\) and \(b\).</p>
    
  • Press Save changes and continue editing
  • Press Preview In the preview window:
  • Press Fill in correct responses
  • Press Check

image

Compact Validation and Feedback

Now we want to have more compact validation (direct input processing) and feedback. This is useful in multipart questions.

Input: S_Ha

  • Insert stars: "Insert stars for spaces only* (this allows input of a b instead of a*b, a conveniency feature for the students)

  • Show the validation: "Yes, compact" Potential response tree: Ha

  • PRT feedback style: "Compact"

  • Press Save changes and continue editing

  • Press Preview

image

Up to here there is nothing specific to Meclib.

Back to My first Meclib question

⚠️ **GitHub.com Fallback** ⚠️