Creating and editing passages with the Passage Editor

Passages in TAO are blocks of content, typically text passages. They are intended for use in reading assessments, though they may contain illustrations. Passages are created using the Passage Editor. They are stored in the Asset Manager, so they can be used in multiple Items. Passages are .xml files which contain a simple or complex text (a text with integrated images).

Creating a new Passage

To author a new passage to add to the Asset library, follow the steps below.

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

2. Click on New passage under the library.

The new passage will appear on the canvas. Rename the label as needed.

3. Click on Authoring in the Action Bar to enter the Passage Editor.

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.

Creating a new passage in the Passage Editor

4. Click on Preview in the action bar to see what the final passage will look like.

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

Note: Remember that editing a passage will have an impact on every item that includes it.

For information on how to use your assets in new items, see Adding assets to an item.

Styling Rich Passages

Item authors are able to create passages that mimic the look and feel of news articles, blog posts, poems, books, etc. in order to create more engaging test content for the test-takers. 

Passages have been enriched with additional styling capabilities that allow authors to change the font, text color, background color, border color and table headings color. 

The resulting passages can then be used in items and tests, while preserving their own styling and also adapting to the styling from the items. For instance, if the font is not defined in the passage, but is defined in the item, the one from the item will be used. However any styling applied to the passage will override any styling on that type of element from the item.

  1. Create a new passage or navigate to the existing passage you would like to edit by following the instructions above.
  2. Once inside the Passage Editor, you will see the Passage Properties panel open on the right side of your screen. Expand the Passage Stye section to edit the background color of the passage, along with the text color, border color and table heading color. 

    example of the rich passage editor
    Styling a passage in the Passage Editor