Skip to content

Commit 80a93cf

Browse files
joeytakedajoeytakeda
authored
Merge pull request #2853 from TEIC/sydb_2744_describe_semanticly_duplicate_attrs_better
improving remarks describing attrs with similar semantics
2 parents 1ca10f1 + fb4f53f commit 80a93cf

4 files changed

Lines changed: 212 additions & 220 deletions

File tree

‎P5/Source/Specs/att.global.rendition.xml‎

Lines changed: 48 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,7 @@
55
<desc versionDate="2014-12-02" xml:lang="en">provides rendering attributes common to all elements in the TEI encoding scheme.</desc>
66
<desc versionDate="2019-07-21" xml:lang="ja">TEIの符号化スキーマにおけるすべての要素に共通するレンダリング属性を提供する。</desc>
77
<classes/>
8-
9-
108
<attList>
11-
12-
13-
149
<attDef ident="rend" usage="opt">
1510
<gloss versionDate="2007-07-02" xml:lang="en">rendition</gloss>
1611
<gloss versionDate="2007-12-20" xml:lang="ko">번역</gloss>
@@ -22,12 +17,9 @@
2217
<desc versionDate="2007-12-20" xml:lang="ko">문제의 요소가 원본 텍스트에 제시된 방법을 나타낸다.</desc>
2318
<desc versionDate="2007-05-02" xml:lang="zh-TW">指出該元素如何呈現於來源文件中</desc>
2419
<desc versionDate="2008-04-05" xml:lang="ja">当該要素が、元資料でどのように表示されていたかを示す。</desc>
25-
<desc versionDate="2007-06-12" xml:lang="fr">indique comment l'élément en question a été rendu ou
26-
présenté dans le texte source.</desc>
27-
<desc versionDate="2007-05-04" xml:lang="es">indica cómo el elemento en cuestión ha sido dado o
28-
proporcionado en el texto fuente.</desc>
29-
<desc versionDate="2007-01-21" xml:lang="it">indica come l'elemento in questione è stato reso o
30-
rappresentato nel testo originario</desc>
20+
<desc versionDate="2007-06-12" xml:lang="fr">indique comment l'élément en question a été rendu ou présenté dans le texte source.</desc>
21+
<desc versionDate="2007-05-04" xml:lang="es">indica cómo el elemento en cuestión ha sido dado o proporcionado en el texto fuente.</desc>
22+
<desc versionDate="2007-01-21" xml:lang="it">indica come l'elemento in questione è stato reso o rappresentato nel testo originario</desc>
3123
<datatype maxOccurs="unbounded"><dataRef key="teidata.word"/></datatype>
3224
<exemplum xml:lang="en">
3325
<egXML xmlns="http://www.tei-c.org/ns/Examples" xml:id="class-attr-global.rendition-egXML-ci">
@@ -44,7 +36,7 @@
4436
<exemplum versionDate="2010-02-26" xml:lang="fr">
4537
<egXML xmlns="http://www.tei-c.org/ns/Examples" xml:id="class-attr-global.rendition-egXML-gy" source="#fr-ex-Belloy">
4638
<head rend="align(center) case(allcaps)">épître dédicatoire<lb/>à <lb/>Monsieur de Coucy <lb/>
47-
<lb/>.</head>
39+
<lb/>.</head>
4840
</egXML>
4941
</exemplum>
5042
<remarks versionDate="2012-10-24" xml:lang="en">
@@ -73,43 +65,42 @@
7365
<remarks versionDate="2019-07-21" xml:lang="ja"><p>本ガイドラインでは、当該属性<att>rend</att>の値として推奨するものはない。活字化の特徴は様々であり、それらのどれを採用するかはプロジェクトごとでおそろしく異なるからである。当ガイドラインでは、有用な記述法があれば、その都度示すことになっている。<att>rend</att>属性の値は、空白によって区切られる順序不定の個々のトークンの集合である。</p></remarks>
7466
</attDef>
7567
<attDef ident="style" usage="opt">
76-
<desc versionDate="2012-10-05" xml:lang="en">contains an expression in some formal style definition language
77-
which defines the rendering or presentation
78-
used for this element in the source text.</desc>
68+
<desc versionDate="2012-10-05" xml:lang="en">contains an expression in some formal style definition language which defines the rendering or presentation used for this element in the source text.</desc>
7969
<desc versionDate="2022-05-09" xml:lang="ja">なんらかの形式的スタイル定義言語においてソーステキスト内の当該要素のレンダリングや表示を定義する際の表現を含む。</desc>
8070
<datatype maxOccurs="1"><dataRef key="teidata.text"/></datatype>
8171
<exemplum xml:lang="en">
8272
<egXML xmlns="http://www.tei-c.org/ns/Examples" xml:id="class-attr-global.rendition-egXML-zu">
83-
<head style="text-align: center; font-variant: small-caps"><lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her
73+
<head style="text-align: center; font-variant: small-caps;"><lb/>To The <lb/>Duchesse <lb/>of <lb/>Newcastle, <lb/>On Her
8474
<lb/><hi style="font-variant: normal">New Blazing-World</hi>. </head>
8575
</egXML>
8676
</exemplum>
8777
<remarks versionDate="2017-07-02" xml:lang="en">
88-
<p>Unlike the attribute values of <att>rend</att>, which uses whitespace as a separator, the <att>style</att> attribute may contain whitespace. This attribute is intended for recording inline stylistic information concerning the
89-
source, not any particular output.</p>
90-
<p>The formal language in which values for this attribute are expressed may be specified using the <gi>styleDefDecl</gi> element in
91-
the TEI header.</p>
92-
<p>If <att>style</att> and <att>rendition</att> are both present on an element, then
93-
<att>style</att> overrides or complements <att>rendition</att>. <att>style</att> should
94-
not be used in conjunction with <att>rend</att>, because the latter does not employ a
95-
formal style definition language.</p>
78+
<p>Unlike the attribute values of <att>rend</att>, which uses
79+
whitespace as a separator, the <att>style</att> attribute may
80+
contain whitespace. This attribute is intended for recording
81+
inline stylistic information concerning the source, not any
82+
particular output.</p>
83+
<p>The formal language in which values for this attribute are
84+
expressed may be specified using the <gi>styleDefDecl</gi>
85+
element in the TEI header.</p>
86+
<p>If <att>style</att> and <att>rendition</att> are both
87+
present on an element, then <att>style</att> overrides or
88+
complements <att>rendition</att>. <att>style</att> should not
89+
be used in conjunction with <att>rend</att>, because the
90+
latter does not employ a formal style definition language.</p>
9691
</remarks>
9792
<remarks versionDate="2019-07-21" xml:lang="ja">
9893
<p>空白を区切り記号とする<att>rend</att>の属性値とは異なり、<att>style</att>属性は空白を含んでもよい。この属性は資料における行に埋め込まれたスタイル情報を記録するためのものであり、何らかの出力を対象とするものではない。</p>
9994
<p>この属性の値を表現する形式言語はTEIヘッダにおいて<gi>styleDefDecl</gi>要素を用いて指定されてもよい。</p>
10095
<p>もし<att>style</att>と<att>rendition</att>の両方が一つの要素に現れる場合、<att>style</att>は<att>rendition</att>を上書きもしくは補完する。<att>style</att>は<att>rend</att>と同時に用いられるべきではない。後者は形式的なスタイル定義言語を採用しているわけではないから。</p></remarks>
10196
</attDef>
10297
<attDef ident="rendition" usage="opt">
103-
<desc versionDate="2007-09-22" xml:lang="en">points to a description of the rendering or presentation used for this element in the
104-
source text.</desc>
98+
<desc versionDate="2007-09-22" xml:lang="en">points to a description of the rendering or presentation used for this element in the source text.</desc>
10599
<desc versionDate="2007-12-20" xml:lang="ko">원본 텍스트에서 이 요소에 대해 사용된 모양과 제시에 대한 기술을 가리킨다.</desc>
106-
<desc versionDate="2008-04-06" xml:lang="es">indica una descripción de la representación o de la
107-
presentación empleada para este elemento en el texto original.</desc>
100+
<desc versionDate="2008-04-06" xml:lang="es">indica una descripción de la representación o de la presentación empleada para este elemento en el texto original.</desc>
108101
<desc versionDate="2008-04-05" xml:lang="ja">当該要素が示す表現が現れている、元資料のテキスト部分を示す。</desc>
109-
<desc versionDate="2008-03-30" xml:lang="fr">pointe vers une description du rendu ou de la
110-
présentation utilisés pour cet élément dans le texte source.</desc>
111-
<desc versionDate="2007-11-06" xml:lang="it">indica una descrizione della resa o della
112-
presentazione utilizzate per tale elemento nel testo di partenza</desc>
102+
<desc versionDate="2008-03-30" xml:lang="fr">pointe vers une description du rendu ou de la présentation utilisés pour cet élément dans le texte source.</desc>
103+
<desc versionDate="2007-11-06" xml:lang="it">indica una descrizione della resa o della presentazione utilizzate per tale elemento nel testo di partenza</desc>
113104
<datatype maxOccurs="unbounded"><dataRef key="teidata.pointer"/></datatype>
114105
<exemplum xml:lang="en">
115106
<egXML xmlns="http://www.tei-c.org/ns/Examples" xml:id="class-attr-global.rendition-egXML-as">
@@ -130,22 +121,27 @@ the TEI header.</p>
130121
</egXML>
131122
</exemplum>
132123
<remarks versionDate="2017-07-02" xml:lang="en">
133-
<p>The <att>rendition</att> attribute is used in a very similar way to the <att>class</att>
134-
attribute defined for XHTML but with the important distinction that its function is to
135-
describe the appearance of the source text, not necessarily to determine how that text
136-
should be presented on screen or paper.</p>
137-
<p>If <att>rendition</att> is used to refer to a style definition in a formal language like
138-
CSS, it is recommended that it not be used in conjunction with <att>rend</att>.
139-
Where both <att>rendition</att> and <att>rend</att> are supplied, the latter is
140-
understood to override or complement the former.</p>
141-
<p>Each URI provided should indicate a <gi>rendition</gi> element defining the intended
142-
rendition in terms of some appropriate style language, as indicated by the
143-
<att>scheme</att> attribute.</p>
124+
<p>The <att>rendition</att> attribute is used in a very
125+
similar way to the <att>class</att> attribute defined for
126+
XHTML but with the important distinction that its function is
127+
to describe the appearance of the source text, not necessarily
128+
to determine how that text should be presented on screen or
129+
paper.</p>
130+
<p>If <att>rendition</att> is used to refer to a style
131+
definition in a formal language like CSS, it is recommended
132+
that it not be used in conjunction with <att>rend</att>.
133+
<!-- Where both <att>rendition</att> and <att>rend</att> are
134+
supplied, the latter is understood to override or complement
135+
the former. --></p>
136+
<p>Each URI provided should indicate a <gi>rendition</gi>
137+
element defining the intended rendition in terms of some
138+
appropriate style language, as indicated by the
139+
<att>scheme</att> attribute.</p>
144140
</remarks>
145141
<remarks versionDate="2019-07-21" xml:lang="ja">
146142
<p>属性<att>rendition</att>は、XHTMLの属性<att>class</att>と大変 似たように使用される。但し、重要な違いとして、当該属性は、元資 料の表現を記述するものであり、スクリーン上または紙上でどう表示 されているかを示すものではない。</p>
147-
<p> もし<att>rendition</att>属性がCSSのような形式言語において定義されるスタイル定義を参照するのに用いられているなら、<att>rend</att>属性と同時に用いないことが推奨される。属性<att>rendition</att>と属性<att>rend</att>の両方が使用されている場合、後者の値が前者の値を上書きする、または補うと判断される。</p>
148-
<p> 当該属性値となるURIは、属性<att>scheme</att>で提示されているス タイル言語により、当該表現を定義する要素<gi>rendition</gi>を示すべきである。</p></remarks>
143+
<p>もし<att>rendition</att>属性がCSSのような形式言語において定義されるスタイル定義を参照するのに用いられているなら、<att>rend</att>属性と同時に用いないことが推奨される。属性<att>rendition</att>と属性<att>rend</att>の両方が使用されている場合、後者の値が前者の値を上書きする、または補うと判断される。</p>
144+
<p>当該属性値となるURIは、属性<att>scheme</att>で提示されているス タイル言語により、当該表現を定義する要素<gi>rendition</gi>を示すべきである。</p></remarks>
149145
<remarks versionDate="2007-06-12" xml:lang="fr">
150146
<p>L'attribut <att>rendition</att> est employé à peu près de la même manière que l'attribut
151147
<att>class</att> défini pour XHTML mais avec cette sérieuse différence que sa fonction
@@ -169,9 +165,14 @@ the TEI header.</p>
169165
indicado por el atributo <att>scheme</att> (esquema).</p>
170166
</remarks>
171167
</attDef>
172-
173-
174168
</attList>
169+
<remarks versionDate="2026-01-03" xml:lang="en">
170+
<p>These guidelines provide no semantic basis or suggested
171+
precedence when both <att>rend</att> and <att>rendition</att> are
172+
provided. For this reason simultaneous use of both is not
173+
recommended for interchange unless documentation explaining the
174+
use is provided, probably in an ODD customization.</p>
175+
</remarks>
175176
<listRef>
176177
<ptr target="#STGAre"/>
177178
</listRef>

0 commit comments

Comments
 (0)