Skip to content

Commit a1bc1d2

Browse files
committed
Outdent headers. Rewrite intro take I.
1 parent 8dd6439 commit a1bc1d2

2 files changed

Lines changed: 154 additions & 126 deletions

File tree

css3-break/Overview.html

Lines changed: 82 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -84,14 +84,14 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 24 January
8484
<hr title="Separator for header">
8585
</div>
8686

87-
<h2 class="no-num no-toc" id=abstract>Abstract</h2>
87+
<h2 class="no-num no-toc" id=abstract> Abstract</h2>
8888

8989
<p> This module describes the fragmentation model that partitions a flow
9090
into pages. It builds on the Page model module and introduces and defines
9191
the fragmentation model. It adds functionality for pagination, breaking
9292
variable fragment size and orientation, widows and orphans.
9393

94-
<h2 class="no-num no-toc" id=status>Status of this document</h2>
94+
<h2 class="no-num no-toc" id=status> Status of this document</h2>
9595
<!--begin-status-->
9696

9797
<p>This is a public copy of the editors' draft. It is provided for
@@ -127,46 +127,47 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
127127
<!--end-status-->
128128
<!--<p>The following features are at risk: &hellip;</p>-->
129129

130-
<h2 class="no-num no-toc" id=contents>Table of contents</h2>
130+
<h2 class="no-num no-toc" id=contents> Table of contents</h2>
131131
<!--begin-toc-->
132132

133133
<ul class=toc>
134-
<li><a href="#intro"><span class=secno>1. </span>Introduction</a>
134+
<li><a href="#intro"><span class=secno>1. </span> Introduction</a>
135135
<ul class=toc>
136-
<li><a href="#placement"><span class=secno>1.1. </span>Module
136+
<li><a href="#placement"><span class=secno>1.1. </span> Module
137137
Interactions</a>
138138

139-
<li><a href="#values"><span class=secno>1.2. </span>Values</a>
139+
<li><a href="#values"><span class=secno>1.2. </span> Values</a>
140140
</ul>
141141

142-
<li><a href="#page-breaks"><span class=secno>2. </span>Page Breaks</a>
142+
<li><a href="#page-breaks"><span class=secno>2. </span> Page Breaks</a>
143143
<ul class=toc>
144-
<li><a href="#pg-br-before-after"><span class=secno>2.1. </span> Break
145-
before/after elements: &lsquo;<code
144+
<li><a href="#pg-br-before-after"><span class=secno>2.1. </span>
145+
Breaking before/after/inside elements: the &lsquo;<code
146146
class=property>page-break-before</code>&rsquo;, &lsquo;<code
147-
class=property>page-break-after</code>&rsquo;, &lsquo;<code
148-
class=property>page-break-inside</code>&rsquo; </a>
147+
class=property>page-break-after</code>&rsquo;, and &lsquo;<code
148+
class=property>page-break-inside</code>&rsquo; properties </a>
149149

150-
<li><a href="#using-named-pages"><span class=secno>2.2. </span>Using
151-
named pages: &lsquo;<code class=property>page</code>&rsquo;</a>
150+
<li><a href="#using-named-pages"><span class=secno>2.2. </span> Using
151+
named pages: the &lsquo;<code class=property>page</code>&rsquo;
152+
property</a>
152153

153-
<li><a href="#breaks-inside"><span class=secno>2.3. </span>Breaks inside
154-
elements: &lsquo;<code class=property>orphans</code>&rsquo;,
154+
<li><a href="#breaks-inside"><span class=secno>2.3. </span> Breaks
155+
inside elements: &lsquo;<code class=property>orphans</code>&rsquo;,
155156
&lsquo;<code class=property>widows</code>&rsquo;</a>
156157

157-
<li><a href="#allowed-pg-brk"><span class=secno>2.4. </span>Allowed page
158-
breaks</a>
158+
<li><a href="#allowed-pg-brk"><span class=secno>2.4. </span> Allowed
159+
page breaks</a>
159160

160-
<li><a href="#forced-pg-brk"><span class=secno>2.5. </span>Forced page
161+
<li><a href="#forced-pg-brk"><span class=secno>2.5. </span> Forced page
161162
breaks</a>
162163

163-
<li><a href="#best-pg-brk"><span class=secno>2.6. </span>"Best" page
164+
<li><a href="#best-pg-brk"><span class=secno>2.6. </span> "Best" page
164165
breaks</a>
165166
</ul>
166167

167-
<li><a href="#conformance"><span class=secno>3. </span>Conformance</a>
168+
<li><a href="#conformance"><span class=secno>3. </span> Conformance</a>
168169
<ul class=toc>
169-
<li><a href="#conventions"><span class=secno>3.1. </span>Document
170+
<li><a href="#conventions"><span class=secno>3.1. </span> Document
170171
Conventions</a>
171172

172173
<li><a href="#conformance-classes"><span class=secno>3.2.
@@ -185,7 +186,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
185186
Criteria</a>
186187
</ul>
187188

188-
<li class=no-num><a href="#acknowledgments">Acknowledgments</a>
189+
<li class=no-num><a href="#acknowledgments"> Acknowledgments</a>
189190

190191
<li class=no-num><a href="#references">References</a>
191192
<ul class=toc>
@@ -201,47 +202,28 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
201202
</ul>
202203
<!--end-toc-->
203204

204-
<h2 id=intro><span class=secno>1. </span>Introduction</h2>
205+
<h2 id=intro><span class=secno>1. </span> Introduction</h2>
205206

206207
<p><em>This section is not normative.</em>
207208

208-
<p> Paged media (e.g., paper, transparencies, photo album pages, pages
209-
displayed on computer screens as printed output simulations) differ from
210-
<a href="/TR/CSS2/media.html#continuous-media-group"> continuous media</a>
211-
in that the content of the document is split into one or more discrete
212-
static display surfaces. To handle pages, CSS3 Paged Media describes how:
213-
214-
<ul>
215-
<li><a href="#page-breaks">page breaks</a> are created and avoided;
216-
217-
<li>the page properties such as size, orientation, margins, border, and
218-
padding are specified;
219-
220-
<li>headers and footers are established within the page margins;
221-
222-
<li>content such as page counters are placed in the headers and footers;
223-
and
224-
225-
<li>orphans and widows can be controlled.
226-
</ul>
227-
228-
<p> This module defines a <a href="#page-model">page model</a> that
229-
specifies how a document is formatted within a rectangular area, called
230-
the <a href="#page-box-page-rule"> page box</a>, that has finite width and
231-
height.
232-
233-
<p> Although CSS3 does not specify how user agents transfer page boxes to
234-
sheets, it does include certain mechanisms for telling user agents about
235-
the intended page sheet <a href="#page-size">size and orientation</a>. In
236-
the general case, CSS3 assumes that one page box will be transferred to
237-
one surface of similar size.
238-
239-
<p> All properties defined in this specification also accept the <a
240-
href="http://www.w3.org/TR/CSS21/cascade.html#value-def-inherit">
241-
inherit</a> keyword as their value, but for readability it has not been
242-
listed explicitly.
243-
244-
<h3 id=placement><span class=secno>1.1. </span>Module Interactions</h3>
209+
<p> In paged media (e.g., paper, transparencies, photo album pages, pages
210+
displayed on computer screens as printed output simulations), as opposed
211+
to <a href="/TR/CSS2/media.html#continuous-media-group"> continuous
212+
media</a>, the content of the document is split into one or more discrete
213+
display surfaces. In order to avoid awkward breaks (such as halfway
214+
through a line of text), the layout engine must be able to shift around
215+
content that would fall across the page break. This process is called <dfn
216+
id=pagination>pagination</dfn>.
217+
218+
<p> In CSS, in addition to paged media, certain layout features such as
219+
regions <a href="#CSS3-REGIONS"
220+
rel=biblioentry>[CSS3-REGIONS]<!--{{CSS3-REGIONS}}--></a> and multi-column
221+
layout <a href="#CSS3COL" rel=biblioentry>[CSS3COL]<!--{{CSS3COL}}--></a>
222+
create a similarly fragmented environment. This module explains how
223+
content breaks across fragment containers such as pages and columns and
224+
how such breaks can be controlled by the author.
225+
226+
<h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
245227

246228
<p> This module replaces and extends the pagination controls defined in <a
247229
href="#CSS21" rel=biblioentry>[CSS21]<!--{{CSS21}}--></a> <a
@@ -250,7 +232,7 @@ <h3 id=placement><span class=secno>1.1. </span>Module Interactions</h3>
250232
rel=biblioentry>[CSS3PAGE]<!--{{CSS3PAGE}}--></a>.</p>
251233
<!-- End section "Modules Interactions" -->
252234

253-
<h3 id=values><span class=secno>1.2. </span>Values</h3>
235+
<h3 id=values><span class=secno>1.2. </span> Values</h3>
254236

255237
<p> This specification follows the <a
256238
href="http://www.w3.org/TR/CSS21/about.html#property-defs"> CSS property
@@ -269,7 +251,7 @@ <h3 id=values><span class=secno>1.2. </span>Values</h3>
269251
inherit</a> keyword as their property value. For readability it has not
270252
been repeated explicitly.
271253

272-
<h2 id=page-breaks><span class=secno>2. </span>Page Breaks</h2>
254+
<h2 id=page-breaks><span class=secno>2. </span> Page Breaks</h2>
273255

274256
<p> The following sections explain page breaking in CSS3 paged media. Five
275257
properties indicate where the user agent may or should break pages, and on
@@ -284,13 +266,14 @@ <h2 id=page-breaks><span class=secno>2. </span>Page Breaks</h2>
284266
the page, through an ensuing blank page if one exists, and onto the top of
285267
the subsequent page.
286268

287-
<h3 id=pg-br-before-after><span class=secno>2.1. </span> Break before/after
288-
elements: &lsquo;<a href="#page-break-before"><code
269+
<h3 id=pg-br-before-after><span class=secno>2.1. </span> Breaking
270+
before/after/inside elements: the &lsquo;<a
271+
href="#page-break-before"><code
289272
class=property>page-break-before</code></a>&rsquo;, &lsquo;<a
290273
href="#page-break-after"><code
291-
class=property>page-break-after</code></a>&rsquo;, &lsquo;<a
274+
class=property>page-break-after</code></a>&rsquo;, and &lsquo;<a
292275
href="#page-break-inside"><code
293-
class=property>page-break-inside</code></a>&rsquo;</h3>
276+
class=property>page-break-inside</code></a>&rsquo; properties</h3>
294277

295278
<table class=propdef summary="property definition">
296279
<tbody>
@@ -473,8 +456,9 @@ <h3 id=pg-br-before-after><span class=secno>2.1. </span> Break before/after
473456
is in the normal flow of the root element. User agents may also apply
474457
these properties to other boxes.
475458

476-
<h3 id=using-named-pages><span class=secno>2.2. </span>Using named pages:
477-
&lsquo;<a href="#page"><code class=property>page</code></a>&rsquo;</h3>
459+
<h3 id=using-named-pages><span class=secno>2.2. </span> Using named pages:
460+
the &lsquo;<a href="#page"><code class=property>page</code></a>&rsquo;
461+
property</h3>
478462

479463
<table class=propdef summary="property definition">
480464
<tbody>
@@ -587,7 +571,7 @@ <h3 id=using-named-pages><span class=secno>2.2. </span>Using named pages:
587571
&lt;/div&gt;</pre>
588572
</div>
589573

590-
<h3 id=breaks-inside><span class=secno>2.3. </span>Breaks inside elements:
574+
<h3 id=breaks-inside><span class=secno>2.3. </span> Breaks inside elements:
591575
&lsquo;<a href="#orphans"><code class=property>orphans</code></a>&rsquo;,
592576
&lsquo;<a href="#widows"><code class=property>widows</code></a>&rsquo;</h3>
593577

@@ -697,7 +681,7 @@ <h3 id=breaks-inside><span class=secno>2.3. </span>Breaks inside elements:
697681
href="#orphans"><code class=property>orphans</code></a>&rsquo;, the rule
698682
simply becomes that all lines in the block must be kept together.
699683

700-
<h3 id=allowed-pg-brk><span class=secno>2.4. </span>Allowed page breaks</h3>
684+
<h3 id=allowed-pg-brk><span class=secno>2.4. </span> Allowed page breaks</h3>
701685

702686
<p>In the normal flow, page breaks may occur at the following places:
703687

@@ -762,7 +746,7 @@ <h3 id=allowed-pg-brk><span class=secno>2.4. </span>Allowed page breaks</h3>
762746
<p> If that still does not lead to sufficient break points, rule C is
763747
dropped as well, to find still more break points.
764748

765-
<h3 id=forced-pg-brk><span class=secno>2.5. </span>Forced page breaks</h3>
749+
<h3 id=forced-pg-brk><span class=secno>2.5. </span> Forced page breaks</h3>
766750

767751
<p> A page break must occur at <a href="#brk-btw-blocks">(1)</a> if, among
768752
the'page-break-after' and &lsquo;<a href="#page-break-before"><code
@@ -792,7 +776,7 @@ <h3 id=forced-pg-brk><span class=secno>2.5. </span>Forced page breaks</h3>
792776
the used values of any adjoining &lsquo;<code
793777
class=property>margin-bottom</code>&rsquo; are set to zero.
794778

795-
<h3 id=best-pg-brk><span class=secno>2.6. </span>"Best" page breaks</h3>
779+
<h3 id=best-pg-brk><span class=secno>2.6. </span> "Best" page breaks</h3>
796780

797781
<p> CSS3 does <em>not</em> define which of a set of allowed page breaks
798782
must be used; except as defined earlier in the section, CSS3 does not
@@ -851,9 +835,9 @@ <h3 id=best-pg-brk><span class=secno>2.6. </span>"Best" page breaks</h3>
851835
</div>
852836
<!-- End section "Page Breaks" -->
853837

854-
<h2 id=conformance><span class=secno>3. </span>Conformance</h2>
838+
<h2 id=conformance><span class=secno>3. </span> Conformance</h2>
855839

856-
<h3 id=conventions><span class=secno>3.1. </span>Document Conventions</h3>
840+
<h3 id=conventions><span class=secno>3.1. </span> Document Conventions</h3>
857841

858842
<p> Conformance requirements are expressed with a combination of
859843
descriptive assertions and RFC 2119 terminology. The key words “must”,
@@ -1021,7 +1005,7 @@ <h3 id=cr-exit-criteria><span class=secno>3.6. </span> CR Exit Criteria</h3>
10211005
<p> The specification will remain Candidate Recommendation for at least six
10221006
months.
10231007

1024-
<h2 class=no-num id=acknowledgments>Acknowledgments</h2>
1008+
<h2 class=no-num id=acknowledgments> Acknowledgments</h2>
10251009

10261010
<p> The editors would like to extend special thanks to Michael Day, and the
10271011
former <a href="#CSS3PAGE"
@@ -1068,6 +1052,26 @@ <h3 class=no-num id=other-references>Other references</h3>
10681052
<dt style="display: none"><!-- keeps the doc valid if the DL is empty -->
10691053
<!---->
10701054

1055+
<dt id=CSS3-REGIONS>[CSS3-REGIONS]
1056+
1057+
<dd>Vincent Hardy; Alex Mogilevsky. <a
1058+
href="http://www.w3.org/TR/2011/WD-css3-regions-20111129/"><cite>CSS
1059+
Regions Module Level 3.</cite></a> 29 November 2011. W3C Working Draft.
1060+
(Work in progress.) URL: <a
1061+
href="http://www.w3.org/TR/2011/WD-css3-regions-20111129/">http://www.w3.org/TR/2011/WD-css3-regions-20111129/</a>
1062+
</dd>
1063+
<!---->
1064+
1065+
<dt id=CSS3COL>[CSS3COL]
1066+
1067+
<dd>H&#229;kon Wium Lie. <a
1068+
href="http://www.w3.org/TR/2011/CR-css3-multicol-20110412"><cite>CSS
1069+
Multi-column Layout Module.</cite></a> 12 April 2011. W3C Candidate
1070+
Recommendation. (Work in progress.) URL: <a
1071+
href="http://www.w3.org/TR/2011/CR-css3-multicol-20110412">http://www.w3.org/TR/2011/CR-css3-multicol-20110412</a>
1072+
</dd>
1073+
<!---->
1074+
10711075
<dt id=CSS3COLOR>[CSS3COLOR]
10721076

10731077
<dd>Tantek &#199;elik; Chris Lilley; L. David Baron. <a
@@ -1109,6 +1113,9 @@ <h2 class=no-num id=index>Index</h2>
11091113
<li>page-break-inside, <a href="#page-break-inside"
11101114
title=page-break-inside><strong>2.1.</strong></a>
11111115

1116+
<li>pagination, <a href="#pagination"
1117+
title=pagination><strong>1.</strong></a>
1118+
11121119
<li>renderer, <a href="#renderer" title=renderer><strong>3.2.</strong></a>
11131120

11141121

0 commit comments

Comments
 (0)