Skip to content

Commit ab0e142

Browse files
committed
[css-page] Update references in page progression section. Fix bikeshed errors.
1 parent a0cca81 commit ab0e142

File tree

2 files changed

+1150
-2734
lines changed

2 files changed

+1150
-2734
lines changed

css-page/Overview.bs

Lines changed: 52 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Previous Version: http://www.w3.org/TR/2013/WD-css3-page-20130314/
1313
Editor: Elika J. Etemad / fantasai, Invited Expert, formerly Mozilla, http://fantasai.inkedblade.net/contact
1414
Editor: Simon Sapin, Mozilla, formerly Kozea, http://exyr.org/about/
1515
Ignored terms: fit, fit-position, stacking context
16-
Link defaults: css-break (property) break-after, css21 (property) display, css21 (property) min-height, css21 (property) max-height, css21 (property) min-width, css21 (property) max-width, css21 (property) margin, css-content-3 (property) counter-increment, css-content-3 (property) counter-reset
16+
Link defaults: css-break (property) break-after, css21 (property) display, css21 (property) min-height, css21 (property) max-height, css21 (property) min-width, css21 (property) max-width, css21 (property) margin, css21 (property) counter-increment, css21 (property) counter-reset
1717
Abstract: This CSS module specifies how pages are generated and laid out to hold fragmented content in a paged presentation. It adds functionality for controlling page margins, page size and orientation, and headers and footers, and extends generated content to enable page numbering and running headers / footers. The process of paginating a flow into such generated pages is covered in [[!CSS3-BREAK]].
1818
</pre>
1919

@@ -259,7 +259,7 @@ Page Backgrounds and Painting Order</h3>
259259
which covers the entire page box, including its margins (regardless of 'background-clip').
260260
Page backgrounds are anchored within the page box's padding area by default
261261
(and honor 'background-origin' if the UA supports [[!CSS3BG]]).
262-
However if 'background-attachment' is ''fixed''
262+
However if 'background-attachment' is ''background-attachment/fixed''
263263
then the image is positioned relative to the page box including its margins
264264
(i.e. the <a spec=css-backgrounds>background positioning area</a>
265265
is the page's margin box).
@@ -344,7 +344,7 @@ box:
344344
A <dfn export id="content-empty">Content-empty page</dfn> is a page box whose page
345345
area contains no printable content other than backgrounds and/or borders. A
346346
page box whose page area contains generated content, or content whose
347-
visibility is ''hidden'', or invisible content such as a zero-width space is
347+
visibility is ''visibility/hidden'', or invisible content such as a zero-width space is
348348
not a content-empty page. On the other hand, a page containing only a
349349
background and/or borders and/or page-margin box content <em>is</em> a
350350
content-empty page.
@@ -367,61 +367,61 @@ box:
367367

368368
<h3 id="progression">Page Progression</h3>
369369

370-
CSS distinguishes between left pages and right pages on all documents,
371-
whether they are printed duplex or not. Each left page is followed by a
372-
right page and vice versa. Left and right pages can be styled differently
373-
with the <a href="#left-right-first"><code>:left</code> and <code>:right</code>
374-
pseudo-classes</a>.
370+
CSS distinguishes between left pages and right pages on all documents,
371+
whether they are printed duplex or not.
372+
Each left page is followed by a right page and vice versa.
373+
Left and right pages can be styled differently
374+
with the <a href="#left-right-first"><code>:left</code> and <code>:right</code> pseudo-classes</a>.
375375

376-
Whether the first page of a document is a left page or a right page
377-
depends on the page progression of the document. The <dfn export>page progression</dfn>
378-
is the direction in which the printed pages of a document would be sequenced
379-
when laid out side-to-side. For example, English and horizontally-set Japanese
380-
typically progress from left to right, whereas Arabic and vertically-set
381-
Japanese pages typically progress from right to left. In documents with
382-
a left-to-right page progression the first page of the document is a right
383-
page, and vice versa.
376+
Whether the first page of a document is a left page or a right page
377+
depends on the page progression of the document.
378+
The <dfn export>page progression</dfn>
379+
is the direction in which the printed pages of a document would be sequenced
380+
when laid out side-to-side.
381+
For example, English and horizontally-set Japanese typically progress from left to right,
382+
whereas Arabic and vertically-set Japanese pages typically progress from right to left.
384383

385-
The page progression direction is determined as follows:
384+
The page progression direction is determined as follows:
386385

387-
<ul>
388-
<li>If text is laid out in horizontal lines, the page progression is the
389-
same as the inline progression.
390-
<li>If text is laid out in vertical lines, the page progression is the
391-
same as the block progression.
392-
</ul>
386+
<ul>
387+
<li>If text is laid out in horizontal lines,
388+
the <a>page progression</a> is the same as the <a>inline base direction</a>.
389+
<li>If text is laid out in vertical lines,
390+
the <a>page progression</a> is the same as the <a>block flow direction</a>.
391+
</ul>
393392

394-
If the UA supports the 'direction' and 'writing-mode' properties
395-
from the CSS 3 Writing Modes Module [[CSS3-WRITING-MODES]], it must
396-
<a href="http://www.w3.org/TR/css3-writing-modes/#page-direction">determine</a>
397-
whether the first page is a left or right page from the values of those
398-
properties on the root element.
393+
If the UA supports the 'direction' and 'writing-mode' properties
394+
from the CSS 3 Writing Modes Module [[CSS3-WRITING-MODES]], it must
395+
<a href="http://www.w3.org/TR/css3-writing-modes/#page-direction">determine</a>
396+
the <a>page progression</a> is determed by the <a>principal writing mode</a>.
399397

398+
In documents with a left-to-right <a>page progression</a>
399+
the first page of the document is a right page, and vice versa.
400400
To explicitly force a document to begin printing on a left or right page,
401401
authors can specify a <a href="http://www.w3.org/TR/css3-break/#break-before">'break-before'</a> value
402402
that that propagates a page break to the root. [[!CSS3-BREAK]]
403403
The UA must suppress the first (empty) page(s) in this case
404404
(and the <code>:first</code> pseudo-class matches the first printed page).
405405

406-
<div class="example">
407-
<pre>
408-
html { break-before: always }
409-
</pre>
406+
<div class="example">
407+
<pre>
408+
html { break-before: always }
409+
</pre>
410410

411-
For an HTML document with a left-to-right page progression,
412-
the above style rule will cause the first page of the document
413-
to print on a ':left' page
411+
For an HTML document with a left-to-right page progression,
412+
the above style rule will cause the first page of the document
413+
to print on a ':left' page
414414

415-
<pre>
416-
html { break-before: left }
417-
</pre>
415+
<pre>
416+
html { break-before: left }
417+
</pre>
418418

419-
For an HTML document,
420-
the above style rule will cause the first page of the document
421-
to print on a ':left' page,
422-
regardless of the page progression.
419+
For an HTML document,
420+
the above style rule will cause the first page of the document
421+
to print on a ':left' page,
422+
regardless of the page progression.
423423

424-
</div>
424+
</div>
425425

426426
<h2 id="page-selector-and-context">
427427
Page Selectors and the Page Context</h2>
@@ -551,7 +551,7 @@ Blank-page pseudo-class: '':blank''</h4>
551551
<a href="http://www.w3.org/TR/css3-break/#forced-breaks">forced page breaks</a>.
552552

553553
<div class="note">
554-
Only the ''left'', ''right'', ''recto'' and ''verso'' values
554+
Only the ''break-before/left'', ''break-before/right'', ''break-before/recto'' and ''break-before/verso'' values
555555
of the 'break-before' and 'break-after' properties
556556
can generate pages that match '':blank''.
557557
</div>
@@ -1081,12 +1081,12 @@ then it must behave as if 'min-height' and 'min-width' were always zero.
10811081
as defined in [[!CSS21]].
10821082

10831083
<dt><dfn>min-content width</dfn>
1084-
<dd>Whichever of <a spec=css-sizing>min-content block-size</a>
1085-
or <a spec=css-sizing>min-content inline-size</a> is the physical width.
1084+
<dd>Whichever of <a spec=css-sizing>min-content block size</a>
1085+
or <a spec=css-sizing>min-content inline size</a> is the physical width.
10861086

10871087
<dt><dfn>max-content width</dfn>
1088-
<dd>Whichever of <a spec=css-sizing>max-content block-size</a>
1089-
or <a spec=css-sizing>max-content inline-size</a> is the physical width.
1088+
<dd>Whichever of <a spec=css-sizing>max-content block size</a>
1089+
or <a spec=css-sizing>max-content inline size</a> is the physical width.
10901090

10911091
<dt><dfn>outer min width</dfn>
10921092
<dd>Like the <a>outer width</a>,
@@ -1472,7 +1472,7 @@ Page Properties</h2>
14721472

14731473
<li>
14741474
As on the '::before' and '::after' pseudo-elements,
1475-
the ''normal'' value of the 'content' property computes to ''none''
1475+
the ''content/normal'' value of the 'content' property computes to ''none''
14761476
on page-margin boxes.
14771477

14781478
<li>
@@ -1513,11 +1513,11 @@ Page-based counters</h3>
15131513
flow that spans the page break. Use of the counter in this way does not affect
15141514
the calculation of the counter's value.
15151515

1516-
A counter named ''page'' is automatically created
1516+
A counter named <css>page</css> is automatically created
15171517
and incremented by 1 on every page of the document,
15181518
unless the 'counter-increment' property in the <a>page context</a>
1519-
explicitly specifies a different increment for the ''page'' counter.
1520-
The implied ''page'' counter is a real counter,
1519+
explicitly specifies a different increment for the <css>page</css> counter.
1520+
The implied <css>page</css> counter is a real counter,
15211521
and can be directly affected using the 'counter-increment' and 'counter-reset' properties
15221522
when named explicitly in those properties.
15231523
It can also be used in the 'counter()' and 'counters()' function forms.

0 commit comments

Comments
 (0)