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>