Skip to content

Commit beba04a

Browse files
fantasaifantasai
committed
Change styling of replacement text
1 parent 04f5119 commit beba04a

2 files changed

Lines changed: 171 additions & 124 deletions

File tree

‎css-module/Overview.html‎

Lines changed: 103 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -10,27 +10,51 @@
1010
<link href="http://www.w3.org/StyleSheets/TR/W3C-ED.css" rel=stylesheet
1111
type="text/css">
1212

13+
<style type="text/css">
14+
/* delete this block when you've cleared out all the .replaceme elements */
15+
.replaceme {
16+
border: solid red;
17+
padding: 0 0.5em;
18+
margin: 0 0.1em;
19+
background: yellow;
20+
color: green;
21+
}
22+
.replaceme:before {
23+
content: "FIXME(";
24+
color: black;
25+
}
26+
.replaceme:after {
27+
content: ")";
28+
color: black;
29+
}
30+
</style>
31+
1332
<body>
1433
<div class=head> <!--begin-logo-->
1534
<p><a href="http://www.w3.org/"><img alt=W3C height=48
1635
src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo-->
1736

18-
<h1>CSS <var class=issue>TEMPLATE</var> Module Level <var
19-
class=issue>N</var></h1>
37+
<h1>CSS <var class=replaceme>TEMPLATE</var> Module Level <var
38+
class=replaceme>N</var></h1>
2039

21-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 June 2011</h2>
40+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 2 July 2011</h2>
2241

2342
<dl>
2443
<dt>This version:
2544

26-
<dd><a href="http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110620/">
27-
http://www.w3.org/TR/2011/ED-css3-TEMPLATE-20110620</a>
45+
<dd><a href="http://www.w3.org/TR/2011/ED-FIXME-20110702/">
46+
http://www.w3.org/TR/2011/ED-FIXME-20110702</a>
2847

2948
<dt>Latest version:
3049

31-
<dd><a href="http://www.w3.org/TR/css3-TEMPLATE">
32-
http://www.w3.org/TR/css<var class=issue>3</var>-<var
33-
class=issue>TEMPLATE</var></a>
50+
<dd><a href="http://www.w3.org/TR/FIXME"> http://www.w3.org/TR/css<var
51+
class=replaceme>N</var>-<var class=replaceme>TEMPLATE</var></a>
52+
53+
<dt>Editor's draft:
54+
55+
<dd><a
56+
href="http://dev.w3.org/csswg/FIXME">http://dev.w3.org/csswg/css<var
57+
class=replaceme>N</var>-<var class=replaceme>TEMPLATE</var></a>
3458

3559
<dt>Previous version:
3660

@@ -73,12 +97,12 @@ <h2 class="no-num no-toc" id=abstract>Abstract</h2>
7397
<p>CSS is a language for describing the rendering of structured documents
7498
(such as HTML and XML) on screen, on paper, in speech, etc. This module
7599
contains the features of CSS level&nbsp;3 relating to <var
76-
class=issue>DESCRIBE HERE</var>. It includes and extends the functionality
77-
of CSS level&nbsp;2 <a href="#CSS21"
100+
class=replaceme>DESCRIBE HERE</var>. It includes and extends the
101+
functionality of CSS level&nbsp;2 <a href="#CSS21"
78102
rel=biblioentry>[CSS21]<!--{{CSS21}}--></a>, which builds on CSS
79103
level&nbsp;1 <a href="#CSS1" rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>.
80104
The main extensions compared to level&nbsp;2 are <var
81-
class=issue>SUMMARIZE HERE</var>.
105+
class=replaceme>SUMMARIZE HERE</var>.
82106

83107
<h2 class="no-num no-toc" id=status>Status of this document</h2>
84108
<!--begin-status-->
@@ -91,12 +115,12 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
91115
<p>The (<a
92116
href="http://lists.w3.org/Archives/Public/www-style/">archived</a>) public
93117
mailing list <a
94-
href="mailto:www-style@w3.org?Subject=%5Bcss3-TEMPLATE%5D%20PUT%20SUBJECT%20HERE">
118+
href="mailto:www-style@w3.org?Subject=%5BFIXME%5D%20PUT%20SUBJECT%20HERE">
95119
www-style@w3.org</a> (see <a
96120
href="http://www.w3.org/Mail/Request">instructions</a>) is preferred for
97121
discussion of this specification. When sending e-mail, please put the text
98-
&#8220;css3-TEMPLATE&#8221; in the subject, preferably like this:
99-
&#8220;[<!---->css3-TEMPLATE<!---->] <em>&hellip;summary of
122+
&#8220;FIXME&#8221; in the subject, preferably like this:
123+
&#8220;[<!---->FIXME<!---->] <em>&hellip;summary of
100124
comment&hellip;</em>&#8221;
101125

102126
<p>This document was produced by the <a href="/Style/CSS/members">CSS
@@ -126,10 +150,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
126150
<li><a href="#placement"><span class=secno>1.1. </span> Module
127151
Interactions</a>
128152

129-
<li><a href="#conventions"><span class=secno>1.2. </span> Document
130-
Conventions</a>
131-
132-
<li><a href="#values"><span class=secno>1.3. </span> Values</a>
153+
<li><a href="#values"><span class=secno>1.2. </span> Values</a>
133154
</ul>
134155

135156
<li><a href="#sample-topic"><span class=secno>2. </span> Sample
@@ -142,19 +163,22 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
142163

143164
<li><a href="#conformance"><span class=secno>3. </span> Conformance</a>
144165
<ul class=toc>
145-
<li><a href="#conformance-classes"><span class=secno>3.1. </span>
166+
<li><a href="#conventions"><span class=secno>3.1. </span> Document
167+
Conventions</a>
168+
169+
<li><a href="#conformance-classes"><span class=secno>3.2. </span>
146170
Conformance Classes</a>
147171

148-
<li><a href="#partial"><span class=secno>3.2. </span> Partial
172+
<li><a href="#partial"><span class=secno>3.3. </span> Partial
149173
Implementations</a>
150174

151-
<li><a href="#experimental"><span class=secno>3.3. </span> Experimental
175+
<li><a href="#experimental"><span class=secno>3.4. </span> Experimental
152176
Implementations</a>
153177

154-
<li><a href="#testing"><span class=secno>3.4. </span>Non-Experimental
178+
<li><a href="#testing"><span class=secno>3.5. </span>Non-Experimental
155179
Implementations</a>
156180

157-
<li><a href="#cr-exit-criteria"><span class=secno>3.5. </span> CR Exit
181+
<li><a href="#cr-exit-criteria"><span class=secno>3.6. </span> CR Exit
158182
Criteria</a>
159183
</ul>
160184

@@ -178,46 +202,19 @@ <h2 id=intro><span class=secno>1. </span> Introduction</h2>
178202

179203
<p><em>This section is not normative.</em>
180204

181-
<p><var class=issue>Provide background, motivation, etc.</var>
205+
<p><var class=replaceme>Provide background, motivation, etc.</var>
182206

183207
<h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
184208

185-
<p class=issue>Explain, normatively, how this module affects the definition
186-
of CSS.
209+
<p class=replaceme>Explain, normatively, how this module affects the
210+
definition of CSS.
187211

188-
<p>This module replaces and extends the <var class=issue>SUMMARIZE
212+
<p>This module replaces and extends the <var class=replaceme>SUMMARIZE
189213
HERE</var> features defined in <a href="#CSS21"
190-
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var class=issue>W.X
191-
and Y.Z</var>.
192-
193-
<h3 id=conventions><span class=secno>1.2. </span> Document Conventions</h3>
194-
195-
<p>Conformance requirements are expressed with a combination of descriptive
196-
assertions and RFC 2119 terminology. The key words “MUST”, “MUST
197-
NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
198-
“SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the
199-
normative parts of this document are to be interpreted as described in RFC
200-
2119. However, for readability, these words do not appear in all uppercase
201-
letters in this specification.
202-
203-
<p>All of the text of this specification is normative except sections
204-
explicitly marked as non-normative, examples, and notes. <a
205-
href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a>
214+
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var
215+
class=replaceme>W.X and Y.Z</var>.
206216

207-
<p>Examples in this specification are introduced with the words “for
208-
example” or are set apart from the normative text with
209-
<code>class="example"</code>, like this:
210-
211-
<div class=example>
212-
<p>This is an example of an informative example.</p>
213-
</div>
214-
215-
<p>Informative notes begin with the word “Note” and are set apart from
216-
the normative text with <code>class="note"</code>, like this:
217-
218-
<p class=note>Note, this is an informative note.
219-
220-
<h3 id=values><span class=secno>1.3. </span> Values</h3>
217+
<h3 id=values><span class=secno>1.2. </span> Values</h3>
221218

222219
<p>This specification follows the <a
223220
href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property
@@ -381,11 +378,38 @@ <h3 id=the-display-model><span class=secno>2.1. </span> Inner Display
381378

382379
<h2 id=conformance><span class=secno>3. </span> Conformance</h2>
383380

384-
<h3 id=conformance-classes><span class=secno>3.1. </span> Conformance
381+
<h3 id=conventions><span class=secno>3.1. </span> Document Conventions</h3>
382+
383+
<p>Conformance requirements are expressed with a combination of descriptive
384+
assertions and RFC 2119 terminology. The key words “MUST”, “MUST
385+
NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
386+
“SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in the
387+
normative parts of this document are to be interpreted as described in RFC
388+
2119. However, for readability, these words do not appear in all uppercase
389+
letters in this specification.
390+
391+
<p>All of the text of this specification is normative except sections
392+
explicitly marked as non-normative, examples, and notes. <a
393+
href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a>
394+
395+
<p>Examples in this specification are introduced with the words “for
396+
example” or are set apart from the normative text with
397+
<code>class="example"</code>, like this:
398+
399+
<div class=example>
400+
<p>This is an example of an informative example.</p>
401+
</div>
402+
403+
<p>Informative notes begin with the word “Note” and are set apart from
404+
the normative text with <code>class="note"</code>, like this:
405+
406+
<p class=note>Note, this is an informative note.
407+
408+
<h3 id=conformance-classes><span class=secno>3.2. </span> Conformance
385409
Classes</h3>
386410

387-
<p>Conformance to <var class=issue>CSS TEMPLATE Module</var> is defined for
388-
three conformance classes:
411+
<p>Conformance to <var class=replaceme>CSS TEMPLATE Module</var> is defined
412+
for three conformance classes:
389413

390414
<dl>
391415
<dt><dfn id=style-sheet title="style sheet!!as conformance class">style
@@ -406,27 +430,28 @@ <h3 id=conformance-classes><span class=secno>3.1. </span> Conformance
406430
that writes a style sheet.
407431
</dl>
408432

409-
<p>A style sheet is conformant to <var class=issue>CSS TEMPLATE
433+
<p>A style sheet is conformant to <var class=replaceme>CSS TEMPLATE
410434
Module</var> if all of its declarations that use properties defined in
411435
this module have values that are valid according to the generic CSS
412436
grammar and the individual grammars of each property as given in this
413437
module.
414438

415-
<p>A renderer is conformant to <var class=issue>CSS TEMPLATE Module</var>
416-
if, in addition to interpreting the style sheet as defined by the
417-
appropriate specifications, it supports all the properties defined by <var
418-
class=issue>CSS TEMPLATE Module</var> by parsing them correctly and
419-
rendering the document accordingly. However, the inability of a UA to
439+
<p>A renderer is conformant to <var class=replaceme>CSS TEMPLATE
440+
Module</var> if, in addition to interpreting the style sheet as defined by
441+
the appropriate specifications, it supports all the features defined by
442+
<var class=replaceme>CSS TEMPLATE Module</var> by parsing them correctly
443+
and rendering the document accordingly. However, the inability of a UA to
420444
correctly render a document due to limitations of the device does not make
421445
the UA non-conformant. (For example, a UA is not required to render color
422446
on a monochrome monitor.)
423447

424-
<p>An authoring tool is conformant to <var class=issue>CSS TEMPLATE
425-
Module</var> if it writes syntactically correct style sheets, according to
426-
the generic CSS grammar and the individual grammars of each property in
427-
this module.
448+
<p>An authoring tool is conformant to <var class=replaceme>CSS TEMPLATE
449+
Module</var> if it writes style sheets that are syntactically correct
450+
according to the generic CSS grammar and the individual grammars of each
451+
feature in this module, and meet all other conformance requirements of
452+
style sheets as described in this module.
428453

429-
<h3 id=partial><span class=secno>3.2. </span> Partial Implementations</h3>
454+
<h3 id=partial><span class=secno>3.3. </span> Partial Implementations</h3>
430455

431456
<p>So that authors can exploit the forward-compatible parsing rules to
432457
assign fallback values, CSS renderers <strong>must</strong> treat as
@@ -440,7 +465,7 @@ <h3 id=partial><span class=secno>3.2. </span> Partial Implementations</h3>
440465
unsupported values must be), CSS requires that the entire declaration be
441466
ignored.
442467

443-
<h3 id=experimental><span class=secno>3.3. </span> Experimental
468+
<h3 id=experimental><span class=secno>3.4. </span> Experimental
444469
Implementations</h3>
445470

446471
<p>To avoid clashes with future CSS features, the CSS2.1 specification
@@ -454,7 +479,7 @@ <h3 id=experimental><span class=secno>3.3. </span> Experimental
454479
vendor-prefixed syntax for such features, including those in W3C Working
455480
Drafts. This avoids incompatibilities with future changes in the draft.
456481

457-
<h3 id=testing><span class=secno>3.4. </span>Non-Experimental
482+
<h3 id=testing><span class=secno>3.5. </span>Non-Experimental
458483
Implementations</h3>
459484

460485
<p>Once a specification reaches the Candidate Recommendation stage,
@@ -476,7 +501,7 @@ <h3 id=testing><span class=secno>3.4. </span>Non-Experimental
476501
href="http://lists.w3.org/Archives/Public/public-css-testsuite">public-css-testsuite@w3.org</a>
477502
mailing list.
478503

479-
<h3 id=cr-exit-criteria><span class=secno>3.5. </span> CR Exit Criteria</h3>
504+
<h3 id=cr-exit-criteria><span class=secno>3.6. </span> CR Exit Criteria</h3>
480505

481506
<p class=issue>[Change or remove the following CR exit criteria if the spec
482507
is not a module, but, e.g., a Note or a profile. This text was <a
@@ -531,7 +556,7 @@ <h3 id=cr-exit-criteria><span class=secno>3.5. </span> CR Exit Criteria</h3>
531556

532557
<h2 class=no-num id=acknowledgments>Acknowledgments</h2>
533558

534-
<p><var class=issue>[acknowledgments]</var>
559+
<p><var class=replaceme>[acknowledgments]</var>
535560

536561
<h2 class=no-num id=references>References</h2>
537562

@@ -627,7 +652,7 @@ <h2 class=no-num id=index>Index</h2>
627652

628653
<ul class=indexlist>
629654
<li>authoring tool, <a href="#authoring-tool" title="authoring
630-
tool"><strong>3.1.</strong></a>
655+
tool"><strong>3.2.</strong></a>
631656

632657
<li>Cross-references, <a href="#cross-references"
633658
title=Cross-references><strong>2.1.</strong></a>
@@ -642,7 +667,7 @@ <h2 class=no-num id=index>Index</h2>
642667

643668
<li>index, <a href="#index0" title=index><strong>2.</strong></a>
644669

645-
<li>renderer, <a href="#renderer" title=renderer><strong>3.1.</strong></a>
670+
<li>renderer, <a href="#renderer" title=renderer><strong>3.2.</strong></a>
646671

647672

648673
<li>resource
@@ -659,7 +684,7 @@ <h2 class=no-num id=index>Index</h2>
659684
<li>style sheet
660685
<ul>
661686
<li>as conformance class, <a href="#style-sheet" title="style sheet, as
662-
conformance class"><strong>3.1.</strong></a>
687+
conformance class"><strong>3.2.</strong></a>
663688
</ul>
664689

665690
<li>terms, <a href="#terms" title=terms>2.</a>

0 commit comments

Comments
 (0)