OUP BITS TCI

 

Highlight categories

Capture a highlight category using a styled-content element. Use the style-type attribute to specify the category style.

The allowed values for the style-type attribute are:

  • highlight-category-1
  • highlight-category-2
  • highlight-category-3
  • highlight-category-4
  • highlight-category-5
  • highlight-category-6
  • highlight-category-7
  • highlight-category-8

Capture the semantic description of the highlight's meaning (the key) as the text content of a styled-content element. For a key, the styled-content element must specify a style-type attribute that matches the highlight category and must appear within a parent target element with target-type="key". The target element must specify an id attribute.

If required to improve clarity, link a highlighted text fragment to the corresponding key element using an xrefelement with a rid attribute value that maps to the matching key id attribute value, and specify the link type using the attribute-value pair ref-type="highlight-key".

Multiple highlight categories

<boxed-text>
    <caption>Key</caption>
    <target id="hc-key-1" target-type="key">
        <styled-content style-type="highlight-category-1">Social Class</styled-content>
    </target>
    <target id="hc-key-2" target-type="key">
        <styled-content style-type="highlight-category-2">Architecture</styled-content>
    </target>
    <target id="hc-key-3" target-type="key">
        <styled-content style-type="highlight-category-3">Daily life</styled-content>
    </target>
</boxed-text>
<p>The ancient Romans lived in a city called Rome, which is in Italy. They started small but
        grew to rule much of Europe, North Africam and parts of Asia. </p>
    <p>The ancient Romans had a rich and varied diet, heavily influenced by their <styled-content
            style-type="highlight-category-1">social class</styled-content> and regional
        availability of ingredients. <styled-content style-type="highlight-category-1">The wealthy
           enjoyed elaborate meals with multiple courses</styled-content>, often featuring exotic
        ingredients like dormice, oysters, and imported spices. Their banquets, known as convivia,
        were social events that could last for hours, with reclining on couches, entertainment, and
        wine flowing freely. <styled-content style-type="highlight-category-2">Meals were typically
            served in a triclinium, a formal dining room</styled-content>. In contrast,
        <styled-content style-type="highlight-category-1">the lower class ate simple fare
           </styled-content>--mostly grains like wheat and barley, turned into bread or porridge
        (puls), along with vegetables, olives, and occasionaly fish or meat. <styled-content
            style-type="highlight-category-3">Garum, a fermented fish sauce, was a staple condiment
            across all classes.</styled-content></p>

Multiple highlight categories with xref links to category keys

<boxed-text>
    <caption>Jon's work</caption>
    <p> Alice Munro presents Uncle Benny as a <xref ref-type="highlight-key" rid="hc-key-1">
            <styled-content style-type="highlight-category-1">quiet and stern
                person</styled-content>
        </xref>. The <xref ref-type="highlight-key" rid="hc-key-2">
            <styled-content style-type="highlight-category-2">harsh words and bossy
                instructions</styled-content>
        </xref> he speaks to 'You kids' make him <xref ref-type="highlight-key" rid="hc-key-1">
            <styled-content style-type="highlight-category-1">seem authoritative</styled-content>
        </xref>. </p>
</boxed-text>
<boxed-text>
    <caption>Teacher's comment</caption>
    <p>Well done, Jon. You have <target id="hc-key-1" target-type="key">
            <styled-content style-type="highlight-category-1">explored a range of
                meanings</styled-content>
        </target> intended by Munro. I am pleased to see you <target id="hc-key-2" target-type="key">
            <styled-content style-type="highlight-category-2">picking out details to support your
                argument</styled-content>
        </target>. </p>
</boxed-text>

Release ID:
20260603
ID:
highlight_categories
Author:
delvesc
Last changed:
Modified by:
Revision#: