Inserting a passage (or shared stimulus)
A passage is a piece of information, usually in text form, which sets the context for a question or a series of questions. A passage can be used in multiple Items, and is therefore sometimes referred to as a Shared Stimulus, though in most versions of TAO, the term “shared stimulus” has been replaced by the term “passage”.
Creating and customizing a new Passage
Passages are .xml files which contain a simple or complex text (a text with integrated images). For users of the Premium/Ignite Edition (or higher) of TAO, a . They can be stored in the , so that they can be accessed easily for use in .
If you do not have the Premium/Ignite Edition of TAO, you can use the template below, in the form of an empty XML file, to author a new passage (outside of TAO):
<?xml version="1.0" encoding="UTF-8"?>
<div xmlns="http://www.imsglobal.org/xsd/imsqti_v2p1" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" class="stimulus_content" xsi:schemaLocation="http://www.imsglobal.org/xsd/imsqti_v2p1 http://www.imsglobal.org/question/qtiv2p1pd2/xsd/imsqti_v2p1.xsd">
<h1>Title</h1>
<p>Text here...</p>
</div>To create a passage with a media file, reference the media file using its relative location and include it in a zip file together with the XML file, then import the zip file.
To author a new passage in the Passage Editor (to add to the Asset library), follow the steps below.
-
Click on the Assets icon in the Assessment Builder Bar.
The Asset library will appear on the left. Select the folder in the library where you want the new passage to reside.
-
Click on New passage under the library.
The new passage will appear on the canvas. Rename the label as needed.
-
Click on Authoring in the Action Bar to enter the Passage Editor.
In the properties panel on the left, authors can adjust the following elements:
-
Langauge
-
Background color
-
Text color
-
Border color
-
Table headings
-
Font
-
Font size
Styles applied in the style editor will apply to any elements added to the passage.
TAO Advance only: There is an option to add a custom CSS stylesheet by selecting Add Style Sheet. Any elemental styles configured in the style editor will override an attached CSS stylesheet.
-
Add your text to the blank canvas.
To integrate an image into the passage, use the icons situated above the canvas. This can be a file already available in the Asset library, or something from your desktop. It will appear on the screen. If you are happy with your choice, click on the green Select button at the bottom. This inserts the image into the passage.
Using the text block style editor, passage authors may edit the following elements:
-
Background color
-
Text color
-
Border color
-
Table headings
-
Font
-
Font size
Passage authors can also add custom CSS classes to be applied to each individual text block.
-
Click on Preview in the action bar to see what the final passage will look like.
-
Once you have finished editing, save the passage and return to the Asset Manager.
Editing an existing Passage
You may want to edit an existing passage, in order to replace it with an updated version. In this case, after Step One above, select the passage from the library, then jump to Step Three. From here on the steps are the same for both procedures. Remember that changing a passage will have an impact on every item that includes it.
Adding a Passage to an item
Passages are categorized as Assets in TAO. Adding a passage to an item requires the same procedure as adding other types of assets, such as images. Passages must be created and stored in the Asset library prior to adding them to an item.
Example (TAO Advance)
Passage (or shared stimulus) interactions are used for reading assessments that utilize blocks of content, typically text passages.
Users complete this interaction by reading and analyzing the provided text, and answering the correlating question(s).
