Skip to content

Commit 59cb0f1

Browse files
fantasaifantasai
committed
give terminology its own section
1 parent c5dcac0 commit 59cb0f1

2 files changed

Lines changed: 57 additions & 54 deletions

File tree

‎css3-page/Overview.html‎

Lines changed: 30 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -457,16 +457,6 @@ <h2 id=page-terms><span class=secno>3. </span>Page Terminology</h2>
457457
a page sheet</a> and <a href="#content-outside-box">Content outside the
458458
page box</a>.
459459

460-
<dt id=content-empty>Content-empty page
461-
462-
<dd>a page box whose page area contains no printable content other than
463-
backgrounds and/or borders. A page box whose page area contains
464-
generated content, or content whose visibility is &lsquo;<span
465-
class=property>hidden</span>&rsquo;, or invisible content such as a
466-
zero-width space is not a content-empty page. On the other hand, a page
467-
containing only a background and/or borders and/or margin-box content
468-
<em>is</em> a content-empty page.
469-
470460
<dt id=page-orientation>Page Orientation
471461

472462
<dd>The page orientation is defined by comparing the length of the edges
@@ -605,21 +595,32 @@ <h3 id=content-outside-box><span class=secno>4.1 </span>Content outside
605595
outside the page box:</p>
606596

607597
<ul>
608-
<li>User agents <em class=RFC2119>SHOULD</em> avoid generating a large
609-
number of <a href="#content-empty">content-empty pages</a> to honor the
610-
positioning of elements (e.g., printing 100 blank pages is probably
611-
neither the author's nor the user's intent). Note, however, that
612-
generating a small number of empty page boxes is sometimes necessary to
613-
honor the <span class=css>&lsquo;<span
614-
class=property>left</span>&rsquo;</span> and <span
615-
class=css>&lsquo;<span class=property>right</span>&rsquo;</span> values
616-
for <span class=property>&lsquo;<a class=property
617-
href="#page-break-before">page-break-before</a>&rsquo;</span> and <span
618-
class=property>&lsquo;<a class=property
619-
href="#page-break-after">page-break-after</a>&rsquo;</span>.
598+
<li>
599+
<p>User agents <em class=RFC2119>SHOULD</em> avoid generating a large
600+
number of content-empty pages to honor the positioning of elements
601+
(e.g., printing 100 blank pages is probably neither the author's nor
602+
the user's intent). A <dfn id=content-empty>Content-empty page</dfn> is
603+
a page box whose page area contains no printable content other than
604+
backgrounds and/or borders. A page box whose page area contains
605+
generated content, or content whose visibility is &lsquo;<span
606+
class=property>hidden</span>&rsquo;, or invisible content such as a
607+
zero-width space is not a content-empty page. On the other hand, a page
608+
containing only a background and/or borders and/or margin-box content
609+
<em>is</em> a content-empty page.</p>
610+
611+
<p class=note>Note, however, that generating a small number of empty
612+
page boxes is sometimes necessary to honor the <span
613+
class=css>&lsquo;<span class=property>left</span>&rsquo;</span> and
614+
<span class=css>&lsquo;<span class=property>right</span>&rsquo;</span>
615+
values for <span class=property>&lsquo;<a class=property
616+
href="#page-break-before">page-break-before</a>&rsquo;</span> and <span
617+
class=property>&lsquo;<a class=property
618+
href="#page-break-after">page-break-after</a>&rsquo;</span>.</p>
619+
620+
<li>
621+
<p>Authors <em class=RFC2119>SHOULD NOT</em> position elements in
622+
inconvenient locations just to avoid rendering them. Instead:</p>
620623

621-
<li>Authors <em class=RFC2119>SHOULD NOT</em> position elements in
622-
inconvenient locations just to avoid rendering them. Instead:
623624
<ul>
624625
<li>To suppress box generation entirely, set the <span
625626
class=property>&lsquo;<span
@@ -630,11 +631,12 @@ <h3 id=content-outside-box><span class=secno>4.1 </span>Content outside
630631
class=property>visibility</span>&rsquo;</span> property.
631632
</ul>
632633

633-
<li>This specification does not define how boxes positioned outside the
634-
page box are handled. Possibilities include discarding them or creating
635-
page boxes for them at the end of the document.
634+
<li>
635+
<p>This specification does not define how boxes positioned outside the
636+
page box are handled. Possibilities include discarding them or creating
637+
page boxes for them at the end of the document.</p>
636638
</ul>
637-
<!-- "Margin boxes" -->
639+
638640
<h3 id=painting><span class=secno>4.2 </span>Page Backgrounds and Painting
639641
Order</h3>
640642

‎css3-page/Overview.src.html‎

Lines changed: 27 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -218,14 +218,6 @@ <h2 id="page-terms">Page Terminology</h2>
218218
device dependent within the constraints expressed in the sections <a href="#renderingpages">Rendering page boxes that do not fit a page sheet</a> and
219219
<a href="#content-outside-box">Content outside the page box</a>.</dd>
220220

221-
<dt id="content-empty">Content-empty page</dt>
222-
<dd>a page box whose page area contains no printable content other than
223-
backgrounds and/or borders. A page box whose page area contains generated
224-
content, or content whose visibility is 'hidden', or invisible content such as
225-
a zero-width space is not a content-empty page. On the other hand, a page
226-
containing only a background and/or borders and/or margin-box content
227-
<em>is</em> a content-empty page.</dd>
228-
229221
<dt id="page-orientation">Page Orientation</dt>
230222
<dd>The page orientation is defined by comparing the length of the edges of a
231223
<a href="#page-box">page box</a>. The page box is a rectangle with two
@@ -333,24 +325,33 @@ <h3 id="content-outside-box">Content outside the page box</h3>
333325
box:</p>
334326

335327
<ul>
336-
<li>User agents <em class="RFC2119">SHOULD</em> avoid generating a large number
337-
of <a href="#content-empty">content-empty pages</a> to honor the positioning of
338-
elements (e.g., printing 100 blank pages is probably neither the author's nor
339-
the user's intent). Note, however, that generating a small number of empty page
340-
boxes is sometimes necessary to honor the <span class="css">'left'</span> and
341-
<span class="css">'right'</span> values for <span class="property">'page-break-before'</span> and <span class="property">'page-break-after'</span>.</li>
342-
<li>Authors <em class="RFC2119">SHOULD NOT</em> position elements in
343-
inconvenient locations just to avoid rendering them. Instead:
344-
345-
<ul>
346-
<li>To suppress box generation entirely, set the <span class="property">'display'</span> property to <span class="css">'none'</span>.</li>
347-
<li>To make a box invisible, set the <span class="property">'visibility'</span>
348-
property.</li>
349-
</ul></li>
350-
<li>This specification does not define how boxes positioned outside the page
351-
box are handled. Possibilities include discarding them or creating page boxes
352-
for them at the end of the document.</li>
353-
</ul><!-- "Margin boxes" -->
328+
<li><p>User agents <em class="RFC2119">SHOULD</em> avoid generating a large
329+
number of content-empty pages to honor the positioning of elements (e.g.,
330+
printing 100 blank pages is probably neither the author's nor the user's
331+
intent).
332+
A <dfn id="content-empty">Content-empty page</dfn> is a page box whose page
333+
area contains no printable content other than backgrounds and/or borders. A
334+
page box whose page area contains generated content, or content whose
335+
visibility is 'hidden', or invisible content such as a zero-width space is
336+
not a content-empty page. On the other hand, a page containing only a
337+
background and/or borders and/or margin-box content <em>is</em> a
338+
content-empty page.
339+
<p class="note">Note, however, that generating a small number of empty page
340+
boxes is sometimes necessary to honor the <span class="css">'left'</span> and
341+
<span class="css">'right'</span> values for <span class="property">'page-break-before'</span>
342+
and <span class="property">'page-break-after'</span>.</li>
343+
344+
<li><p>Authors <em class="RFC2119">SHOULD NOT</em> position elements in
345+
inconvenient locations just to avoid rendering them. Instead:
346+
<ul>
347+
<li>To suppress box generation entirely, set the <span class="property">'display'</span> property to <span class="css">'none'</span>.</li>
348+
<li>To make a box invisible, set the <span class="property">'visibility'</span>
349+
property.</li>
350+
</ul></li>
351+
<li><p>This specification does not define how boxes positioned outside the page
352+
box are handled. Possibilities include discarding them or creating page boxes
353+
for them at the end of the document.</li>
354+
</ul>
354355

355356
<h3 id="painting">Page Backgrounds and Painting Order</h3>
356357

0 commit comments

Comments
 (0)