Token Highlight

Description

The Token Highlight question requires students to highlight certain words, sentences, or paragraphs by clicking on the text.

Figure 1 - Token Highlight question example.

Create a Question



Enter the question stem into the Compose question area. Below you will see the Template area with two tabs: Edit Template and Edit Tokens. Tokens are words, sentences or paragraphs of text that can be highlighted. To create a question with tokens you should first enter the text and then create tokens inside it.

First, with the Edit Template tab open, enter the text into the Template area. Then switch to the Edit Tokens tab. You will see three buttons: Sentence, Paragraph and Word. These buttons will automatically create tokens for all sentences, paragraphs or words respectively. For example, when you click on the Word button the system will convert every word from the text into a highlightable token. The total amount of tokens created can be seen on the top right corner of the panel. You can always switch from one type of token creation to another by clicking on Clear. Previously created tokens will disappear and you can then apply another tokenization type.

You can also create custom tokens. For this click on Clear in order to remove any previous tokenization and start highlighting text parts with your mouse cursor. The highlighted elements will become custom tokens.

Figure 2 - Creating sentence tokens.


You can now configure validation for your question. Follow these steps to set up score and correct response:

  • Insert value in the Point(s) box to set up a mark for the question. The default value is set to 1.
  • In the Correct tabs you will see the text you have tokenized. Simply click on the token or tokens which represent the correct response in order to validate the question. You will see the selected correct responses highlighted in yellow as shown in Figure 3.

Figure 3 - Question validation.


Scoring type menu can be found under More Options.

The following scoring types are avaialable in Token Highlight questions:

  • Exact Match - Student must answer all parts of the question correct to receive a mark.
  • Partial Match Per Response - Each correct response element will be awarded an individual score.
  • Partial Match - Each correct response element will be scored individually and the overall question score will be divided between responses.
  • N.B. If scoring by either of our partial match options ensure a max selection is set as all tokens can be selected and a correct answer awarded.

More Options

Max Selection - By putting a value into this field authors can specify how many elements students can select when giving an answer. For unlimited amount of selections insert 0.

Example 1 - Token Highlight question with paragraph tokenization.

Source
{
    "max_selection": 1,
    "stimulus": "Highlight the paragraph the Ishmael decides to go to sea.",
    "template": "<p><span class=\"lrn_token\">Call me Ishmael. Some years ago--never mind how long precisely--having little or no money in my purse, and nothing particular to interest me on shore, I thought I would sail about a little and see the watery part of the world. It is a way I have of driving off the spleen and regulating the circulation. Whenever I find myself growing grim about the mouth&#59; whenever it is a damp, drizzly November in my soul&#59; whenever I find myself involuntarily pausing before coffin warehouses, and bringing up the rear of every funeral I meet and especially whenever my hypos get such an upper hand of me, that it requires a strong moral principle to prevent me from deliberately stepping into the street, and methodically knocking people&lsquo;s hats off--then, I account it high time to get to sea as soon as I can. This is my substitute for pistol and ball. With a philosophical flourish Cato throws himself upon his sword&#59; I quietly take to the ship. There is nothing surprising in this. If they but knew it, almost all men in their degree, some time or other, cherish very nearly the same feelings towards the ocean with me.<\/span><\/p><p><span class=\"lrn_token\">There now is your insular city of the Manhattoes, belted round by wharves as Indian isles by coral reefs--commerce surrounds it with her surf. Right and left, the streets take you waterward. Its extreme downtown is the battery, where that noble mole is washed by waves, and cooled by breezes, which a few hours previous were out of sight of land. Look at the crowds of water-gazers there.<\/span><\/p><p><span class=\"lrn_token\">Circumambulate the city of a dreamy Sabbath afternoon. Go from Corlears Hook to Coenties Slip, and from thence, by Whitehall, northward. What do you see?--Posted like silent sentinels all around the town, stand thousands upon thousands of mortal men fixed in ocean reveries. Some leaning against the spiles&#59; some seated upon the pier-heads&#59; some looking over the bulwarks of ships from China&#59; some high aloft in the rigging, as if striving to get a still better seaward peep. But these are all landsmen&#59; of week days pent up in lath and plaster--tied to counters, nailed to benches, clinched to desks. How then is this? Are the green fields gone? What do they here?<\/span><\/p>",
    "tokenization": "custom",
    "instant_feedback": true,
    "type": "tokenhighlight",
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                0
            ]
        }
    }
}


Example 2 - Token Highlight question sentence tokenization.

Source
{
    "stimulus": "<p><span>Select all the relevant sections in the text.<\/span><br \/><span>Which sentence or sentences imply that the cheetahs run fast?<\/span><\/p>",
    "template": "<p><span class=\"lrn_token\">Most cheetahs live in the wilds of Africa<\/span>.<span class=\"lrn_token\">There are also some in Iran and northwestern Afghanistan<\/span>.<span class=\"lrn_token\">The cheetah&lsquo;s head is smaller than the leopard&lsquo;s, and its body is longer<\/span>.<span class=\"lrn_token\">This cat is built for speed<\/span>.<span class=\"lrn_token\">Its legs are much longer than the leopard, allowing it to run at speeds of up to 70 miles per hour<\/span>!<span class=\"lrn_token\">This incredible ability helps the cheetahs catch their dinner, which is usually an unfortunate antelope<\/span>.<span class=\"lrn_token\">A cheetah&lsquo;s spots are simply black spots, not rosettes or circles<\/span>.<\/p>",
    "tokenization": "custom",
    "instant_feedback": true,
    "type": "tokenhighlight",
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                2,
                3,
                4
            ]
        }
    }
}


Example 3 - Token Highlight question with word tokenization.

Source
{
    "stimulus": "<p><strong>Learning Languages<\/strong><\/p><p>Find and highlight <em>verbs<\/em> in the text below.<\/p>",
    "template": "<p><span><span class=\"lrn_token\">From<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">oval<\/span> <span class=\"lrn_token\">shaped<\/span> <span class=\"lrn_token\">flower-bed<\/span> <span class=\"lrn_token\">there<\/span> <span class=\"lrn_token\">rose<\/span> <span class=\"lrn_token\">perhaps<\/span> <span class=\"lrn_token\">a<\/span> <span class=\"lrn_token\">hundred<\/span> <span class=\"lrn_token\">stalks<\/span> <span class=\"lrn_token\">spreading<\/span> <span class=\"lrn_token\">into<\/span> <span class=\"lrn_token\">heart-shaped<\/span> <span class=\"lrn_token\">or<\/span> <span class=\"lrn_token\">tongue-shaped<\/span> <span class=\"lrn_token\">leaves<\/span> <span class=\"lrn_token\">half<\/span> <span class=\"lrn_token\">way<\/span> <span class=\"lrn_token\">up<\/span> <span class=\"lrn_token\">and<\/span> <span class=\"lrn_token\">unfurling<\/span> <span class=\"lrn_token\">at<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">tip<\/span> <span class=\"lrn_token\">red<\/span> <span class=\"lrn_token\">or<\/span> <span class=\"lrn_token\">blue<\/span> <span class=\"lrn_token\">or<\/span> <span class=\"lrn_token\">yellow<\/span> <span class=\"lrn_token\">petals<\/span> <span class=\"lrn_token\">marked<\/span> <span class=\"lrn_token\">with<\/span> <span class=\"lrn_token\">spots<\/span> <span class=\"lrn_token\">of<\/span> <span class=\"lrn_token\">colour<\/span> <span class=\"lrn_token\">raised<\/span> <span class=\"lrn_token\">upon<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">surface<\/span>; <span class=\"lrn_token\">and<\/span> <span class=\"lrn_token\">from<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">red<\/span>, <span class=\"lrn_token\">blue<\/span> <span class=\"lrn_token\">or<\/span> <span class=\"lrn_token\">yellow<\/span> <span class=\"lrn_token\">gloom<\/span> <span class=\"lrn_token\">of<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">throat<\/span> <span class=\"lrn_token\">emerged<\/span> <span class=\"lrn_token\">a<\/span> <span class=\"lrn_token\">straight<\/span> <span class=\"lrn_token\">bar<\/span>, <span class=\"lrn_token\">rough<\/span> <span class=\"lrn_token\">with<\/span> <span class=\"lrn_token\">gold<\/span> <span class=\"lrn_token\">dust<\/span> <span class=\"lrn_token\">and<\/span> <span class=\"lrn_token\">slightly<\/span> <span class=\"lrn_token\">clubbed<\/span> <span class=\"lrn_token\">at<\/span> <span class=\"lrn_token\">the<\/span> <span class=\"lrn_token\">end<\/span>.<\/span><\/p>",
    "tokenization": "custom",
    "instant_feedback": true,
    "type": "tokenhighlight",
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                6,
                11,
                21,
                31,
                36,
                51,
                61
            ]
        }
    }
}


Example 4 - Token Highlight question with custom tokenization. Select 5 tokens only.

Source
{
    "max_selection": 5,
    "stimulus": "<p>Select the incorrect lyrics in the popular holiday song below.<\/p>",
    "template": "<p><span class=\"lrn_token\">Dashing<\/span> through <span class=\"lrn_token\">the grass<\/span><br \/> In a one horse open sleigh<br\/> O&lsquo;ser the fields we go<br \/> <span class=\"lrn_token\">Laughing<\/span> all the way<br \/> The bells on bob tails ring<br \/> Making <span class=\"lrn_token\">evenings<\/span> bright<br \/> What fun it is to <span class=\"lrn_token\">cry<\/span> and sing<br \/> A <span class=\"lrn_token\">sleighing<\/span> song tonight.<\/p> <p>Jingle bells, jingle bells<br \/> Jingle all the way<br \/> Oh, <span class=\"lrn_token\">how nice<\/span> it is to <span class=\"lrn_token\">ride<\/span><br \/> In a one <span class=\"lrn_token\">dog<\/span> open sleigh<br \/> <span class=\"lrn_token\">Jingle bells<\/span>, jingle bells<br \/> Jingle all the way<br \/> Oh, <span class=\"lrn_token\">what fun it is to ride<\/span><br \/> In a one horse open sleigh.<\/p>",
    "tokenization": "custom",
    "type": "tokenhighlight",
    "instant_feedback": true,
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                1,
                3,
                4,
                6,
                8
            ]
        }
    }
}


Example 5 - Token Highlight question using math.

Source
{
    "instant_feedback": true,
    "is_math": true,
    "stimulus": "<p>Select the statement containing the correct formula to find volume of a cylinder.<\/p>",
    "template": "<p><span class=\"lrn_token\">\\(V=\\pi r^2h\\)<\/span><\/p><p><span class=\"lrn_token\">\\(V=\\frac{\\pi r^2}{h}\\)<\/span><\/p><p><span class=\"lrn_token\">\\(V=2\\pi r^3h\\)<\/span><\/p><p><span class=\"lrn_token\">\\(V=\\pi2r\\)<\/span><\/p>",
    "tokenization": "custom",
    "type": "tokenhighlight",
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                0
            ]
        }
    }
}