Skip to content

Commit c70616b

Browse files
committed
[css-page] Fix some markup, add more dfns, export more dfns.
1 parent 0d9fc56 commit c70616b

File tree

2 files changed

+300
-461
lines changed

2 files changed

+300
-461
lines changed

css-page/Overview.bs

Lines changed: 39 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -95,14 +95,14 @@ Page Terminology</h2>
9595
page model:
9696

9797
<dl>
98-
<dt><dfn>Page sheet</dfn>
98+
<dt><dfn export>Page sheet</dfn>
9999
<dd>
100100
<img src="PageSheet.png" style="float: right;" alt="The corner of a page sheet with the non-printable area at the edge and printable area inside it" height="148" width="194">
101101
The page sheet is one surface of the physical
102102
medium. The illustration to the right shows a representation of the upper-left
103103
corner of a page sheet.
104104

105-
<dt><dfn title="printable area">Printable and non-printable areas</dfn>
105+
<dt><dfn export title="printable area">Printable and non-printable areas</dfn>
106106
<dd>
107107
The non-printable area is the area of a page sheet that a physical device such
108108
as a printer is not capable of marking reliably, usually due to the printer's
@@ -117,7 +117,7 @@ Page Terminology</h2>
117117
device dependent within the constraints expressed in the sections
118118
[[#renderingpages]] and [[#content-outside-box]].
119119

120-
<dt><dfn>Page Orientation</dfn>
120+
<dt><dfn export>Page Orientation</dfn>
121121
<dd>
122122
The page orientation is defined by comparing the length of the edges of a
123123
<a>page box</a>. The page box is a rectangle with two
@@ -127,12 +127,12 @@ Page Terminology</h2>
127127
used as the long edge with the other being the short edge. This specification
128128
defines page orientations of ''portrait'' and ''landscape''.
129129

130-
<dt><dfn title="portrait|portrait orientation">Portrait Orientation</dfn>
130+
<dt><dfn export title="portrait|portrait orientation">Portrait Orientation</dfn>
131131
<dd>
132132
A portrait page's height is greater than or equal to its width. Horizontal
133133
elements are parallel to the short edge and vertical elements to the long edge.
134134

135-
<dt><dfn title="landscape|landscape orientation">Landscape Orientation</dfn>
135+
<dt><dfn export title="landscape|landscape orientation">Landscape Orientation</dfn>
136136
<dd>
137137
A landscape page's width is greater than or equal to its height. Horizontal
138138
elements are parallel to the long edge and vertical elements to the short edge.
@@ -143,15 +143,15 @@ Page Terminology</h2>
143143
page progression, and ease of reading when choosing between landscape and
144144
reverse-landscape renderings.
145145

146-
<dt><dfn>Duplex Printing</dfn>
146+
<dt><dfn export>Duplex Printing</dfn>
147147
<dd>
148148
Duplex printing prints one page box per side of a page sheet and uses both
149149
sides of the page sheet. This module provides no ability to specify whether a
150150
document is duplex printed, but the concept of left and right pages is based on
151151
the assumption that the document is duplex printed, regardless of whether or
152152
not it actually is.
153153

154-
<dt><dfn>Binding Edge</dfn>
154+
<dt><dfn export>Binding Edge</dfn>
155155
<dd>
156156
The binding edge is the edge of the page box that is toward the binding if the
157157
material is bound. The binding edge often has a larger margin than the opposite
@@ -161,7 +161,7 @@ Page Terminology</h2>
161161
provides no method to specify the binding edge. In duplex printing, the binding
162162
edge is on opposite sides of the page box for the left and right pages.
163163

164-
<dt><dfn>Facing Pages</dfn>
164+
<dt><dfn export>Facing Pages</dfn>
165165
<dd>
166166
Facing pages are two sequential pages such that when the document is duplex
167167
printed they are on separate sheets of paper. Typically, the earlier page will
@@ -170,14 +170,14 @@ Page Terminology</h2>
170170
are vertical and adjacent when the pages are placed in their normal reading
171171
orientation.
172172

173-
<dt><dfn>Left Page</dfn>
173+
<dt><dfn export>Left Page</dfn>
174174
<dd>
175175
A page that would be on the left if it is part of a pair of facing pages as
176176
typically laid out. Page layouts for documents using a left-to-right page
177177
progression have the earlier of the facing pages on the left. Rules specific to
178178
the left page can be specified using the '':left'' <a>page selector</a>.
179179

180-
<dt><dfn>Right Page</dfn>
180+
<dt><dfn export>Right Page</dfn>
181181
<dd>
182182
A page that would be on the right if it is part of a pair of facing pages as
183183
typically laid out. Page layouts for documents using a right-to-left page
@@ -188,7 +188,7 @@ Page Terminology</h2>
188188
<h2 id="page-model">The Page Model</h2>
189189

190190
In the paged media formatting model, the document is transferred into one
191-
or more page boxes. The <dfn>page box</dfn> is a specialized CSS
191+
or more page boxes. The <dfn export>page box</dfn> is a specialized CSS
192192
box that maps to a rectangular print media surface, such as a page of paper.
193193
It is roughly analogous to the <a href="http://www.w3.org/TR/CSS21/visuren.html#viewport">viewport</a>.
194194
<img src="PageBox.png" style="float: right;" alt="" height="266" width="267">
@@ -205,7 +205,7 @@ Page Terminology</h2>
205205

206206
<ul>
207207
<li>
208-
The content area of a page box is called the <dfn>page area</dfn>.
208+
The content area of a page box is called the <dfn export>page area</dfn>.
209209
The content of the document is flowed into one or more page boxes.
210210
The page area acts as a container for all the boxes generated by the root
211211
element and its descendants that are laid out within a given page box. The
@@ -215,7 +215,7 @@ Page Terminology</h2>
215215

216216
<li>
217217
The margin area of a page box is divided into
218-
16 <dfn>page-margin boxes</dfn>.
218+
16 <dfn export>page-margin boxes</dfn>.
219219
Each page-margin box has its own margin, border, padding and content areas.
220220
Page-margin boxes are typically used to display running headers and footers.
221221
</ul>
@@ -340,7 +340,7 @@ box:
340340
number of content-empty pages to honor the positioning of elements (e.g.,
341341
printing 100 blank pages is probably neither the author's nor the user's
342342
intent).
343-
A <dfn id="content-empty">Content-empty page</dfn> is a page box whose page
343+
A <dfn export id="content-empty">Content-empty page</dfn> is a page box whose page
344344
area contains no printable content other than backgrounds and/or borders. A
345345
page box whose page area contains generated content, or content whose
346346
visibility is ''hidden'', or invisible content such as a zero-width space is
@@ -373,7 +373,7 @@ with the <a href="#left-right-first"><code>:left</code> and <code>:right</code>
373373
pseudo-classes</a>.
374374

375375
Whether the first page of a document is a left page or a right page
376-
depends on the page progression of the document. The <dfn>page progression</dfn>
376+
depends on the page progression of the document. The <dfn export>page progression</dfn>
377377
is the direction in which the printed pages of a document would be sequenced
378378
when laid out side-to-side. For example, English and horizontally-set Japanese
379379
typically progress from left to right, whereas Arabic and vertically-set
@@ -430,14 +430,14 @@ The @page Rule</h3>
430430

431431
Authors can specify various aspects of a page box,
432432
such as its dimensions, orientation, and margins,
433-
within an ''@page'' rule.
433+
within an <dfn>@page</dfn> rule.
434434
''@page'' rules are allowed
435435
wherever <a href="http://www.w3.org/TR/CSS21/syndata.html#rule-sets">rule-sets</a> are allowed.
436436
An ''@page'' rule consists of the keyword ''@page'',
437437
an <em class="RFC2119">OPTIONAL</em> comma-separated list of
438438
<a href="#page-selectors">page selectors</a>
439439
and a block of declarations
440-
(said to be in the <dfn id="page-context">page context</dfn>).
440+
(said to be in the <dfn export id="page-context">page context</dfn>).
441441
An ''@page'' rule can also contain other at-rules,
442442
interleaved between declarations.
443443
The current level of this specification
@@ -454,7 +454,7 @@ apply; that is, valid declarations within the block are applied.
454454

455455
<h3 id="page-selectors">Page selectors</h3>
456456

457-
A <dfn id="page-selector">page selector</dfn> is made of
457+
A <dfn export id="page-selector">page selector</dfn> is made of
458458
either a <a>page type selector</a>
459459
or a <a>page pseudo-class</a>,
460460
followed by zero or more additional <a>page pseudo-classes</a>.
@@ -465,7 +465,7 @@ apply; that is, valid declarations within the block are applied.
465465
A <a>page selector</a> is said to <dfn>match</dfn> a given page if and only if
466466
all of its components match the page.
467467

468-
A <dfn>page type selector</dfn> is
468+
A <dfn export>page type selector</dfn> is
469469
a case-sensitive <a href="http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier">CSS identifier</a> [[!CSS21]].
470470
It <a>matches</a> pages of the <a href="#using-named-pages">named page type</a>
471471
generated by the 'page' property.
@@ -476,7 +476,7 @@ apply; that is, valid declarations within the block are applied.
476476
but must never match.
477477
</span>
478478

479-
A <dfn>page pseudo-class</dfn> is <a href="http://www.w3.org/TR/CSS21/syndata.html#characters">ASCII case-insensitive</a>
479+
A <dfn export>page pseudo-class</dfn> is <a href="http://www.w3.org/TR/CSS21/syndata.html#characters">ASCII case-insensitive</a>
480480
and has the same syntax as <a href="http://www.w3.org/TR/selectors/#pseudo-classes">pseudo-classes</a> in regular Selectors. [[!SELECT]]
481481
The various <a>page pseudo-classes</a> are defined below.
482482

@@ -827,16 +827,16 @@ millimeter margins and 14 point type in the page-margin boxes:
827827
<div class="example">
828828
Typically, a <dfn>page header</dfn> is located at the top of the page
829829
in documents with a predominately horizontal writing direction
830-
and on the side opposite the <a href="#binding-edge">binding edge</a>
830+
and on the side opposite the <a>binding edge</a>
831831
for documents with a predominately vertical writing direction.
832832
One possible design of page headers for horizontally written documents uses the
833833
''@top-left-corner'', ''@top-left'', ''@top-center'', ''@top-right'' and ''@top-right-corner''
834834
page-margin boxes.
835835
Another design, for vertically written documents, could use the
836836
''@right-top'', ''@right-middle'', and ''@right-bottom'' page-margin boxes
837-
for <a href="#right-page">right facing pages</a> and
837+
for <a title="right page">right facing pages</a> and
838838
''@left-top'', ''@left-middle'', and ''@left-bottom''
839-
for <a href="#left-page">left facing pages</a>.
839+
for <a title="left page">left facing pages</a>.
840840

841841
The <dfn>page footer</dfn> is typically at
842842
the opposite end of the page from the page header.
@@ -983,11 +983,11 @@ Authors should put these rules after any declarations in the page context
983983
as legacy clients may not handle declarations
984984
after margin at-rules correctly.
985985

986-
A <dfn id="margin-at-rule">margin at-rule</dfn> consists of an
986+
A <dfn id="margin-at-rule" title="@margin" at-rule>margin at-rule</dfn> consists of an
987987
<a href="#specializatons-of-ATKEYWORD">ATKEYWORD</a>
988988
that identifies the page-margin box
989989
(e.g. ''@top-left'') and a block of declarations (said
990-
to be in the <dfn id="margin-context">margin context</dfn>).
990+
to be in the <dfn export id="margin-context">margin context</dfn>).
991991

992992
<div class="example">
993993

@@ -1058,19 +1058,19 @@ then it must behave as if 'min-height' and 'min-width' were always zero.
10581058

10591059
<dt><dfn>available width</dfn>
10601060
<dd>The sum of the page’s
1061-
left border width, left padding, <a href="#page-box">page area</a> width,
1061+
left border width, left padding, <a title="page box">page area</a> width,
10621062
right padding, and right border width.
10631063
In other words, it is the distance between
1064-
the <a href="#page-box">page box</a>’s left right border edges.
1064+
the <a>page box</a>’s left right border edges.
10651065
This quantity is used when calculating dimensions
10661066
of the top and bottom page-margin boxes.
10671067

10681068
<dt><dfn>available height</dfn>
10691069
<dd>The sum of the page’s
1070-
top border width, top padding, <a href="#page-box">page area</a> height,
1070+
top border width, top padding, <a title="page box">page area</a> height,
10711071
bottom padding, and bottom border width.
10721072
In other words, it is the distance between
1073-
the <a href="#page-box">page box</a>’s top bottom border edges.
1073+
the <a>page box</a>’s top bottom border edges.
10741074
This quantity is used when calculating dimensions
10751075
of the left and right page-margin boxes.
10761076

@@ -1669,20 +1669,17 @@ Page Size</h2>
16691669
<h3 id="page-size-prop">
16701670
Page size: the 'size' property</h3>
16711671

1672-
<pre class=propdef>
1672+
<pre class=descdef>
16731673
Name: size
1674+
For: @page
16741675
Value: <<length>>{1,2} | auto | [ <<page-size>> || [ portrait | landscape ] ]
16751676
Initial: auto
1676-
Applies to: page context
1677-
Inherited: n/a
1678-
Percentages: n/a
1679-
Media: paged
16801677
Computed value: specified value, with <<length>>s made absolute.
16811678
</pre>
16821679

16831680
This property specifies the target size and orientation of the
16841681
<a>page box</a>’s containing block.
1685-
In the general case, where one page box is rendered onto one <a href="#page-sheet">page sheet</a>,
1682+
In the general case, where one page box is rendered onto one <a>page sheet</a>,
16861683
the 'size' property also indicates the size of the destination page sheet.
16871684

16881685
The size of a page box can either be "absolute" (fixed size) or "scalable"
@@ -1740,7 +1737,7 @@ Page size: the 'size' property</h3>
17401737
of the <code>size</code> property is <code>4in 6in</code>.
17411738
</div>
17421739

1743-
<dl dfn-type=value dfn-for=size>
1740+
<dl dfn-type=value dfn-for="@page/size">
17441741
<dt><dfn>auto</dfn>
17451742
<dd>
17461743
The page box will be set to a size and orientation chosen by the UA. In the
@@ -1877,22 +1874,20 @@ Media Queries</h4>
18771874
<h3 id="marks">
18781875
Crop and Registration Marks: the 'marks' property</h3>
18791876

1880-
<pre class='propdef'>
1877+
<pre class='descdef'>
18811878
Name: marks
1879+
For: @page
18821880
Value: none | [ crop || cross ]
18831881
Initial: none
1884-
Applies To: page context
1885-
Inherited: no
18861882
Computed Value: as specified
1887-
Media: paged
18881883
</pre>
18891884

18901885
This property adds crop and/or registration marks to the document.
18911886
These are printed outside the page box to facilitate
18921887
the trimming and alignment of sheets of paper.
18931888
Values have the following meanings:
18941889

1895-
<dl dfn-type=value dfn-for=marks>
1890+
<dl dfn-type=value dfn-for="@page/marks">
18961891
<dt><dfn>none</dfn>
18971892
Specifies that neither crop marks nor registration marks should be printed:
18981893
the area outside the <a>bleed area</a> will be completely blank.
@@ -1923,22 +1918,19 @@ Crop and Registration Marks: the 'marks' property</h3>
19231918
<h3 id="bleed">
19241919
Bleed Area: the 'bleed' property</h3>
19251920

1926-
<pre class='propdef'>
1921+
<pre class='descdef'>
19271922
Name: bleed
1923+
For: @page
19281924
Value: auto | <<length>>
19291925
Initial: auto
1930-
Applies To: page context
1931-
Inherited: no
1932-
Percentages: N/A
19331926
Computed Value: as specified
1934-
Media: paged
19351927
</pre>
19361928

19371929
This property specifies the extent of the <dfn>bleed area</dfn> outside the page box;
19381930
in other words the extent beyond the page box at which the page rendering is clipped.
19391931
Values have the following meanings:
19401932

1941-
<dl dfn-for=bleed dfn-type=value>
1933+
<dl dfn-for="@page/bleed" dfn-type=value>
19421934
<dt><dfn>auto</dfn>
19431935
<dd>
19441936
Computes to ''6pt'' if 'marks' has ''crop'' and to zero otherwise.

0 commit comments

Comments
 (0)