8000 [css-gcpm] remove leaders section as it is now in GenCon spec · w3c/csswg-drafts@3ab8d8f · GitHub
Skip to content

Commit 3ab8d8f

Browse files
dauwhedauwhe
committed
[css-gcpm] remove leaders section as it is now in GenCon spec
1 parent 7df460c commit 3ab8d8f

2 files changed

Lines changed: 8 additions & 209 deletions

File tree

‎css-gcpm/Overview.bs‎

Lines changed: 2 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -791,109 +791,13 @@ In this case, each chapter will form a separate page group. @page:nth(3 of body)
791791
</div>
792792

793793
<h2 id="leaders">
794-
Leaders
794+
Leaders (moved)
795795
</h2>
796-
A leader, sometimes known as a tab leader or a dot leader, is a repeating pattern used to visually connect content across horizontal spaces. They are most commonly used in tables of contents, between titles and page numbers. The ''leader()'' function, as a value for the content property, is used to create leaders in CSS. This function takes a string (the leader string), which describes the repeating pattern for the leader.
797796

798-
799-
<pre class="propdef partial">
800-
Name: content
801-
New Values: leader()
802-
Media: paged
803-
</pre>
804-
805-
<pre class="prod">
806-
<dfn>leader()</dfn> = leader( [dotted | solid | space] | <<string>>);
807-
</pre>
808-
809-
810-
Three keywords are shorthand values for common strings:
811-
<dl>
812-
<dt id="dotted-leader">dotted</dt>
813-
<dd>leader(". ")</dd>
814-
<dt id="solid-leader">solid</dt>
815-
<dd>leader("_")</dd>
816-
<dt id="space-leader">space</dt>
817-
<dd>leader(" ")</dd>
818-
<dt id="string-leader">&lt;string></dt>
819-
<dd></dd>
820-
</dl>
821-
<div class="example">
822-
<pre>
823-
824-
ol.toc a::after {
825-
content: leader('.') target-counter(attr(href), page);
826-
}
827-
828-
&lt;h1>Table of Contents&lt;/h1>
829-
&lt;ol class="toc">
830-
&lt;li>&lt;a href="#chapter1">Loomings&lt;/a>&lt;/li>
831-
&lt;li>&lt;a href="#chapter2">The Carpet-Bag&lt;/a>&lt;/li>
832-
&lt;li>&lt;a href="#chapter3">The Spouter-Inn&lt;/a>&lt;/li>
833-
&lt;/ol>
834-
835-
</pre> This might result in: <pre>
836-
Table of Contents
837-
838-
1. Loomings.....................1
839-
2. The Carpet-Bag...............9
840-
3. The Spouter-Inn.............13
841-
</pre>
842-
</div>
843-
<p class="issue">
844-
Do leaders depend on the assumption that the content after the leader is right-aligned (end-aligned)?
845-
</p>
846-
<h3 id="rendering-leaders">
847-
Rendering leaders
848-
</h3>
849-
Consider a line which contains the content before the leader (the “before content”), the leader, and the content after the leader (the “after content”). Leaders obey the following rules:
850-
<ol>
851-
<li>The leader string must appear in full at least once. </li>
852-
<li>The leader should be as long as possible</li>
853-
<li>Visible characters in leaders should vertically align with each other when possible.</li>
854-
<li>Line break characters in the leader string must be ignored.</li>
855-
<li>White space in the leader string follows normal CSS rules.</li>
856-
<li>A leader only appears between the start content and the end content.</li>
857-
<li>A leader only appears on a single line, even if the before content and after content are on different lines. </li>
858-
<li>A leader can’t be the only thing on a line. </li>
859-
</ol>
860-
<h4 id="procedure-leader">
861-
Procedure for rendering leaders
862-
</h4>
863-
<ol>
864-
<li> Lay out the before content, until reaching the line where the before content ends. <pre>
865-
BBBBBBBBBB
866-
BBB
867-
</pre> </li>
868-
<li> The leader string consists of one or more glyphs, and is thus an inline box. A leader is a row of these boxes, drawn from the end edge to the start edge, where only those boxes not overlaid by the before or after content. On this line, draw the leader string, starting from the end edge, repeating as many times as possible until reaching the start edge. <pre>
869-
BBBBBBBBBB
870-
..........
871-
</pre> </li>
872-
<li> Draw the before and after content on top of the leader. If any part of the before or after content overlaps a glyph in a leader string box, that glyph is not displayed.<pre>
873-
BBBBBBBBBB
874-
BBB....AAA
875-
</pre> </li>
876-
<li> If one full copy of the leader string is not visible: <pre>
877-
BBBBBBB
878-
BBBBBBA
879-
</pre> Insert a line break before the after content, draw the leader on the next line, and draw the end content on top <pre>
880-
BBBBBBB
881-
BBBBBB
882-
......A
883-
</pre> </li>
884-
</ol>
885-
886-
<figure>
887-
<img src="images/leader.001.jpg" width="480" alt="drawing leaders"/>
888-
<figcaption>Procedure for drawing leaders</figcaption>
889-
</figure>
797+
Issue: Now described in [[CSS3-CONTENT]]
890798

891799

892800

893-
<figure>
894-
<img src="images/leader.002.jpg" width="480" alt="drawing leaders"/>
895-
<figcaption>Procedure for drawing leaders when the content doesn’t fit on a single line</figcaption>
896-
</figure>
897801
<h2 id="cross-references">
898802
Cross-references
899803
</h2>

‎css-gcpm/Overview.html‎

Lines changed: 6 additions & 111 deletions
Original file line numberDiff line numberDiff line change
@@ -163,15 +163,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="contents"><span class="cont
163163
<li><a href="#document-page-selectors"><span class="secno">3.1</span> <span class="content"> Page Selectors </span></a>
164164
<li><a href="#document-sequence-selectors"><span class="secno">3.2</span> <span class="content"> Page groups </span></a>
165165
</ul>
166-
<li>
167-
<a href="#leaders"><span class="secno">4</span> <span class="content"> Leaders </span></a>
168-
<ul class="toc">
169-
<li>
170-
<a href="#rendering-leaders"><span class="secno">4.1</span> <span class="content"> Rendering leaders </span></a>
171-
<ul class="toc">
172-
<li><a href="#procedure-leader"><span class="secno">4.1.1</span> <span class="content"> Procedure for rendering leaders </span></a>
173-
</ul>
174-
</ul>
166+
<li><a href="#leaders"><span class="secno">4</span> <span class="content"> Leaders (moved) </span></a>
175167
<li>
176168
<a href="#cross-references"><span class="secno">5</span> <span class="content"> Cross-references </span></a>
177169
<ul class="toc">
@@ -765,104 +757,8 @@ <h3 class="heading settled" data-level="3.2" id="document-sequence-selectors"><s
765757
</pre>
766758
<p>In this case, each chapter will form a separate page group. @page:nth(3 of body) will select the third page of each chapter, even if that page happens to use the “broadside” named page. @page:nth(1) will select only the first page of the document, as will @page:first.</p>
767759
</div>
768-
<h2 class="heading settled" data-level="4" id="leaders"><span class="secno">4. </span><span class="content"> Leaders </span><a class="self-link" href="#leaders"></a></h2>
769-
A leader, sometimes known as a tab leader or a dot leader, is a repeating pattern used to visually connect content across horizontal spaces. They are most commonly used in tables of contents, between titles and page numbers. The <a class="css" data-link-type="maybe" href="#funcdef-leader">leader()</a> function, as a value for the content property, is used to create leaders in CSS. This function takes a string (the leader string), which describes the repeating pattern for the leader.
770-
<table class="definition propdef partial" data-link-for-hint="content">
771-
<tbody>
772-
<tr>
773-
<th>Name:
774-
<td><a class="css" data-link-type="property" href="https://drafts.csswg.org/css-content-3/#propdef-content">content</a>
775-
<tr class="value">
776-
<th>New values:
777-
<td class="prod">leader()
778-
<tr>
779-
<th>Media:
780-
<td>paged
781-
</table>
782-
<pre class="prod"><dfn data-dfn-type="function" data-export="" id="funcdef-leader">leader()<a class="self-link" href="#funcdef-leader"></a></dfn> = leader( [dotted <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> solid <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> space] <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> <a class="production" data-link-type="type" href="https://drafts.csswg.org/css-values-3/#string-value">&lt;string></a>);
783-
</pre>
784-
<p>Three keywords are shorthand values for common strings:</p>
785-
<dl>
786-
<dt id="dotted-leader"><a class="self-link" href="#dotted-leader"></a>dotted
787-
<dd>leader(". ")
788-
<dt id="solid-leader"><a class="self-link" href="#solid-leader"></a>solid
789-
<dd>leader("_")
790-
<dt id="space-leader"><a class="self-link" href="#space-leader"></a>space
791-
<dd>leader(" ")
792-
<dt id="string-leader"><a class="self-link" href="#string-leader"></a>&lt;string>
793-
<dd>
794-
</dl>
795-
<div class="example" id="example-34ba6164">
796-
<a class="self-link" href="#example-34ba6164"></a>
797-
<pre>ol.toc a::after {
798-
content: leader('.') target-counter(attr(href), page);
799-
}
800-
801-
&lt;h1>Table of Contents&lt;/h1>
802-
&lt;ol class="toc">
803-
&lt;li>&lt;a href="#chapter1">Loomings&lt;/a>&lt;/li>
804-
&lt;li>&lt;a href="#chapter2">The Carpet-Bag&lt;/a>&lt;/li>
805-
&lt;li>&lt;a href="#chapter3">The Spouter-Inn&lt;/a>&lt;/li>
806-
&lt;/ol>
807-
808-
</pre>
809-
This might result in:
810-
<pre>Table of Contents
811-
812-
1. Loomings.....................1
813-
2. The Carpet-Bag...............9
814-
3. The Spouter-Inn.............13
815-
</pre>
816-
</div>
817-
<p class="issue" id="issue-2f5c8d3f"><a class="self-link" href="#issue-2f5c8d3f"></a> Do leaders depend on the assumption that the content after the leader is right-aligned (end-aligned)? </p>
818-
<h3 class="heading settled" data-level="4.1" id="rendering-leaders"><span class="secno">4.1. </span><span class="content"> Rendering leaders </span><a class="self-link" href="#rendering-leaders"></a></h3>
819-
Consider a line which contains the content before the leader (the “before content”), the leader, and the content after the leader (the “after content”). Leaders obey the following rules:
820-
<ol>
821-
<li>The leader string must appear in full at least once.
822-
<li>The leader should be as long as possible
823-
<li>Visible characters in leaders should vertically align with each other when possible.
824-
<li>Line break characters in the leader string must be ignored.
825-
<li>White space in the leader string follows normal CSS rules.
826-
<li>A leader only appears between the start content and the end content.
827-
<li>A leader only appears on a single line, even if the before content and after content are on different lines.
828-
<li>A leader can’t be the only thing on a line.
829-
</ol>
830-
<h4 class="heading settled" data-level="4.1.1" id="procedure-leader"><span class="secno">4.1.1. </span><span class="content"> Procedure for rendering leaders </span><a class="self-link" href="#procedure-leader"></a></h4>
831-
<ol>
832-
<li>
833-
Lay out the before content, until reaching the line where the before content ends.
834-
<pre>BBBBBBBBBB
835-
BBB
836-
</pre>
837-
<li>
838-
The leader string consists of one or more glyphs, and is thus an inline box. A leader is a row of these boxes, drawn from the end edge to the start edge, where only those boxes not overlaid by the before or after content. On this line, draw the leader string, starting from the end edge, repeat 7E53 ing as many times as possible until reaching the start edge.
839-
<pre>BBBBBBBBBB
840-
..........
841-
</pre>
842-
<li>
843-
Draw the before and after content on top of the leader. If any part of the before or after content overlaps a glyph in a leader string box, that glyph is not displayed.
844-
<pre>BBBBBBBBBB
845-
BBB....AAA
846-
</pre>
847-
<li>
848-
If one full copy of the leader string is not visible:
849-
<pre>BBBBBBB
850-
BBBBBBA
851-
</pre>
852-
Insert a line break before the after content, draw the leader on the next line, and draw the end content on top
853-
<pre>BBBBBBB
854-
BBBBBB
855-
......A
856-
</pre>
857-
</ol>
858-
<figure>
859-
<img alt="drawing leaders" src="images/leader.001.jpg" width="480">
860-
<figcaption>Procedure for drawing leaders</figcaption>
861-
</figure>
862-
<figure>
863-
<img alt="drawing leaders" src="images/leader.002.jpg" width="480">
864-
<figcaption>Procedure for drawing leaders when the content doesn’t fit on a single line</figcaption>
865-
</figure>
760+
<h2 class="heading settled" data-level="4" id="leaders"><span class="secno">4. </span><span class="content"> Leaders (moved) </span><a class="self-link" href="#leaders"></a></h2>
761+
<p class="issue" id="issue-ca446e90"><a class="self-link" href="#issue-ca446e90"></a> Now described in <a data-link-type="biblio" href="#biblio-css3-content">[CSS3-CONTENT]</a></p>
866762
<h2 class="heading settled" data-level="5" id="cross-references"><span class="secno">5. </span><span class="content"> Cross-references </span><a class="self-link" href="#cross-references"></a></h2>
867763
Many documents contain internal references:
868764
<ul>
@@ -932,7 +828,7 @@ <h3 class="heading settled" data-level="5.3" id="target-text"><span class="secno
932828
Result: …which will be discussed later, in the chapter entitled Loomings.
933829
</div>
934830
<h2 class="heading settled" data-level="6" id="bookmarks"><span class="secno">6. </span><span class="content"> Bookmarks (moved) </span><a class="self-link" href="#bookmarks"></a></h2>
935-
<p class="issue" id="issue-ca446e90"><a class="self-link" href="#issue-ca446e90"></a> Now described in <a data-link-type="biblio" href="#biblio-css3-content">[CSS3-CONTENT]</a></p>
831+
<p class="issue" id="issue-ca446e900"><a class="self-link" href="#issue-ca446e900"></a> Now described in <a data-link-type="biblio" href="#biblio-css3-content">[CSS3-CONTENT]</a></p>
936832
<h2 class="no-num heading settled" id="former-wd-sections"><span class="content">Appendix A: Where Are They Now?</span><a class="self-link" href="#former-wd-sections"></a></h2>
937833
<p>Many sections which were in the <a href="http://www.w3.org/TR/2011/WD-css3-gcpm-20111129/">29 November 2011 Working Draft</a> have been moved to other specifications. Here are some notes on where things have moved.</p>
938834
<h3 class="heading settled" id="page-marks-and-bleed-area"><span class="content">Page marks and bleed area</span><a class="self-link" href="#page-marks-and-bleed-area"></a></h3>
@@ -1158,7 +1054,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
11581054
<li><a href="#propdef-footnote-display">footnote-display</a><span>, in §2.3</span>
11591055
<li><a href="#propdef-footnote-policy">footnote-policy</a><span>, in §2.8</span>
11601056
<li><a href="#footnote-display-inline">inline</a><span>, in §2.3</span>
1161-
<li><a href="#funcdef-leader">leader()</a><span>, in §4</span>
11621057
<li><a href="#footnote-policy-line">line</a><span>, in §2.8</span>
11631058
<li><a href="#named-string">named string</a><span>, in §1</span>
11641059
<li><a href="#funcdef-nth">nth()</a><span>, in §3.1</span>
@@ -1369,9 +1264,9 @@ <h2 class="no-num heading settled" id="issues-index"><span class="content">Issue
13691264
<div class="issue">How do footnotes work in multi-column text? Prince uses <code>float: prince-column-footnote</code> to create a footnote at the bottom of a column rather than the bottom of a page.<a href="#issue-ab22b570"> ↵ </a></div>
13701265
<div class="issue">Implementations that support footnotes generally support page floats like <code>float: bottom</code>. Page floats should end up above the footnote area. How might this be specified?<a href="#issue-165f8769"> ↵ </a></div>
13711266
<div class="issue">We need an algorithm for laying out footnotes<a href="#issue-da883bb8"> ↵ </a></div>
1372-
<div class="issue"> Do leaders depend on the assumption that the content after the leader is right-aligned (end-aligned)? <a href="#issue-2f5c8d3f"> ↵ </a></div>
1373-
<div class="issue">A simpler syntax has been proposed by fantasai: http://lists.w3.org/Archives/Public/www-style/2012Feb/0745.html<a href="#issue-a82075c9"> ↵ </a></div>
13741267
<div class="issue"> Now described in <a data-link-type="biblio" href="#biblio-css3-content">[CSS3-CONTENT]</a><a href="#issue-ca446e90"> ↵ </a></div>
1268+
<div class="issue">A simpler syntax has been proposed by fantasai: http://lists.w3.org/Archives/Public/www-style/2012Feb/0745.html<a href="#issue-a82075c9"> ↵ </a></div>
1269+
<div class="issue"> Now described in <a data-link-type="biblio" href="#biblio-css3-content">[CSS3-CONTENT]</a><a href="#issue-ca446e900"> ↵ </a></div>
13751270
</div>
13761271
</body>
13771272
</html>

0 commit comments

Comments
 (0)