Skip to content

Commit b88e0ca

Browse files
fantasaifantasai
committed
[css-text] Intro
1 parent 7b630a1 commit b88e0ca

File tree

3 files changed

+96
-44
lines changed

3 files changed

+96
-44
lines changed

‎css-text/Overview.html

+54-24
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
rel=dcterms.rights>
1111
<meta content="CSS Text Module Level 3 (CSS3 Text)" name=dcterms.title>
1212
<meta content=text name=dcterms.type>
13-
<meta content=2013-06-10 name=dcterms.date>
13+
<meta content=2013-06-14 name=dcterms.date>
1414
<meta content="Elika J. Etemad" name=dcterms.creator>
1515
<meta content="Koji Ishii" name=dcterms.creator>
1616
<meta content=W3C name=dcterms.publisher>
@@ -46,12 +46,12 @@
4646

4747
<h1>CSS Text Module Level 3</h1>
4848

49-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 10 June 2013</h2>
49+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 14 June 2013</h2>
5050

5151
<dl>
5252
<dt>This version:</dt>
5353
<!--
54-
<dd><a href="http://www.w3.org/TR/2013/WD-css3-text-20130610/">http://www.w3.org/TR/2013/WD-css3-text-20130610/</a></dd>
54+
<dd><a href="http://www.w3.org/TR/2013/WD-css3-text-20130614/">http://www.w3.org/TR/2013/WD-css3-text-20130614/</a></dd>
5555
-->
5656

5757
<dd><a
@@ -185,8 +185,7 @@ <h2 class="no-num no-toc" id=status>Status of This Document</h2>
185185
class=property>word-spacing</code></a>’
186186

187187
<li>minimum and maximum limits of ‘<a href="#word-spacing0"><code
188-
class=property>word-spacing</code></a>’ and ‘<a
189-
href="#letter-spacing0"><code class=property>letter-spacing</code></a>’
188+
class=property>word-spacing</code></a>’
190189

191190
<li>the ‘<a href="#hanging-punctuation0"><code
192191
class=property>hanging-punctuation</code></a>’ property
@@ -209,8 +208,8 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
209208
<li><a href="#transforming"><span class=secno>2. </span> Transforming
210209
Text</a>
211210
<ul class=toc>
212-
<li><a href="#text-transform"><span class=secno>2.1. </span>
213-
Transforming Text: the ‘<code class=property>text-transform</code>’
211+
<li><a href="#text-transform"><span class=secno>2.1. </span> Case
212+
Transforms: the ‘<code class=property>text-transform</code>’
214213
property</a>
215214
</ul>
216215

@@ -353,27 +352,59 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
353352

354353
<h2 id=intro><span class=secno>1. </span> Introduction</h2>
355354

356-
<p>[document here]
355+
<p>This module describes the typesetting controls of CSS; that is, the
356+
features of CSS that control the translation of source text to formatted,
357+
line-wrapped text. Various CSS properties provide control over <a
358+
href="#transforming">case transformation</a>, <a href="#white-space">white
359+
space collapsing</a>, <a href="#white-space">text wrapping</a>, <a
360+
href="#line-breaking">line breaking rules</a> and <a
361+
href="#hyphenation">hyphenation</a>, <a href="#justification">alignment
362+
and justification</a>, <a href="#spacing">spacing</a>, and <a
363+
href="#edge-effects">indentation</a>.
364+
365+
<div class=note>
366+
<p>Font selection is covered in <a
367+
href="http://www.w3.org/TR/css3-fonts/">CSS Fonts Level 3</a> <a
368+
href="#CSS3-FONTS" rel=biblioentry>[CSS3-FONTS]<!--{{CSS3-FONTS}}--></a>.
369+
370+
<p> <a name=decoration></a> <a name=text-decoration></a> <a
371+
name=line-decoration></a> <a name=text-decoration-line></a> <a
372+
name=text-decoration-color></a> <a name=text-decoration-style></a> <a
373+
name=text-decoration-skip></a> <a name=text-underline-position></a> <a
374+
name=emphasis-marks></a> <a name=text-emphasis-style></a> <a
375+
name=text-emphasis-color></a> <a name=text-emphasis></a> <a
376+
name=text-emphasis-position></a> <a name=text-shadow></a> Features for
377+
decorating text, such as <a
378+
href="http://www.w3.org/TR/css-text-decor-3/#line-decoration">underlines</a>,
379+
<a href="http://www.w3.org/TR/css-text-decor-3/#emphasis-marks">emphasis
380+
marks</a>, and <a
381+
href="http://www.w3.org/TR/css-text-decor-3/#text-shadow-property">shadows</a>,
382+
(previously part of this module) are covered in <a
383+
href="http://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level
384+
3</a> <a href="#CSS3-TEXT-DECOR"
385+
rel=biblioentry>[CSS3-TEXT-DECOR]<!--{{CSS3-TEXT-DECOR}}--></a>.
386+
387+
<p><a
388+
href="http://www.w3.org/TR/css3-writing-modes/#text-direction">Bidirectional</a>
389+
and <a
390+
href="http://www.w3.org/TR/css3-writing-modes/#vertical-intro">vertical</a>
391+
text are addressed in <a
392+
href="http://www.w3.org/TR/css3-writing-modes/">CSS Writing Modes Level
393+
3</a> <a href="#CSS3-WRITING-MODES"
394+
rel=biblioentry>[CSS3-WRITING-MODES]<!--{{CSS3-WRITING-MODES}}--></a>.
395+
</div>
357396

358397
<p class=issue>This draft describes features that are specific to certain
359398
scripts. There is an ongoing discussion about where these features belong:
360399
in existing CSS properties, in new CSS properties, or perhaps in other
361400
specifications.
362401

363-
<p class=note> <a name=decoration></a> <a name=text-decoration></a> <a
364-
name=line-decoration></a> <a name=text-decoration-line></a> <a
365-
name=text-decoration-color></a> <a name=text-decoration-style></a> <a
366-
name=text-decoration-skip></a> <a name=text-underline-position></a> <a
367-
name=emphasis-marks></a> <a name=text-emphasis-style></a> <a
368-
name=text-emphasis-color></a> <a name=text-emphasis></a> <a
369-
name=text-emphasis-position></a> <a name=text-shadow></a> Text decoration
370-
has moved to CSS Text Decoration Module Level 3 <a href="#CSS3-TEXT-DECOR"
371-
rel=biblioentry>[CSS3-TEXT-DECOR]<!--{{CSS3-TEXT-DECOR}}--></a>.
372-
373402
<h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
374403

375-
<p>This module replaces and extends the text-level features defined in <a
376-
href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> chapter 16.
404+
<p>This module, together with <a href="#CSS3-TEXT-DECOR"
405+
rel=biblioentry>[CSS3-TEXT-DECOR]<!--{{CSS3-TEXT-DECOR}}--></a>, replaces
406+
and extends the text-level features defined in <a href="#CSS21"
407+
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> chapter 16.
377408

378409
<h3 id=values><span class=secno>1.2. </span> Values</h3>
379410

@@ -407,7 +438,7 @@ <h3 id=terms><span class=secno>1.3. </span> Terminology</h3>
407438
allowed by Unicode. Within this specification, the ambiguous term <dfn
408439
id=character>character</dfn> is used as a friendlier synonym for <a
409440
href="#grapheme-cluster0"><i>grapheme cluster</i></a>. See <a
410-
href="http://dev.w3.org/csswg/css3-writing-modes/#character-properties">Characters
441+
href="http://www.w3.org/TR/css3-writing-modes/#character-properties">Characters
411442
and Properties</a> for how to determine the Unicode properties of a
412443
character.
413444

@@ -446,7 +477,7 @@ <h3 id=terms><span class=secno>1.3. </span> Terminology</h3>
446477
<h2 id=transforming><span class=secno>2. </span> Transforming Text</h2>
447478

448479
<h3 id=text-transform><span class=secno>2.1. </span> <a name=caps-prop></a>
449-
Transforming Text: the ‘<a href="#text-transform0"><code
480+
Case Transforms: the ‘<a href="#text-transform0"><code
450481
class=property>text-transform</code></a>’ property</h3>
451482

452483
<table class=propdef>
@@ -1852,8 +1883,7 @@ <h3 id=text-align><span class=secno>7.1. </span> Text Alignment: the ‘<a
18521883
and may instead treat the text as having no <a
18531884
href="#expansion-opportunity"><i>expansion opportunities</i></a>. If the
18541885
UA chooses to adjust the text, then it must ensure that tab stops continue
1855-
to line up as required by the <a
1856-
href="http://dev.w3.org/csswg/css3-text/#white-space-rules">white space
1886+
to line up as required by the <a href="#white-space-rules">white space
18571887
processing rules</a>.
18581888

18591889
<p>If (after justification, if any) the inline contents of a line box are

‎css-text/Overview.src.html

+38-16
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ <h2 class="no-num no-toc" id="status">Status of This Document</h2>
131131
<li>the ''start end'' value of 'text-align'
132132
<li>the 'text-justify' property
133133
<li>the percentage values of 'word-spacing'
134-
<li>minimum and maximum limits of 'word-spacing' and 'letter-spacing'
134+
<li>minimum and maximum limits of 'word-spacing'
135135
<li>the 'hanging-punctuation' property
136136
</ul>
137137

@@ -143,14 +143,23 @@ <h2 class="no-num no-toc" id="contents">
143143
<h2 id="intro">
144144
Introduction</h2>
145145

146-
<p>[document here]</p>
146+
<p>This module describes the typesetting controls of CSS;
147+
that is, the features of CSS that control the translation of
148+
source text to formatted, line-wrapped text.
149+
Various CSS properties provide control over
150+
<a href="#transforming">case transformation</a>,
151+
<a href="#white-space">white space collapsing</a>,
152+
<a href="#white-space">text wrapping</a>,
153+
<a href="#line-breaking">line breaking rules</a>
154+
and <a href="#hyphenation">hyphenation</a>,
155+
<a href="#justification">alignment and justification</a>,
156+
<a href="#spacing">spacing</a>,
157+
and <a href="#edge-effects">indentation</a>.
147158

148-
<p class="issue">This draft describes features that are specific to certain scripts.
149-
There is an ongoing discussion about where these features belong: in
150-
existing CSS properties, in new CSS properties, or perhaps in other
151-
specifications.
159+
<div class="note">
160+
<p>Font selection is covered in <a href="http://www.w3.org/TR/css3-fonts/">CSS Fonts Level 3</a> [[CSS3-FONTS]].
152161

153-
<p class="note">
162+
<p>
154163
<a name="decoration"></a>
155164
<a name="text-decoration"></a>
156165
<a name="line-decoration"></a>
@@ -165,16 +174,30 @@ <h2 id="intro">
165174
<a name="text-emphasis"></a>
166175
<a name="text-emphasis-position"></a>
167176
<a name="text-shadow"></a>
168-
Text decoration has moved to
169-
CSS Text Decoration Module Level 3
170-
[[CSS3-TEXT-DECOR]].
177+
Features for decorating text,
178+
such as <a href="http://www.w3.org/TR/css-text-decor-3/#line-decoration">underlines</a>,
179+
<a href="http://www.w3.org/TR/css-text-decor-3/#emphasis-marks">emphasis marks</a>,
180+
and <a href="http://www.w3.org/TR/css-text-decor-3/#text-shadow-property">shadows</a>,
181+
(previously part of this module)
182+
are covered in
183+
<a href="http://www.w3.org/TR/css-text-decor-3/">CSS Text Decoration Level 3</a> [[CSS3-TEXT-DECOR]].
184+
185+
<p><a href="http://www.w3.org/TR/css3-writing-modes/#text-direction">Bidirectional</a> and
186+
<a href="http://www.w3.org/TR/css3-writing-modes/#vertical-intro">vertical</a> text
187+
are addressed in
188+
<a href="http://www.w3.org/TR/css3-writing-modes/">CSS Writing Modes Level 3</a> [[CSS3-WRITING-MODES]].
189+
</div>
171190

191+
<p class="issue">This draft describes features that are specific to certain scripts.
192+
There is an ongoing discussion about where these features belong: in
193+
existing CSS properties, in new CSS properties, or perhaps in other
194+
specifications.
172195

173196
<h3 id="placement">
174197
Module Interactions</h3>
175198

176-
<p>This module replaces and extends the text-level
177-
features defined in [[!CSS21]] chapter 16.
199+
<p>This module, together with [[CSS3-TEXT-DECOR]],
200+
replaces and extends the text-level features defined in [[!CSS21]] chapter 16.
178201

179202
<h3 id="values">
180203
Values</h3>
@@ -205,7 +228,7 @@ <h3 id="terms">
205228
tailor the definition as allowed by Unicode. Within this specification,
206229
the ambiguous term <dfn>character</dfn> is used as a friendlier synonym
207230
for <i>grapheme cluster</i>.
208-
See <a href="http://dev.w3.org/csswg/css3-writing-modes/#character-properties">Characters and Properties</a>
231+
See <a href="http://www.w3.org/TR/css3-writing-modes/#character-properties">Characters and Properties</a>
209232
for how to determine the Unicode properties of a character.
210233

211234
<p id="letter">A <dfn>letter</dfn> for the purpose of this specification
@@ -237,7 +260,7 @@ <h2 id="transforming">
237260

238261
<h3 id="text-transform">
239262
<a name="caps-prop"></a>
240-
Transforming Text: the 'text-transform' property</h3>
263+
Case Transforms: the 'text-transform' property</h3>
241264

242265
<table class="propdef">
243266
<tr>
@@ -1348,8 +1371,7 @@ <h3 id="text-align">
13481371
and may instead treat the text as having no <i>expansion opportunities</i>.
13491372
If the UA chooses to adjust the text, then it must ensure
13501373
that tab stops continue to line up as required by the
1351-
<a href="http://dev.w3.org/csswg/css3-text/#white-space-rules">white
1352-
space processing rules</a>.
1374+
<a href="#white-space-rules">white space processing rules</a>.
13531375

13541376
<p>If (after justification, if any) the inline contents of a line box are too long to fit within it,
13551377
then the contents are start-aligned:

‎css-writing-modes/Overview.src.html

+4-4
Original file line numberDiff line numberDiff line change
@@ -1955,7 +1955,7 @@ <h3 id="orthogonal-flows">
19551955

19561956
<p>
19571957
When an element has a writing mode that is perpendicular to its containing block
1958-
it is said to be in, or establish, an <dfn>orthogonal flow</dfn>.
1958+
it is said to be in, or establish, an <dfn title="establish an orthogonal flow | orthogonal flow">orthogonal flow</dfn>.
19591959

19601960
<p>
19611961
To handle this case, CSS layout calculations are divided into
@@ -1976,7 +1976,7 @@ <h3 id="orthogonal-flows">
19761976
</ul>
19771977

19781978
<p>Since ''auto'' margins are resolved consistent with the containing
1979-
block's writing mode, a box establishing an orthogonal flow can,
1979+
block's writing mode, a box establishing an <i>orthogonal flow</i> can,
19801980
once sized, be aligned or centered within its containing block just
19811981
like other block-level elements by using auto margins.
19821982

@@ -2012,8 +2012,8 @@ <h3 id="orthogonal-flows">
20122012
would otherwise be the extent of the containing block, is
20132013
infinite.
20142014

2015-
<p>Orthogonal flows allow the opposite to happen: for the
2016-
<i>available extent</i> to be defined, but the <i>available
2015+
<p>Putting a box in an <i>orthogonal flow</i> allows the opposite to happen:
2016+
for the <i>available extent</i> to be defined, but the <i>available
20172017
measure</i> to be indefinite. In such cases a percentage of the
20182018
containing block measure cannot be defined, and inline-axis
20192019
computations cannot be resolved. In these cases, the initial

0 commit comments

Comments
 (0)