Skip to content

Commit 71e0180

Browse files
committed
[css-page-3][editorial] Fixed Bikeshed issues
1 parent 29d2771 commit 71e0180

File tree

1 file changed

+40
-35
lines changed

1 file changed

+40
-35
lines changed

css-page-3/Overview.bs

Lines changed: 40 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,9 @@ Abstract: This CSS module specifies how pages are generated and laid out to hold
2121
</pre>
2222

2323
<pre class=link-defaults>
24+
spec:css-borders-4; type:property;
25+
text:border-bottom-width
26+
text:border-top-width
2427
spec:css-break; type:property; text:break-after
2528
spec:css-values; type:value; text:ex
2629
spec:css2; type: property
@@ -263,7 +266,7 @@ Page Terminology</h2>
263266
to the page-margin boxes, but they do not apply to or inherit into the
264267
document's root element or other content.
265268

266-
The <a>containing block</a> of the page box is specified using the 'size'
269+
The <a>containing block</a> of the page box is specified using the '@page/size'
267270
property in the <a>page context</a>. The width and horizontal margins
268271
of the page box are then calculated exactly as for a
269272
<a href="https://www.w3.org/TR/CSS2/visudet.html#blockwidth">non-replaced block element in normal flow</a>. [[!CSS2]]
@@ -459,7 +462,7 @@ box:
459462
<h2 id="page-selector-and-context">
460463
Page Selectors and the Page Context</h2>
461464

462-
<h3 id="at-page-rule"><span id="page-box-page-rule"></spans>
465+
<h3 id="at-page-rule" oldids="page-box-page-rule">
463466
The @page Rule</h3>
464467

465468
Authors can specify various aspects of a page box,
@@ -694,8 +697,8 @@ The following are examples of page-margin boxes
694697
where the declaration blocks are intentionally left blank.
695698
<pre>
696699
@page {
697-
@top-left { ... /* document name */ }
698-
@bottom-center { ... /* page number */}
700+
@top-left { ... /* document name */ }
701+
@bottom-center { ... /* page number */}
699702
}
700703
@page :left { @left-middle { ... /* page number in left margin */ }}
701704
@page :right{ @right-middle { ... /* page number in right margins of right pages */}}
@@ -819,7 +822,7 @@ millimeter margins and 14 point type in the page-margin boxes:
819822
such as the page number or document title.
820823

821824
<div class="example">
822-
Typically, a <dfn>page header</dfn> is located at the top of the page
825+
Typically, a <dfn export>page header</dfn> is located at the top of the page
823826
in documents with a predominately horizontal writing direction
824827
and on the side opposite the <a>binding edge</a>
825828
for documents with a predominately vertical writing direction.
@@ -832,7 +835,7 @@ millimeter margins and 14 point type in the page-margin boxes:
832835
''@left-top'', ''@left-middle'', and ''@left-bottom''
833836
for <a lt="left page">left facing pages</a>.
834837

835-
The <dfn>page footer</dfn> is typically at
838+
The <dfn export>page footer</dfn> is typically at
836839
the opposite end of the page from the page header.
837840
For example, the design of a horizontally written document with a page header
838841
at the top of the page could use the
@@ -1048,9 +1051,8 @@ Page-Margin Box Layout Terminology</h4>
10481051
the following terms are defined for use
10491052
in the subsequent page-margin box calculations:
10501053

1051-
<dl>
1052-
1053-
<dt><dfn>available width</dfn>
1054+
<dl export>
1055+
<dt><dfn lt="available width|available page-margin width">available width</dfn>
10541056
<dd>The sum of the page’s
10551057
left border width, left padding, <a lt="page box">page area</a> width,
10561058
right padding, and right border width.
@@ -1059,7 +1061,7 @@ Page-Margin Box Layout Terminology</h4>
10591061
This quantity is used when calculating dimensions
10601062
of the top and bottom page-margin boxes.
10611063

1062-
<dt><dfn>available height</dfn>
1064+
<dt><dfn lt="available height|available page-margin height">available height</dfn>
10631065
<dd>The sum of the page’s
10641066
top border width, top padding, <a lt="page box">page area</a> height,
10651067
bottom padding, and bottom border width.
@@ -1068,22 +1070,22 @@ Page-Margin Box Layout Terminology</h4>
10681070
This quantity is used when calculating dimensions
10691071
of the left and right page-margin boxes.
10701072

1071-
<dt><dfn>outer width</dfn>
1073+
<dt><dfn lt="outer width|outer page-margin width">outer width</dfn>
10721074
<dd>The width of the <a>outer edge</a>, as defined in [[!CSS-BOX-3]].
10731075

1074-
<dt><dfn>min-content width</dfn>
1076+
<dt><dfn lt="min-content width|min-content page-margin width">min-content width</dfn>
10751077
<dd>Whichever of <a spec=css-sizing>min-content block size</a>
10761078
or <a spec=css-sizing>min-content inline size</a> is the physical width.
10771079

1078-
<dt><dfn>max-content width</dfn>
1080+
<dt><dfn lt="max-content width|max-content page-margin width">max-content width</dfn>
10791081
<dd>Whichever of <a spec=css-sizing>max-content block size</a>
10801082
or <a spec=css-sizing>max-content inline size</a> is the physical width.
10811083

1082-
<dt><dfn>outer min width</dfn>
1084+
<dt><dfn lt="outer min width|outer min page-margin width">outer min width</dfn>
10831085
<dd>Like the <a>outer width</a>,
10841086
except the <a>min-content width</a> is used when the computed 'width' is ''width/auto''.
10851087

1086-
<dt><dfn>outer max width</dfn>
1088+
<dt><dfn lt="outer max width|outer max page-margin width">outer max width</dfn>
10871089
<dd>Like the <a>outer width</a>,
10881090
except the <a>max-content width</a> is used when the computed 'width' is ''width/auto''.
10891091
</dl>
@@ -1393,7 +1395,7 @@ Page Properties</h2>
13931395
If a conforming user agent supports any of these properties on block boxes,
13941396
then it must also support that property
13951397
in the <a>page context</a>.
1396-
This specification additionally defines the 'size' property
1398+
This specification additionally defines the '@page/size' property
13971399
that only applies in the page context.
13981400

13991401
Properties that apply to the page-margin boxes can also be set
@@ -1653,13 +1655,13 @@ Page Size</h2>
16531655
sizes without having to write a specific style sheet for each paper size.
16541656

16551657
However, in some situations it is important that a certain page size achieves a
1656-
certain style. One way to achieve this goal is to utilize the 'size' property,
1658+
certain style. One way to achieve this goal is to utilize the '@page/size' property,
16571659
which indicates that the document should preferentially be displayed on a
16581660
surface of a certain size; another method is to use Media Queries [[MEDIAQ]]
16591661
which allow different style sheets to be applied to different page sizes.
16601662

16611663
<h3 id="page-size-prop">
1662-
Page size: the 'size' property</h3>
1664+
Page size: the '@page/size' property</h3>
16631665

16641666
<pre class=descdef>
16651667
Name: size
@@ -1672,7 +1674,7 @@ Page size: the 'size' property</h3>
16721674
This property specifies the target size and orientation of the
16731675
<a>page box</a>’s containing block.
16741676
In the general case, where one page box is rendered onto one <a>page sheet</a>,
1675-
the 'size' property also indicates the size of the destination page sheet.
1677+
the '@page/size' property also indicates the size of the destination page sheet.
16761678

16771679
The size of a page box can either be "absolute" (fixed size) or "scalable"
16781680
(i.e., fitting available sheet sizes).
@@ -1685,13 +1687,13 @@ Page size: the 'size' property</h3>
16851687
<a href="#renderingpages">transposing a page box to a different size</a>
16861688
apply.
16871689

1688-
If a 'size' property declaration is qualified by a ''width'',
1690+
If a '@page/size' property declaration is qualified by a ''width'',
16891691
''height'', ''device-width'', ''device-height'', ''aspect-ratio'',
16901692
''device-aspect-ratio'' or ''orientation''
16911693
media query [[!MEDIAQ]] (or other conditional on the size of the paper), then
16921694
the declaration must be
16931695
<a href="https://www.w3.org/TR/CSS2/conform.html#ignore">ignored</a>. Media
1694-
queries do not honor 'size': they assume the paper size that would be chosen
1696+
queries do not honor '@page/size': they assume the paper size that would be chosen
16951697
if no ''@page'' rules were specified.
16961698

16971699
<div class=issue>
@@ -1760,7 +1762,7 @@ Page size: the 'size' property</h3>
17601762
<dt><dfn type><<page-size>></dfn>
17611763
<dd>
17621764
A page size can be specified using one of the following media names. This is
1763-
the equivalent of specifying 'size'
1765+
the equivalent of specifying '@page/size'
17641766
using length values. The definition of the media names comes from
17651767
Media Standardized Names [[!PWGMSN]].
17661768

@@ -1870,7 +1872,7 @@ Media Queries</h4>
18701872
sheets are given a "1in" page margin.
18711873

18721874
<h4 id="page-orientation-prop">
1873-
Rotating The Printed Page: the 'page-orientation' property</h4>
1875+
Rotating The Printed Page: the '@page/page-orientation' property</h4>
18741876

18751877
<pre class=descdef>
18761878
Name: page-orientation
@@ -1893,7 +1895,7 @@ Rotating The Printed Page: the 'page-orientation' property</h4>
18931895
is a relatively complex task,
18941896
and is not yet solved in many popular printing implementations
18951897
(notably, web browsers).
1896-
The ''page-orientation'' descriptor is intended to help such implementations,
1898+
The '@page/page-orientation' descriptor is intended to help such implementations,
18971899
allowing them to lay out pages in a single consistent size,
18981900
but change the orientation post-layout
18991901
in the output medium
@@ -1950,7 +1952,7 @@ Rotating The Printed Page: the 'page-orientation' property</h4>
19501952

19511953

19521954
<h3 id="marks">
1953-
Crop and Registration Marks: the 'marks' property</h3>
1955+
Crop and Registration Marks: the '@page/marks' property</h3>
19541956

19551957
<pre class='descdef'>
19561958
Name: marks
@@ -1996,7 +1998,7 @@ Crop and Registration Marks: the 'marks' property</h3>
19961998
</div>
19971999

19982000
<h3 id="bleed">
1999-
Bleed Area: the 'bleed' property</h3>
2001+
Bleed Area: the '@page/bleed' property</h3>
20002002

20012003
<pre class='descdef'>
20022004
Name: bleed
@@ -2013,7 +2015,7 @@ Bleed Area: the 'bleed' property</h3>
20132015
<dl dfn-for="@page/bleed" dfn-type=value>
20142016
<dt><dfn>auto</dfn>
20152017
<dd>
2016-
Computes to ''6pt'' if 'marks' has ''crop'' and to zero otherwise.
2018+
Computes to ''6pt'' if '@page/marks' has ''crop'' and to zero otherwise.
20172019

20182020
<dt><dfn><<length>></dfn>
20192021
<dd>
@@ -2099,7 +2101,7 @@ Using named pages: 'page'</h3>
20992101
Animation type: discrete
21002102
</pre>
21012103

2102-
The 'page' property is used to specify a particular type of page (called a <dfn>named page</dfn>)
2104+
The 'page' property is used to specify a particular type of page (called a <dfn export>named page</dfn>)
21032105
on which an element must be displayed.
21042106
If necessary, a <a lt="forced break" spec=css-break>forced page break</a> is introduced
21052107
and a new page generated of the specified type.
@@ -2479,31 +2481,34 @@ Appendix B: Transfer Possibilities</h2>
24792481
sheet (e.g. double-sided printing);
24802482
<li>Transferring N (small) page boxes to one sheet (called "N-up");
24812483
<li>Transferring one (large) page box to N x M sheets (called "tiling");
2482-
<li>Creating signatures. A <dfn>signature</dfn> is a group of pages printed on
2484+
<li>Creating signatures. A <dfn export>signature</dfn> is a group of pages printed on
24832485
a sheet, which, when folded and trimmed like a book, appear in their proper
24842486
sequence;
24852487
<li>Printing one document to multiple output trays;
24862488
<li>Generating files containing print instructions.
24872489
</ul>
24882490

2489-
<h2 class="no-num" id="priv-sec">
2490-
Privacy and Security Considerations</h2>
2491+
<h2 class=no-num id=privacy>Privacy Considerations</h2>
2492+
2493+
No new privacy considerations have been reported on this specification.
2494+
2495+
<h2 class=no-num id=security>Security Considerations</h2>
24912496

2492-
This specification introduces no new privacy or security considerations.
2497+
No new security considerations have been reported on this specification.
24932498

24942499
<h2 class="no-num" id="changes">
24952500
Changes</h2>
24962501

24972502
Changes since the <a href="https://www.w3.org/TR/2018/WD-css-page-3-20181018/">18 October 2018 Working Draft</a> are:
24982503
<ul>
2499-
<li>Added 'page-orientation' descriptor.
2504+
<li>Added '@page/page-orientation' descriptor.
25002505
</ul>
25012506

25022507
Changes since the <a href="https://www.w3.org/TR/2013/WD-css3-page-20130314/">14 March 2013 Working Draft</a> are:
25032508

25042509
<ul>
2505-
<li>Imported the 'marks' and 'bleed' properties from [[CSS3GCPM]].
2506-
<li>Added ''bleed/auto'' as the initial value of 'bleed' and allowed it to apply even when 'marks' is ''marks/none''.
2510+
<li>Imported the '@page/marks' and '@page/bleed' properties from [[CSS3GCPM]].
2511+
<li>Added ''@page/bleed/auto'' as the initial value of '@page/bleed' and allowed it to apply even when '@page/marks' is ''@page/marks/none''.
25072512
<li>Added JIS-B4 and JIS-B5.
25082513
</ul>
25092514

0 commit comments

Comments
 (0)