att.global.rendition

att.global.rendition provides rendering attributes common to all elements in the TEI encoding scheme. [1.3.1.1.3. Rendition Indicators]

Module

tei

Members

att.global [NB TEI ab abbr abstract activity add addName additional adminInfo affiliation author biblStruct body byline catDesc catRef category cell change char charDecl choice closer collection compliment corr correspAction correspContext correspDesc creation custodialHist damage dateline del desc div divGen docAuthor docDate docEdition docImprint docTitle editor ellipsis emph enclosure encodingDesc epigraph expan extent facsimile figDesc figure fileDesc floruit foreign forename front fw g gap genName geo gloss graphic handNote handNotes handShift head hi history idno imprimatur imprint item l label langKnown langUsage language lb lg linkGrp list listBibl listChange listObject listOrg listPerson listPlace listPrefixDef localProp location locusGrp mapping mentioned milestone msContents msDesc msIdentifier msItem msName msPart name nameLink note noteGrp notesStmt num objectDesc objectName occupation opener org orgName orig origin p persName person persona physDesc place placeName postscript prefixDef profileDesc projectDesc ptr pubPlace publicationStmt publisher quote ref reg rendition repository request resp respStmt revisionDesc roleName row rs salute setting settingDesc settlement sic signed sourceDesc standOff subst summary supportDesc surface surfaceGrp surname surrogates table tagsDecl taxonomy teiHeader term text textClass title titlePage titlePart titleStmt trailer unclear w zone] date time

Attributes

rendition

points to a description of the rendering or presentation used for this element in the source text.

Status	Optional
Schematron	The two column layout requires one item to be left and one item to be right. <sch:rule context="tei:[contains-token(@rendition,'rnd:two-column')]"> <sch:let name="children" value="child::tei:"/> <sch:let name="leftChild" value="$children[contains-token(@rendition,'rnd:left')]"/> <sch:let name="rightChild" value="$children[contains-token(@rendition, 'rnd:right')]"/> <sch:assert test="exists($children) and (count(($leftChild, $rightChild)) = count($children))">ERROR: Every child of a two column layout must have either a rnd:right or a rnd:left rendition value.</sch:assert> <sch:assert test="exists($leftChild) and exists($rightChild)">ERROR: There must be at least one rnd:left and one rnd:right child</sch:assert> </sch:rule>
Schematron	Some renditions contradict each other <sch:rule context="tei:*[@rendition]"> <sch:let name="rendition" value="@rendition"/> <sch:let name="ptrs" value="tokenize(@rendition,'\s+')"/> <sch:let name="tokens" value="for $p in $ptrs return substring-after($p,'rnd:')"/> <sch:let name="duplicates" value="$tokens[count(index-of($tokens, .)) gt 1]"/> <sch:assert test="empty($duplicates)">ERROR: Duplicate renditions found: <sch:value-of select="string-join($duplicates,', ')"/>. Do not use the same rendition more than once on a single element.</sch:assert> <sch:assert test="count($tokens[. = ('left','right','center')]) lt 2">ERROR: rnd:right, rnd:left, or rnd:center are mutually exclusive.</sch:assert> <sch:assert test="count($tokens[. = ('large','small')]) lt 2">ERROR: rnd:large and rnd:small are mutually exclusive.</sch:assert> <sch:assert test="count($tokens[. = ('bordered-bottom','bordered-bottom-dashed')]) lt 2">ERROR: rnd:bordered-bottom and rnd:bordered-bottom-dashed are mutually exclusive.</sch:assert> </sch:rule>
Datatype	1–∞ occurrences of teidata.pointer separated by whitespace
Legal values are:
<head rendition="#ac #sc"> <lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her <lb/> <hi rendition="#normal">New Blazing-World</hi>. </head> <!-- elsewhere... --> <rendition xml:id="sc" scheme="css">font-variant: small-caps</rendition> <rendition xml:id="normal" scheme="css">font-variant: normal</rendition> <rendition xml:id="ac" scheme="css">text-align: center</rendition>
Note	The rendition attribute is used in a very similar way to the class attribute defined for XHTML but with the important distinction that its function is to describe the appearance of the source text, not necessarily to determine how that text should be presented on screen or paper. If rendition is used to refer to a style definition in a formal language like CSS, it is recommended that it not be used in conjunction with rend. Where both rendition and rend are supplied, the latter is understood to override or complement the former. Each URI provided should indicate a rendition element defining the intended rendition in terms of some appropriate style language, as indicated by the scheme attribute.

Schematron

Constraints for renditions that should only be used in born digital documents

<sch:rule context="tei:*[contains-token(@rendition,'rnd:hidden')]">
<sch:assert test="self::tei:head and ancestor::tei:TEI/descendant::tei:catRef[matches(@target,'bornDigital')]">ERROR: rnd:hidden is meant only for born digital document headings.</sch:assert>
</sch:rule>

The two column layout requires one item to be left and one item to be right.

<sch:rule context="tei:*[contains-token(@rendition,'rnd:two-column')]">
   <sch:let name="children" value="child::tei:*"/>
   <sch:let name="leftChild" value="$children[contains-token(@rendition,'rnd:left')]"/>
   <sch:let name="rightChild" value="$children[contains-token(@rendition, 'rnd:right')]"/>
   <sch:assert test="exists($children) and (count(($leftChild, $rightChild)) = count($children))">ERROR: Every child of a two column layout must have either a rnd:right or a rnd:left rendition value.</sch:assert>
   <sch:assert test="exists($leftChild) and exists($rightChild)">ERROR: There must be at least one rnd:left and one rnd:right child</sch:assert>
</sch:rule>

Some renditions contradict each other

<sch:rule context="tei:*[@rendition]">
   <sch:let name="rendition" value="@rendition"/>
   <sch:let name="ptrs" value="tokenize(@rendition,'\s+')"/>
   <sch:let name="tokens" value="for $p in $ptrs return substring-after($p,'rnd:')"/>
   <sch:let name="duplicates" value="$tokens[count(index-of($tokens, .)) gt 1]"/>
   <sch:assert test="empty($duplicates)">ERROR: Duplicate renditions found:<sch:value-of select="string-join($duplicates,', ')"/>. Do not use the same rendition more than once on a single element.</sch:assert>
   <sch:assert test="count($tokens[. = ('left','right','center')]) lt 2">ERROR: rnd:right, rnd:left, or rnd:center are mutually exclusive.</sch:assert>
   <sch:assert test="count($tokens[. = ('large','small')]) lt 2">ERROR: rnd:large and rnd:small are mutually exclusive.</sch:assert>
   <sch:assert test="count($tokens[. = ('bordered-bottom','bordered-bottom-dashed')]) lt 2">ERROR: rnd:bordered-bottom and rnd:bordered-bottom-dashed are mutually exclusive.</sch:assert>
</sch:rule>

Source

Github

<classSpec rend="change" predeclare="true" module="tei" type="atts" ident="att.global.rendition">
   <desc>provides rendering attributes common to all elements in the TEI encoding scheme.</desc>
   <classes/>
   <attList>
      <attDef ident="rendition" usage="opt">
         <desc>points to a description of the rendering or presentation used for this element in the
    source text.</desc>
         <datatype maxOccurs="unbounded">
            <dataRef key="teidata.pointer"/>
         </datatype>
         <valList type="closed"/>
      </attDef>
   </attList>
</classSpec>