Skip to content

Commit 0a92772

Browse files
committed
Move 'Initial Text Direction' section under literals
1 parent afeea2c commit 0a92772

File tree

1 file changed

+36
-35
lines changed

1 file changed

+36
-35
lines changed

spec/index.html

Lines changed: 36 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1002,7 +1002,7 @@ <h3>Literals</h3>
10021002
</ul>
10031003

10041004
<section>
1005-
<h2>Representation of literals</h2>
1005+
<h4>Representation of literals</h4>
10061006

10071007
<p>Some concrete syntaxes MAY support
10081008
<dfn data-lt="simple literal" class="export">simple literals</dfn> consisting of only a
@@ -1043,7 +1043,7 @@ <h2>Representation of literals</h2>
10431043
</section>
10441044

10451045
<section>
1046-
<h2>Literal value</h2>
1046+
<h4>Literal value</h4>
10471047

10481048
<p>The <dfn class="export">literal value</dfn> associated with a <a>literal</a> is defined as follows.</p>
10491049

@@ -1089,6 +1089,40 @@ <h2>Literal value</h2>
10891089
same literal <a>RDF term</a> because their
10901090
<a>lexical forms</a> differ.</p>
10911091
</section>
1092+
1093+
<section id="section-text-direction" class="informative">
1094+
<h4>Initial text direction</h4>
1095+
1096+
<p>The <a>base direction</a> of a <a>directional language-tagged string</a>
1097+
provides a means of establishing the initial direction of text,
1098+
including text which is a mixture of right-to-left and left-to-right scripts.
1099+
The [=Unicode Bidirectional Algorithm=] [[?I18N-Glossary]] provides support for automatically rendering
1100+
a sequence of characters in logical order,
1101+
so that they are visually ordered as expected,
1102+
but this is not sufficient to correctly render bidirectional text.</p>
1103+
1104+
<p>For example, some text with a language tag "`he`" might be displayed
1105+
in a left-to-right context (such as an English web page) as
1106+
<bdi dir="ltr">פעילות הבינאום, W3C</bdi>, which is incorrect. When provided
1107+
to a user agent including base direction information (such as using
1108+
HTML's `dir` attribute) it can then be correctly presented as:
1109+
</p>
1110+
<div lang="he" dir="rtl">פעילות הבינאום, W3C</div>
1111+
1112+
<p>In the absence of an explicit initial text direction,
1113+
the [=Unicode Bidirectional Algorithm=] detects the text direction from the content.
1114+
This depends on the first strongly directional character in the text
1115+
or on the context.
1116+
To avoid [=spillover effects=], users need to employ [=bidi isolation=]
1117+
whenever text is inserted into a larger document.
1118+
For example,
1119+
&quot;<code>&lt;bdi lang="he"&gt;ספרים בינלאומיים!&lt;/bdi&gt;</code>&quot;
1120+
displays the Hebrew characters in a right-to-left fashion
1121+
— i.e., as &quot;<bdi lang="he">ספרים בינלאומיים!</bdi>&quot;
1122+
— while they would be stored in memory as
1123+
&quot;<bdo dir="ltr" lang="he">ספרים בינלאומיים!</bdo>&quot;</p>
1124+
</section>
1125+
10921126
</section>
10931127

10941128
<section id="section-blank-nodes">
@@ -1173,39 +1207,6 @@ <h3>Graph Comparison</h3>
11731207

11741208
</section>
11751209

1176-
<section id="section-text-direction" class="informative">
1177-
<h3>Initial Text Direction</h3>
1178-
1179-
<p>The <a>base direction</a> of a <a>directional language-tagged string</a>
1180-
provides a means of establishing the initial direction of text,
1181-
including text which is a mixture of right-to-left and left-to-right scripts.
1182-
The [=Unicode Bidirectional Algorithm=] [[?I18N-Glossary]] provides support for automatically rendering
1183-
a sequence of characters in logical order,
1184-
so that they are visually ordered as expected,
1185-
but this is not sufficient to correctly render bidirectional text.</p>
1186-
1187-
<p>For example, some text with a language tag "`he`" might be displayed
1188-
in a left-to-right context (such as an English web page) as
1189-
<bdi dir="ltr">פעילות הבינאום, W3C</bdi>, which is incorrect. When provided
1190-
to a user agent including base direction information (such as using
1191-
HTML's `dir` attribute) it can then be correctly presented as:
1192-
</p>
1193-
<div lang="he" dir="rtl">פעילות הבינאום, W3C</div>
1194-
1195-
<p>In the absence of an explicit initial text direction,
1196-
the [=Unicode Bidirectional Algorithm=] detects the text direction from the content.
1197-
This depends on the first strongly directional character in the text
1198-
or on the context.
1199-
To avoid [=spillover effects=], users need to employ [=bidi isolation=]
1200-
whenever text is inserted into a larger document.
1201-
For example,
1202-
&quot;<code>&lt;bdi lang="he"&gt;ספרים בינלאומיים!&lt;/bdi&gt;</code>&quot;
1203-
displays the Hebrew characters in a right-to-left fashion
1204-
— i.e., as &quot;<bdi lang="he">ספרים בינלאומיים!</bdi>&quot;
1205-
— while they would be stored in memory as
1206-
&quot;<bdo dir="ltr" lang="he">ספרים בינלאומיים!</bdo>&quot;</p>
1207-
</section>
1208-
12091210

12101211
</section>
12111212

0 commit comments

Comments
 (0)