Skip to content

Commit de0a8a1

Browse files
raffazizziraffazizzi
committed
Prose adjustments and schematron for addressing #1981 
1 parent 9521245 commit de0a8a1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+350
-27
lines changed

‎P5/Source/Guidelines/en/CC-LanguageCorpora.xml

+26-27
Original file line numberDiff line numberDiff line change
@@ -798,7 +798,7 @@ will be more than one instance of a header element of the relevant type.
798798
<item>A given element may appear in the corpus header only, in the
799799
header of one or more texts only, or in both places</item>
800800
<item>There may be multiple occurrences of certain elements in either
801-
corpus or text header.</item></list>
801+
the corpus or a text header.</item></list>
802802
</p>
803803
<p>To simplify the exposition, we deal with these two possibilities
804804
separately in what follows; however, they may be combined as
@@ -877,7 +877,7 @@ encoding description. The second one has its own encoding description.
877877
<p>Certain of the elements which can appear within a TEI header are
878878
known as <term>declarable elements</term>. These elements have in
879879
common the fact that they may be linked explicitly with a particular
880-
part of a text or corpus by means of a <att>decls</att> attribute on
880+
part of a text header or the corpus header by means of a <att>decls</att> attribute on
881881
that element. This linkage is used to over-ride the default
882882
association between declarations in the header and a corpus or corpus
883883
text. The only header elements which may be associated in this way are
@@ -918,15 +918,15 @@ elements are all members of the class <ident type="class">att.declaring</ident>.
918918
<specDesc key="textDesc"/>
919919
<specDesc key="xenoData"/>
920920
</specList>
921-
All of the above elements may be multiply defined within a single
922-
header, that is, there may be more than one instance of any declarable
923-
element type at a given level. When this occurs, the following rules
921+
Each of the above elements is repeatable within a single
922+
header; that is, there may be more than one instance of any declarable
923+
element type at a given level. When this occurs, the following rules
924924
apply:
925925
<list rend="bulleted">
926926
<item>every declarable element must bear a unique identifier</item>
927927
<item>for each different type of declarable element which occurs more
928928
than once within the same parent element, exactly one element must be
929-
specified as the default, by means of the <att>default</att> attribute
929+
specified as the default, by having a <att>default</att> attribute with the value "true".
930930
</item></list>
931931
</p>
932932
<p>In the following example, an editorial declaration contains two
@@ -947,32 +947,31 @@ specified as the default: <egXML xmlns="http://www.tei-c.org/ns/Examples"><edito
947947
</editorialDecl></egXML> For texts associated with the header in which
948948
this declaration appears, correction method <val>CorPol1</val> will be
949949
assumed, unless they explicitly state otherwise. Here is the
950-
structure for a text which does state otherwise: <egXML xmlns="http://www.tei-c.org/ns/Examples" source="#UND"><text>
950+
structure of a text in which a division states otherwise: <egXML xmlns="http://www.tei-c.org/ns/Examples" source="#UND"><text>
951951
<body>
952-
<div1 n="d1"> </div1>
953-
<div1 n="d2" decls="#CorPol2"> </div1>
954-
<div1 n="d3"> </div1>
952+
<div1 n="D1"> </div1>
953+
<div1 n="D2" decls="#CorPol2"> </div1>
954+
<div1 n="D3"> </div1>
955955
</body>
956956
</text></egXML> In this case, the contents of the divisions D1 and D3
957957
will both use correction policy <val>CorPol1</val>, and those of
958958
division D2 will use correction policy <val>CorPol2</val>.
959959
</p>
960960
<p>The <att>decls</att> attribute is defined for any element which is a
961-
member of the class <term>declaring</term>. This includes the major
961+
member of the class <term>declaring</term>. This includes the major
962962
structural elements <gi>text</gi>, <gi>group</gi>, and <gi>div</gi>, as
963963
well as smaller structural units, down to the level of paragraphs in
964964
prose, individual utterances in spoken texts, and entries in
965-
dictionaries. However, TEI recommended practice is to limit the number
965+
dictionaries. However, TEI recommended practice is to limit the number
966966
of multiple declarable elements used by a document as far as possible,
967967
for simplicity and ease of processing.
968968
</p>
969-
<p>The identifier or identifiers specified by the <att>decls</att>
970-
attribute are subject to two further restrictions:
969+
<p>The identifier or identifiers to which the <att>decls</att>
970+
attribute points must follow two further restrictions:
971971
<list rend="bulleted">
972-
<item>An identifier specifying an element which contains multiple
973-
instances of one or more other elements should be interpreted as if it
974-
explicitly identified the elements identified as the default in each
975-
such set of repeated elements</item>
972+
<item>When <att>decl</att> references an element that itself contains multiple
973+
elements of the same type, only the children elements with <att>default</att>
974+
set to "true" are considered referenced.</item>
976975
<item>Each element specified, explicitly or implicitly, by the list of
977976
identifiers must be of a different kind.</item></list>
978977
</p>
@@ -1003,18 +1002,18 @@ identified as <val>ED1</val> (the default) and <val>ED2</val>. For texts not sp
10031002
otherwise, <val>ED1</val> will apply. If <val>ED1</val> applies, correction method C1A and
10041003
normalization method N1 apply, since these are the specified defaults
10051004
within <val>ED1</val>. In the same way, for a text specifying <att>decls</att> as
1006-
<q><val>ED2</val></q>, correction C2A,
1005+
<q><val>#ED2</val></q>, correction C2A,
10071006
and normalization N2B will
10081007
apply.
10091008
</p>
10101009
<p>A finer grained approach is also possible. A text might specify
1011-
<tag>text decls='C2B N2A'</tag>,
1010+
<tag>text decls='#C2B #N2A'</tag>,
10121011
to <soCalled>mix and match</soCalled> declarations as
1013-
required. A tag such as <tag>text decls='ED1 ED2'</tag> would
1012+
required. A tag such as <tag>text decls='#ED1 #ED2'</tag> would
10141013
(obviously) be illegal, since it includes two elements of the same type;
1015-
a tag such as <tag>text decls='ED2 C1A'</tag> is also illegal, since in
1016-
this context <val>ED2</val> is synonymous with the defaults for that
1017-
editorial declaration, namely <val>C2A N2B</val>, resulting in a list
1014+
a tag such as <tag>text decls='#ED2 #C1A'</tag> is also illegal, since in
1015+
this context <val>#ED2</val> is synonymous with the defaults for that
1016+
editorial declaration, namely <val>#C2A #N2B</val>, resulting in a list
10181017
that identifies two correction elements (C1A and C2A).
10191018
</p></div>
10201019
<div type="div3" xml:id="CCAS3"><head>Summary</head>
@@ -1028,12 +1027,12 @@ within the corpus.</item>
10281027
element in the text header, then it applies by default to all elements
10291028
of that text irrespective of the contents of the corpus header.</item>
10301029
<item>Where there are multiple occurrences of declarable elements
1031-
within either corpus or text header,
1030+
within a text’s header or its corpus header,
10321031
<list rend="bulleted">
10331032
<item>each must have a unique value specified as the value
10341033
of its <att>xml:id</att> attribute;</item>
1035-
<item>one only must bear a <att>default</att> attribute with
1036-
the value <!-- JC: 2018-07-20: This should be changed to 'true' --><val>YES</val>.</item></list></item>
1034+
<item>one and only one must bear a <att>default</att> attribute with
1035+
the value <val>true</val> (or <val>1</val>).</item></list></item>
10371036
<item>It is a semantic error for an element to be associated
10381037
with more than one occurrence of any declarable element.</item>
10391038
<item>Selecting an element which contains multiple occurrences of a

‎P5/Source/Specs/att.declarable.xml

+16
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,22 @@ $Id$
1616
<desc versionDate="2007-05-04" xml:lang="es">proporciona atributos para los elementos contenidos en el encabezado que pueden ser seleccionados autónomamente mediante el atributo <att>decls</att> adecuado.</desc>
1717
<desc versionDate="2007-01-21" xml:lang="it">individua attributi per gli elementi contenuti nell'intestazione che possono essere selezionati autonomamente grazie all'apposito attributo <att>decls</att>
1818
</desc>
19+
<constraintSpec ident="att-declarable" scheme="schematron">
20+
<constraint>
21+
<sch:pattern id="declarable" abstract="true">
22+
<!-- parameter 'tde' is for "this declarable element (type)" -->
23+
<sch:rule context="tei:*[child::$tde[2]]">
24+
<sch:let name="declarableGI" value="name( $tde[1] )"/>
25+
<sch:report test="child::$tde[ not( @xml:id ) ]">
26+
When there is more than one <sch:value-of select="$declarableGI"/>, each must have an @xml:id
27+
</sch:report>
28+
<sch:assert test="count( child::$tde[ normalize-space( @default ) = ('1','true') ] ) eq 1">
29+
When there is more than one <sch:value-of select="$declarableGI"/>, one and only one must have a @default of 'true'.
30+
</sch:assert>
31+
</sch:rule>
32+
</sch:pattern>
33+
</constraint>
34+
</constraintSpec>
1935
<attList>
2036
<attDef ident="default" usage="opt">
2137
<desc versionDate="2005-10-10" xml:lang="en">indicates whether or not this element is selected by default when

‎P5/Source/Specs/att.declaring.xml

+35
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,41 @@ $Id$
1515
ainsi la valeur dont cet élément devrait hériter par défaut</desc>
1616
<desc versionDate="2007-05-04" xml:lang="es">proporciona atributos a los elementos que pueden ser asociados autonomamente a un elemento determinado declarado en el encabezado, no teniendo en cuenta el default heredato por aquel elemento.</desc>
1717
<desc versionDate="2007-01-21" xml:lang="it">assegna attributi agli elementi che possono essere autonomamente associati a un determinato elemento dichiarato nell'intestazione, non tenendo conto del default ereditato per quell'elemento</desc>
18+
<constraintSpec ident="att-declaring-decls" scheme="schematron">
19+
<constraint>
20+
<sch:pattern id="decls" abstract="false">
21+
<!--
22+
Use element as context, as some processors inappropriately barf when a context
23+
is an attribute node:
24+
-->
25+
<sch:rule context="tei:*[@decls]">
26+
<!-- sequence of decls pointers: -->
27+
<sch:let name="dptrs" value="tokenize( normalize-space( @decls ), '&#x20;')"/>
28+
<!-- sequence of the @xml:ids pointed at by each decls pointer: -->
29+
<sch:let name="dxids" value="for $dptr in $dptrs return substring-after( $dptr, '#')"/>
30+
<!-- sequence of the target elements of the decls pointers: -->
31+
<sch:let name="dtars" value="for $dptr in $dptrs return
32+
if ( starts-with( $dptr, '#') )
33+
then id( substring-after( $dptr, '#') )
34+
else if ( contains( $dptr, '#') )
35+
then doc( $dptr )/id( substring-after( $dptr, '#') )
36+
else current()"/>
37+
<!-- sequence of the element types of the taret elements of the decls ptrs: -->
38+
<sch:let name="dtGIs" value="for $dtar in $dtars return name( $dtar )"/>
39+
<!-- sequence of the children of the targets of the decls pointers: -->
40+
<sch:let name="dtars_kids" value="$dtars/tei:*"/>
41+
<!-- sequence of the names of the children: -->
42+
<sch:let name="dtars_kids_GIs" value="for $kid in $dtars_kids return name( $kid )"/>
43+
<!-- sequence of all the GIs (target and target children): -->
44+
<sch:let name="decls_GIs" value="( $dtGIs, $dtars_kids_GIs )"/>
45+
<sch:assert test="count( $decls_GIs ) eq count( distinct-values( $decls_GIs ) )">
46+
Two or more of the elements referred to either explicitly or implicitly by the @decls if this <sch:name/> (<sch:value-of
47+
select="$dptrs"/>) are the same kind of metadata element.
48+
</sch:assert>
49+
</sch:rule>
50+
</sch:pattern>
51+
</constraint>
52+
</constraintSpec>
1853
<attList>
1954
<attDef ident="decls" usage="opt">
2055
<desc versionDate="2005-10-10" xml:lang="en">identifies one or more <term>declarable elements</term> within the

‎P5/Source/Specs/availability.xml

+7
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,13 @@ $Id$
2424
<desc versionDate="2007-01-21" xml:lang="it">fornisce informazioni sulla disponibilità di un testo,
2525
per esempio su qualsiasi restrizione che si applica alla sua utilizzazione o distribuzione, il
2626
suo statuto in merito al copyright, etc.</desc>
27+
<constraintSpec ident="availability-xeno" scheme="schematron">
28+
<constraint>
29+
<sch:pattern id="declarable_xenoData" is-a="declarable">
30+
<sch:param name="tde" value="tei:xenoData"/>
31+
</sch:pattern>
32+
</constraint>
33+
</constraintSpec>
2734
<classes>
2835
<memberOf key="att.global"/>
2936
<memberOf key="model.publicationStmtPart.detail"/>

‎P5/Source/Specs/bibl.xml

+7
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,13 @@
2525
liberamente i cui componeneti potrebbero o meno essere codificati esplicitamente.</desc>
2626
<desc versionDate="2017-06-13" xml:lang="de">enthält eine lose strukturierte bibliografische Angabe, in der einzelne Komponenten explizit
2727
ausgezeichnet sein können.</desc>
28+
<constraintSpec ident="bibl-xeno" scheme="schematron">
29+
<constraint>
30+
<sch:pattern id="declarable_xenoData" is-a="declarable">
31+
<sch:param name="tde" value="tei:xenoData"/>
32+
</sch:pattern>
33+
</constraint>
34+
</constraintSpec>
2835
<classes>
2936
<memberOf key="att.global"/>
3037
<memberOf key="model.biblLike"/>

‎P5/Source/Specs/biblFull.xml

+7
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,13 @@ $Id$
2323
TEI.</desc>
2424
<desc versionDate="2007-01-21" xml:lang="it">contiene una citazione bibliografica interamente
2525
strutturata nella quale sono presenti tutti i componenti di descrizione di un file TEI.</desc>
26+
<constraintSpec ident="biblFull-xeno" scheme="schematron">
27+
<constraint>
28+
<sch:pattern id="declarable_xenoData" is-a="declarable">
29+
<sch:param name="tde" value="tei:xenoData"/>
30+
</sch:pattern>
31+
</constraint>
32+
</constraintSpec>
2633
<classes>
2734
<memberOf key="att.global"/>
2835
<memberOf key="model.biblLike"/>

‎P5/Source/Specs/biblStruct.xml

+7
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,13 @@
2222
sólo aparecen los subelementos bibliográficos y en un orden especificado.</desc>
2323
<desc versionDate="2007-01-21" xml:lang="it">contiene una citazione bibliografica strutturata che può
2424
contenere solo altri elemento nell'ordine specificato.</desc>
25+
<constraintSpec ident="biblStruct-xeno" scheme="schematron">
26+
<constraint>
27+
<sch:pattern id="declarable_xenoData" is-a="declarable">
28+
<sch:param name="tde" value="tei:xenoData"/>
29+
</sch:pattern>
30+
</constraint>
31+
</constraintSpec>
2532
<classes>
2633
<memberOf key="att.global"/>
2734
<memberOf key="model.biblLike"/>

‎P5/Source/Specs/broadcast.xml

+7
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,13 @@ $Id$
2020
die als Quelle eines gesprochenen Textes genutzt wird</desc>
2121
<desc versionDate="2007-05-04" xml:lang="es">describe la emisión usada como fuente de un texto escrito.</desc>
2222
<desc versionDate="2007-01-21" xml:lang="it">descrive una messa in onda utilizzata quale fonte di un testo orale.</desc>
23+
<constraintSpec ident="broadcast-xeno" scheme="schematron">
24+
<constraint>
25+
<sch:pattern id="declarable_xenoData" is-a="declarable">
26+
<sch:param name="tde" value="tei:xenoData"/>
27+
</sch:pattern>
28+
</constraint>
29+
</constraintSpec>
2330
<classes>
2431
<memberOf key="att.global"/>
2532
<memberOf key="att.declarable"/>

‎P5/Source/Specs/correction.xml

+7
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,13 @@ $Id$
2424
el texto.</desc>
2525
<desc versionDate="2007-01-21" xml:lang="it">dichiara quante correzioni sono state apportate al testo
2626
e in quali circostanze.</desc>
27+
<constraintSpec ident="correction-xeno" scheme="schematron">
28+
<constraint>
29+
<sch:pattern id="declarable_xenoData" is-a="declarable">
30+
<sch:param name="tde" value="tei:xenoData"/>
31+
</sch:pattern>
32+
</constraint>
33+
</constraintSpec>
2734
<classes>
2835
<memberOf key="att.global"/>
2936
<memberOf key="att.declarable"/>

‎P5/Source/Specs/correspDesc.xml

+7
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@
99
description</gloss>
1010
<desc versionDate="2015-01-29" xml:lang="en">contains a description
1111
of the actions related to one act of correspondence.</desc>
12+
<constraintSpec ident="correspDesc-xeno" scheme="schematron">
13+
<constraint>
14+
<sch:pattern id="declarable_xenoData" is-a="declarable">
15+
<sch:param name="tde" value="tei:xenoData"/>
16+
</sch:pattern>
17+
</constraint>
18+
</constraintSpec>
1219
<classes>
1320
<memberOf key="model.profileDescPart"/>
1421
<memberOf key="att.declarable"/>

‎P5/Source/Specs/editorialDecl.xml

+7
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,13 @@ during the encoding of a text.</desc>
2121
<desc versionDate="2006-10-18" xml:lang="de">beschreibt die Details der Editionsprinzipien und Verfahren, die bei der Kodierung des Textes angewandt wurden.</desc>
2222
<desc versionDate="2007-05-04" xml:lang="es">proporciona detalles de principios editoriales y prácticas aplicadas en la codificación de un texto.</desc>
2323
<desc versionDate="2007-01-21" xml:lang="it">fornisce dettagli su principi e pratiche editoriali seguite nella codifica di un testo.</desc>
24+
<constraintSpec ident="editorialDecl-xeno" scheme="schematron">
25+
<constraint>
26+
<sch:pattern id="declarable_xenoData" is-a="declarable">
27+
<sch:param name="tde" value="tei:xenoData"/>
28+
</sch:pattern>
29+
</constraint>
30+
</constraintSpec>
2431
<classes>
2532
<memberOf key="att.global"/>
2633
<memberOf key="model.encodingDescPart"/>

‎P5/Source/Specs/equipment.xml

+7
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,13 @@ an audio or video recording used as the source for a spoken text.</desc>
2323
</desc>
2424
<desc versionDate="2007-05-04" xml:lang="es">proporciona detalles técnicos sobre el equipo y los medios empleados para la grabación de un audio o video usados como fuente de un texto hablado.</desc>
2525
<desc versionDate="2007-01-21" xml:lang="it">fornisce dettagli tecnici sull'attrezzatura per una registrazione audio o video utilizzata quale fonte di un testo orale.</desc>
26+
<constraintSpec ident="equipment-xeno" scheme="schematron">
27+
<constraint>
28+
<sch:pattern id="declarable_xenoData" is-a="declarable">
29+
<sch:param name="tde" value="tei:xenoData"/>
30+
</sch:pattern>
31+
</constraint>
32+
</constraintSpec>
2633
<classes>
2734
<memberOf key="att.global"/>
2835
<memberOf key="att.declarable"/>

‎P5/Source/Specs/geoDecl.xml

+7
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,13 @@ $Id$
2626
<desc versionDate="2007-11-06" xml:lang="it">documenta la notazione e il dato utilizzati per le
2727
coordinate geografiche espressi come contenuto di un elemento geo collocato altrove all'interno
2828
del documento</desc>
29+
<constraintSpec ident="geoDecl-xeno" scheme="schematron">
30+
<constraint>
31+
<sch:pattern id="declarable_xenoData" is-a="declarable">
32+
<sch:param name="tde" value="tei:xenoData"/>
33+
</sch:pattern>
34+
</constraint>
35+
</constraintSpec>
2936
<classes>
3037
<memberOf key="att.global"/>
3138
<memberOf key="model.encodingDescPart"/>

‎P5/Source/Specs/hyphenation.xml

+7
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,13 @@ $Id$
2323
presente en el texto fuente en la versión codificada de este.</desc>
2424
<desc versionDate="2007-01-21" xml:lang="it">riassume il modo in cui il trattino nell'originale sia
2525
stato trattato nella versione codificata dello stesso testo.</desc>
26+
<constraintSpec ident="hyphenation-xeno" scheme="schematron">
27+
<constraint>
28+
<sch:pattern id="declarable_xenoData" is-a="declarable">
29+
<sch:param name="tde" value="tei:xenoData"/>
30+
</sch:pattern>
31+
</constraint>
32+
</constraintSpec>
2633
<classes>
2734
<memberOf key="att.global"/>
2835
<memberOf key="att.declarable"/>

‎P5/Source/Specs/interpretation.xml

+7
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,13 @@ $Id$
2323
o descriptiva añadida al texto en la transcripción.</desc>
2424
<desc versionDate="2007-01-21" xml:lang="it">descrive l'estenione di qualsiasi informazione analitica
2525
o interpretativa inserita nel testo, in aggiunta alla trascrizione</desc>
26+
<constraintSpec ident="interpretation-xeno" scheme="schematron">
27+
<constraint>
28+
<sch:pattern id="declarable_xenoData" is-a="declarable">
29+
<sch:param name="tde" value="tei:xenoData"/>
30+
</sch:pattern>
31+
</constraint>
32+
</constraintSpec>
2633
<classes>
2734
<memberOf key="att.global"/>
2835
<memberOf key="att.declarable"/>

‎P5/Source/Specs/langUsage.xml

+7
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,13 @@ langues, registres, dialectes, etc. présents à l’intérieur d’un texte.</d
2222
<desc versionDate="2016-11-17" xml:lang="de">beschreibt Sprachen, Subsprachen, Register, Dialekte usw., die innerhalb eines Textes vorkommen.</desc>
2323
<desc versionDate="2007-05-04" xml:lang="es">describe las lenguas, jergas, registros, dialectos, etc. presentes en el texto.</desc>
2424
<desc versionDate="2007-01-21" xml:lang="it">descrive le lingue, i linguaggi secondari, i registri, i dialetti ecc. rappresentati all'interno di un testo.</desc>
25+
<constraintSpec ident="langUsage-xeno" scheme="schematron">
26+
<constraint>
27+
<sch:pattern id="declarable_xenoData" is-a="declarable">
28+
<sch:param name="tde" value="tei:xenoData"/>
29+
</sch:pattern>
30+
</constraint>
31+
</constraintSpec>
2532
<classes>
2633
<memberOf key="att.global"/>
2734
<memberOf key="model.profileDescPart"/>

0 commit comments

Comments
 (0)