- From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 16 Mar 2011 00:20:49 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-lists In directory hutz:/tmp/cvs-serv2463 Modified Files: Overview.html Overview.src.html Log Message: Switched examples back to <pre> and escaped markup, since <xmp> breaks our downstream postprocessing tools. Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-lists/Overview.html,v retrieving revision 1.13 retrieving revision 1.14 diff -u -d -r1.13 -r1.14 --- Overview.html 12 Mar 2011 13:01:41 -0000 1.13 +++ Overview.html 16 Mar 2011 00:20:46 -0000 1.14 @@ -31,13 +31,13 @@ <h1>CSS Lists and Counters Module Level 3</h1> - <h2 class="no-num no-toc" id=longstatus-date>W3C Working Draft 12 March + <h2 class="no-num no-toc" id=longstatus-date>W3C Working Draft 16 March 2011</h2> <dl> <dt>This version: - <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110312">http://www.w3.org/TR/2011/WD-css3-lists-20110312</a></dd> --> + <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110316">http://www.w3.org/TR/2011/WD-css3-lists-20110316</a></dd> --> <a href="http://dev.w3.org/csswg/css3-lists">http://dev.w3.org/csswg/css3-lists</a> @@ -53,14 +53,15 @@ <dt>Editor: - <dd><a href="http://www.xanthir.com/contact">Tab Atkins Jr.</a> + <dd><a href="http://www.xanthir.com/contact">Tab Atkins Jr.</a>, Google + Inc. <dt>Previous Editors:</dt> <!-- in the order tantek requested --> <dd>Ian Hickson, <a href="mailto:ian@hixie.ch">ian@hixie.ch</a> - <dd><span lang=tr>Tantek Çelı̇k</span>, Microsoft + <dd><span lang=tr>Tantek Çelı̇k</span>, Microsoft Corporation, <a href="mailto:tantekc@microsoft.com">tantekc@microsoft.com</a> @@ -1329,28 +1330,28 @@ <div class=example> <p>For example: - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Comparison of inside/outside position</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Comparison of inside/outside position</title> + <style> ul { list-style: outside; } ul.compact { list-style: inside; } - </style> - </head> - <body> - <ul> - <li>first list item comes first</li> - <li>second list item comes second</li> - </ul> - <ul class=compact> - <li>first list item comes first</li> - <li>second list item comes second</li> - </ul> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ul> + <li>first list item comes first</li> + <li>second list item comes second</li> + </ul> + <ul class=compact> + <li>first list item comes first</li> + <li>second list item comes second</li> + </ul> + </body> +</html> + </pre> <p>The above example may be formatted as:</p> @@ -1436,32 +1437,32 @@ <pre class=example> OL.alpha LI { list-style: lower-alpha } /* Any LI descendant of an OL */ OL.alpha > LI { list-style: lower-alpha } /* Any LI child of an OL */ -</pre> + </pre> <p>Authors who use only the descendant selector may not achieve the results they expect. Consider the following rules: - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>WARNING: Unexpected results due to cascade</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>WARNING: Unexpected results due to cascade</title> + <style> ol.alpha li { list-style: lower-alpha; } ul li { list-style: disc; } - </style> - </head> - <body> - <ol class=alpha> - <li>level 1 - <ul> - <li>level 2</li> - </ul> - </li> - </ol> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ol class=alpha> + <li>level 1 + <ul> + <li>level 2</li> + </ul> + </li> + </ol> + </body> +</html> + </pre> <p>The desired rendering would have level 1 list items with ‘<code class=property>lower-alpha</code>’ labels and level 2 items with @@ -1554,12 +1555,12 @@ <p>In the following example, the content is centered within a marker box of a fixed width. This document:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Content alignment in the marker box</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Content alignment in the marker box</title> + <style> LI::marker { content: "(" counter(counter) ")"; width: 6em; @@ -1569,17 +1570,17 @@ display: list-item; counter-increment: counter; } - </style> - </head> - <body> - <ol> - <li>This is the first item.</li> - <li>This is the second item.</li> - <li>This is the third item.</li> - </ol> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ol> + <li>This is the first item.</li> + <li>This is the second item.</li> + <li>This is the third item.</li> + </ol> + </body> +</html> + </pre> <p>should render something like this:</p> @@ -1590,7 +1591,7 @@ second item. (3) This is the third item. -</pre> + </pre> </div> <p>The next example uses markers to number notes (paragraphs). @@ -1598,12 +1599,12 @@ <div class=html-example> <p>The following document:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Markers to create numbered notes</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Markers to create numbered notes</title> + <style> P { margin-left: 12 em; } P.Note::marker { content: url("note.gif") "Note " counter(note-counter) ":"; @@ -1614,15 +1615,15 @@ display: list-item; counter-increment: note-counter; } - </style> - </head> - <body> - <p>This is the first paragraph in this document.</p> - <p class="Note">This is a very short document.</p> - <p>This is the end.</p> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <p>This is the first paragraph in this document.</p> + <p class="Note">This is a very short document.</p> + <p>This is the end.</p> + </body> +</html> + </pre> <p>should render something like this:</p> @@ -1641,28 +1642,28 @@ <p>The following example illustrates how markers may be offset from their element. This HTML application and style sheet:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Marker example</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Marker example</title> + <style> P { margin-left: 8em } /* Make space for counters */ LI::marker { margin: 0 3em 0 0; content: counter(list-item, lower-roman) "."; } LI { display: list-item } - </style> - </head> - <body> - <p>This is a long preceding paragraph ...</p> - <ol> - <li>This is the first item.</li> - <li>This is the second item.</li> - <li>This is the third item.</li> - </ol> - <p>This is a long following paragraph ...</p> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <p>This is a long preceding paragraph ...</p> + <ol> + <li>This is the first item.</li> + <li>This is the second item.</li> + <li>This is the third item.</li> + </ol> + <p>This is a long following paragraph ...</p> + </body> +</html> + </pre> <p>should render something like this:</p> @@ -1710,8 +1711,8 @@ <p>The ‘<code class=css>@counter-style</code>’ rule is defined as: - <pre class=prod><![CDATA[ -@counter-style <counter-style-name> { + <pre class=prod> +@counter-style <counter-style-name> { type: range: glyphs: @@ -1721,7 +1722,7 @@ suffix: fallback: } -]]></pre> + </pre> <p class=issue>Copy the way other specs define new @-rules that contain decl blocks, like @font-face. @@ -1768,9 +1769,9 @@ glyphs as digits and build their representation accordingly. It is defined as: - <pre class=prod><![CDATA[ -<counter-type> = repeating | numeric | alphabetic | symbolic | [ non-repeating <integer>? ] | cjk | additive -]]></pre> + <pre class=prod> +<counter-type> = repeating | numeric | alphabetic | symbolic | [ non-repeating <integer>? ] | cjk | additive + </pre> <dl> <dt><dfn id=repeating>repeating</dfn> @@ -1806,12 +1807,12 @@ <p>A ‘<code class=css>triangle bullet</code>’ list style can be defined with code like:</p> - <pre><![CDATA[ + <pre> @counter-style triangle { type: repeating; glyphs: "▶"; } -]]></pre> + </pre> <p>It will then produce lists that look like:</p> @@ -1819,7 +1820,7 @@ ▶ First item ▶ Second item ▶ Third item -</pre> + </pre> </div> <dt><dfn id=numeric>numeric</dfn> @@ -2059,9 +2060,9 @@ instead drops down to its fallback counter style. The property is defined as: - <pre class=prod><![CDATA[ -<counter-range> = [<integer> | infinite]{2} -]]></pre> + <pre class=prod> +<counter-range> = [<integer> | infinite]{2} + </pre> <p>The first value represents the lower bound of the range (with ‘<code class=property>infinite</code>’ representing negative @@ -2089,9 +2090,9 @@ the counter style types to construct their representations. It is defined as: - <pre class=prod><![CDATA[ -<counter-glyphs> = [ <string> | <image> ]+ -]]></pre> + <pre class=prod> +<counter-glyphs> = [ <string> | <image> ]+ + </pre> <p>Some counter style types specify that the ‘<code class=property>glyphs</code>’ property must have at least two @@ -2117,9 +2118,9 @@ when constructing the default contents of the ::marker pseudo-element. It is defined as: - <pre class=prod><![CDATA[ -<counter-prefix> = <string> -]]></pre> + <pre class=prod> +<counter-prefix> = <string> + </pre> <p>If the ‘<code class=property>prefix</code>’ property is omitted or invalid, its initial value is "" (the empty string). @@ -2132,9 +2133,9 @@ constructing the default contents of the ::marker pseudo-element. It is defined as: - <pre class=prod><![CDATA[ -<counter-suffix> = <string> -]]></pre> + <pre class=prod> +<counter-suffix> = <string> + </pre> <p>If the ‘<code class=property>suffix</code>’ property is omitted or invalid, its initial value is "." U+002E FULL STOP. @@ -2148,9 +2149,9 @@ value is outside the range for the counter style), the representation is instead generated by the fallback counter style. It is defined as: - <pre class=prod><![CDATA[ -<counter-style-fallback> = <counter-style-name> -]]></pre> + <pre class=prod> +<counter-style-fallback> = <counter-style-name> + </pre> <p>If the ‘<code class=property>fallback</code>’ property is omitted, invalid, or refers to a non-existent counter style, its initial Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v retrieving revision 1.29 retrieving revision 1.30 diff -u -d -r1.29 -r1.30 --- Overview.src.html 12 Mar 2011 13:00:22 -0000 1.29 +++ Overview.src.html 16 Mar 2011 00:20:46 -0000 1.30 @@ -37,11 +37,11 @@ <dd><a href="http://www.w3.org/TR/2002/WD-css3-lists-20021107">http://www.w3.org/TR/2002/WD-css3-lists-20021107</a></dd> <dt>Editor:</dt> - <dd><a href="http://www.xanthir.com/contact">Tab Atkins Jr.</a></dd> + <dd><a href="http://www.xanthir.com/contact">Tab Atkins Jr.</a>, Google Inc.</dd> <dt>Previous Editors:</dt> <!-- in the order tantek requested --> <dd>Ian Hickson, <a href="mailto:ian@hixie.ch">ian@hixie.ch</a></dd> - <dd><span lang="tr">Tantek Çelı̇k</span>, Microsoft Corporation, + <dd><span lang="tr">Tantek Çelı̇k</span>, Microsoft Corporation, <a href="mailto:tantekc@microsoft.com">tantekc@microsoft.com</a></dd> <dt>Contributors:</dt> <!-- in order of volume of input --> @@ -223,7 +223,7 @@ <!-- ====================================================================== --> -<h2 id=predefined-counters> +<h2 id='predefined-counters'> Predefined Counter Styles</h2> <p>While authors may define their own counter styles using the ''@counter-style'' @@ -236,7 +236,7 @@ -<h3 id=decimal-counters> +<h3 id='decimal-counters'> The ''decimal'' counter style</h3> <p>The ''decimal'' counter style is the default fallback counter style for the @@ -249,7 +249,7 @@ -<h3 id=glyph-counters> +<h3 id='glyph-counters'> Glyphs</h3> <p>CSS 2.1 defined three single-glyph counter styles (''circle'', ''disc'', and @@ -280,7 +280,7 @@ -<h3 id=complex-counters> +<h3 id='complex-counters'> Complex counter styles</h3> <p>Some real-life counter styles are unfortunately too complex to be accurately @@ -669,7 +669,7 @@ <!-- ====================================================================== --> -<h2 id=list-style-image-property> +<h2 id='list-style-image-property'> List Content: The 'list-style-image' property</h2> <table class="propdef"> @@ -711,7 +711,7 @@ <!-- ====================================================================== --> -<h2 id=content-property> +<h2 id='content-property'> List Content: Generating the computed value of the 'content' property</h2> <p>If a ''::marker'' pseudo-element has its 'content' property set to ''normal'', the @@ -751,7 +751,7 @@ <!-- ====================================================================== --> -<h2 id=list-style-position-property> +<h2 id='list-style-position-property'> Marker Position: The 'list-style-position' property</h2> <table class="propdef"> @@ -845,28 +845,28 @@ <div class=example> <p>For example: - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Comparison of inside/outside position</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Comparison of inside/outside position</title> + <style> ul { list-style: outside; } ul.compact { list-style: inside; } - </style> - </head> - <body> - <ul> - <li>first list item comes first</li> - <li>second list item comes second</li> - </ul> - <ul class=compact> - <li>first list item comes first</li> - <li>second list item comes second</li> - </ul> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ul> + <li>first list item comes first</li> + <li>second list item comes second</li> + </ul> + <ul class=compact> + <li>first list item comes first</li> + <li>second list item comes second</li> + </ul> + </body> +</html> + </pre> <p>The above example may be formatted as:</p> @@ -879,7 +879,7 @@ <!-- ====================================================================== --> -<h2 id=list-style-property> +<h2 id='list-style-property'> The 'list-style' shorthand property</h2> <table class="propdef"> @@ -923,32 +923,32 @@ <pre class="example"> OL.alpha LI { list-style: lower-alpha } /* Any LI descendant of an OL */ OL.alpha > LI { list-style: lower-alpha } /* Any LI child of an OL */ -</pre> + </pre> <p>Authors who use only the descendant selector may not achieve the results they expect. Consider the following rules:</p> - <pre class="html-example"><![CDATA[ -<!doctype html> -<html> - <head> - <title>WARNING: Unexpected results due to cascade</title> - <style> + <pre class="html-example"> +<!doctype html> +<html> + <head> + <title>WARNING: Unexpected results due to cascade</title> + <style> ol.alpha li { list-style: lower-alpha; } ul li { list-style: disc; } - </style> - </head> - <body> - <ol class=alpha> - <li>level 1 - <ul> - <li>level 2</li> - </ul> - </li> - </ol> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ol class=alpha> + <li>level 1 + <ul> + <li>level 2</li> + </ul> + </li> + </ol> + </body> +</html> + </pre> <p>The desired rendering would have level 1 list items with 'lower-alpha' labels and level 2 items with 'disc' labels. However, the cascading order will cause the first style rule (which includes @@ -993,7 +993,7 @@ <!-- ====================================================================== --> -<h2 id=marker-pseudoelement> +<h2 id='marker-pseudoelement'> Markers: The ''::marker'' pseudo-element</h2> <p>Markers are created by setting an element's 'display' property to @@ -1013,12 +1013,12 @@ <p>In the following example, the content is centered within a marker box of a fixed width. This document:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Content alignment in the marker box</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Content alignment in the marker box</title> + <style> LI::marker { content: "(" counter(counter) ")"; width: 6em; @@ -1028,17 +1028,17 @@ display: list-item; counter-increment: counter; } - </style> - </head> - <body> - <ol> - <li>This is the first item.</li> - <li>This is the second item.</li> - <li>This is the third item.</li> - </ol> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <ol> + <li>This is the first item.</li> + <li>This is the second item.</li> + <li>This is the third item.</li> + </ol> + </body> +</html> + </pre> <p>should render something like this: </p> @@ -1049,7 +1049,7 @@ second item. (3) This is the third item. -</pre> + </pre> </div> @@ -1058,12 +1058,12 @@ <div class="html-example"> <p>The following document:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Markers to create numbered notes</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Markers to create numbered notes</title> + <style> P { margin-left: 12 em; } P.Note::marker { content: url("note.gif") "Note " counter(note-counter) ":"; @@ -1074,15 +1074,15 @@ display: list-item; counter-increment: note-counter; } - </style> - </head> - <body> - <p>This is the first paragraph in this document.</p> - <p class="Note">This is a very short document.</p> - <p>This is the end.</p> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <p>This is the first paragraph in this document.</p> + <p class="Note">This is a very short document.</p> + <p>This is the end.</p> + </body> +</html> + </pre> <p>should render something like this:</p> @@ -1101,28 +1101,28 @@ <p>The following example illustrates how markers may be offset from their element. This HTML application and style sheet:</p> - <pre class=html-example><![CDATA[ -<!doctype html> -<html> - <head> - <title>Marker example</title> - <style> + <pre class=html-example> +<!doctype html> +<html> + <head> + <title>Marker example</title> + <style> P { margin-left: 8em } /* Make space for counters */ LI::marker { margin: 0 3em 0 0; content: counter(list-item, lower-roman) "."; } LI { display: list-item } - </style> - </head> - <body> - <p>This is a long preceding paragraph ...</p> - <ol> - <li>This is the first item.</li> - <li>This is the second item.</li> - <li>This is the third item.</li> - </ol> - <p>This is a long following paragraph ...</p> - </body> -</html> -]]></pre> + </style> + </head> + <body> + <p>This is a long preceding paragraph ...</p> + <ol> + <li>This is the first item.</li> + <li>This is the second item.</li> + <li>This is the third item.</li> + </ol> + <p>This is a long following paragraph ...</p> + </body> +</html> + </pre> <p>should render something like this: </p> @@ -1143,7 +1143,7 @@ <!-- ====================================================================== --> -<h2 id=counter-style> +<h2 id='counter-style'> Defining Custom Counter Styles: the ''@counter-style'' rule</h2> <p>CSS 2.1 defined a handful of useful counter styles based on the styles that @@ -1160,13 +1160,13 @@ 'list-style-type' property or in the ''counter()'' and ''counters()'' functions, exactly like the predefined counter styles in CSS.</p> -<h3 id=counter-style-syntax> +<h3 id='counter-style-syntax'> @counter-style Syntax</h3> <p>The ''@counter-style'' rule is defined as:</p> - <pre class=prod><![CDATA[ -@counter-style <counter-style-name> { + <pre class=prod> +@counter-style <counter-style-name> { type: range: glyphs: @@ -1176,7 +1176,7 @@ suffix: fallback: } -]]></pre> + </pre> <p class=issue>Copy the way other specs define new @-rules that contain decl blocks, like @font-face.</p> @@ -1202,7 +1202,7 @@ <p>The meaning and values of each of the properties are defined in the following section.</p> -<h4 id=counter-style-type> +<h4 id='counter-style-type'> The 'type' Property</h4> <p>The 'type' property specifies which algorithm will be used to construct @@ -1211,9 +1211,9 @@ type counter styles interpret their glyphs as digits and build their representation accordingly. It is defined as: - <pre class=prod><![CDATA[ -<counter-type> = repeating | numeric | alphabetic | symbolic | [ non-repeating <integer>? ] | cjk | additive -]]></pre> + <pre class=prod> +<counter-type> = repeating | numeric | alphabetic | symbolic | [ non-repeating <integer>? ] | cjk | additive + </pre> <dl> <dt><dfn>repeating</dfn></dt> @@ -1242,12 +1242,12 @@ <div class=example> <p>A 'triangle bullet' list style can be defined with code like:</p> - <pre><![CDATA[ + <pre> @counter-style triangle { type: repeating; glyphs: "▶"; } -]]></pre> + </pre> <p>It will then produce lists that look like:</p> @@ -1255,7 +1255,7 @@ ▶ First item ▶ Second item ▶ Third item -</pre> + </pre> </div> </dd> @@ -1457,7 +1457,7 @@ </dd> </dl> -<h3 id=counter-style-range> +<h3 id='counter-style-range'> The 'range' property</h3> <p>The 'range' property defines the range over which the counter style is defined. @@ -1465,9 +1465,9 @@ the counter style instead drops down to its fallback counter style. The property is defined as:</p> - <pre class=prod><![CDATA[ -<counter-range> = [<integer> | infinite]{2} -]]></pre> + <pre class=prod> +<counter-range> = [<integer> | infinite]{2} + </pre> <p>The first value represents the lower bound of the range (with 'infinite' representing negative infinity), and the second value represents the upper bound @@ -1483,16 +1483,16 @@ It is not an error to specify a 'range' value larger than the implicit range; the part of the range outside the implicit range simply has no effect.</p> -<h3 id=counter-style-glyphs> +<h3 id='counter-style-glyphs'> The 'glyphs' property</h3> <p>The 'glyphs' property specifies the <i>counter glyph</i>s used by several of the counter style types to construct their representations. It is defined as:</p> - <pre class=prod><![CDATA[ -<counter-glyphs> = [ <string> | <image> ]+ -]]></pre> + <pre class=prod> +<counter-glyphs> = [ <string> | <image> ]+ + </pre> <p>Some counter style types specify that the 'glyphs' property must have at least two entries. If the counter style's type is set to such a type, it is @@ -1506,35 +1506,35 @@ <p class=issue>Add example of image glyphs.</p> </div> -<h3 id=counter-style-prefix> +<h3 id='counter-style-prefix'> The 'prefix' property</h3> <p>The 'prefix' property specifies a string that is placed before the representation of the counter value when constructing the default contents of the ::marker pseudo-element. It is defined as:</p> - <pre class=prod><![CDATA[ -<counter-prefix> = <string> -]]></pre> + <pre class=prod> +<counter-prefix> = <string> + </pre> <p>If the 'prefix' property is omitted or invalid, its initial value is "" (the empty string).</p> -<h3 id=counter-style-suffix> +<h3 id='counter-style-suffix'> The 'suffix' property</h3> <p>The 'suffix' property specifies a string that is placed after the representation of the counter value when constructing the default contents of the ::marker pseudo-element. It is defined as:</p> - <pre class=prod><![CDATA[ -<counter-suffix> = <string> -]]></pre> + <pre class=prod> +<counter-suffix> = <string> + </pre> <p>If the 'suffix' property is omitted or invalid, its initial value is "." U+002E FULL STOP.</p> -<h3 id=counter-style-fallback> +<h3 id='counter-style-fallback'> The 'fallback' property</h3> <p>The 'fallback' property specifies a fallback counter style. When the @@ -1543,9 +1543,9 @@ representation is instead generated by the fallback counter style. It is defined as:</p> - <pre class=prod><![CDATA[ -<counter-style-fallback> = <counter-style-name> -]]></pre> + <pre class=prod> +<counter-style-fallback> = <counter-style-name> + </pre> <p>If the 'fallback' property is omitted, invalid, or refers to a non-existent counter style, its initial value is 'decimal' (which is guaranteed to be defined).</p> @@ -1631,7 +1631,7 @@ <!-- ====================================================================== --> -<h2 id=ua-stylesheet> +<h2 id='ua-stylesheet'> Appendix A: Required Predefined Counter Styles</h2> <p>While this specification defines a mechanism to allow authors to define
Received on Wednesday, 16 March 2011 00:20:53 UTC