ページ化媒体 — CSS Paged Media Module Level 3

1.1. 値~定義

【 この節の内容は `~CSS日本語訳 共通~page＠~CSScommon#values$に移譲。 】

3.2. ~page~boxの外側に来る内容

~page~modelにおいて内容を整形するとき、 内容の一部が`~page~box$の外側に出ることもある。 例えば， `white-space$p ~propが `pre^v にされた要素は、 `~page~box$より幅広な~boxを生成し得る。 別の例として、 ~boxが［ 絶対的／相対的 ］に位置されるとき， “不都合な” 所在にもなり得る。 例えば，画像は、 `~page~box$の辺をまたぐように, あるいは 100000 ~meter下に置かれるかもしれない。 ◎ When formatting content in the page model, some content may end up outside the page box. For example, an element whose white-space property has the value pre can generate a box that is wider than the page box. As another example, when boxes are positioned absolutely or relatively, they may end up in "inconvenient" locations. For example, images may be placed on the edge of the page box or 100,000 meters below the page box.

そのような要素を正確に整形するための仕様は、 この文書の視野から外れる。 しかしながら，［ 作者／~UA ］には、 次に挙げる［ `~page~box$の外側に出ると懸念される内容に対する，一般~原則 ］を順守することが推奨される： ◎ A specification for the exact formatting of such elements lies outside the scope of this document. However, it is recommended that authors and user agents observe the following general principles concerning content outside the page box:

• ~UAは、 ~pageを “裁切れる” よう，［ `~page~box$を少しばかり超える内容 ］も許容するべきである。 ◎ Content should be allowed slightly beyond the page box to allow pages to "bleed".

• ~UAは、［ 要素の位置決めを尊守するために多数の`無内容な~page$を生成すること ］を避けるベキである （例：作者や利用者は、 おそらく 100 ~pageもの白紙を印刷しようとは意図しないであろう）。 `無内容な~page@ とは、 `~page~box$のうち［ その`~page区画$が，背景や~borderの他に印刷-可能な内容を包含しない ］ものをいう — すなわち，`~page区画$が： ◎ User agents SHOULD avoid generating a large number of content-empty pages to honor the positioning of elements (e.g., printing 100 blank pages is probably neither the author’s nor the user’s intent). A Content-empty page is a page box whose page area contains no printable content other than backgrounds and/or borders.＼

  • 次に挙げるものを包含する場合、 `無内容な~page$にはならない ⇒＃ `生成d内容$／ `visibility$p が `hidden^v にされた内容／ `zero-width space^en などの不可視な内容【おそらく，幅ゼロの~space文字（ U+200B ） — 幅ゼロの “~~空間” ではなく】 ◎ A page box whose page area contains generated content, or content whose visibility is hidden, or invisible content such as a zero-width space is not a content-empty page.＼
  • 他方，次に挙げるもの以外は包含しない場合、 `無内容な~page$に`なる^em ⇒＃ 背景／ ~border／ `~page-margin~box$の内容 ◎ On the other hand, a page containing only a background and/or borders and/or page-margin box content is a content-empty page.

  注記： しかしながら、［ `page-break-before$p ／ `break-before$p ］や［ `page-break-after$p ／ `break-after$p ］用の強制d分断~値を尊守するために，少数の空な`~page~box$を生成することが必要yなこともある。 `CSS2$r `CSS-BREAK-3$r ◎ Note, however, that generating a small number of empty page boxes is sometimes necessary to honor the forced-break values for page-break-before/break-before and page-break-after/break-after. [CSS2] [CSS-BREAK-3]

• 作者は、 描画を避けるためだけに，要素を不都合な所在に位置するベキでない。 代わりに，次のいずれかを行うべきである： ◎ Authors SHOULD NOT position elements in inconvenient locations just to avoid rendering them. Instead:

  • `display$p ~propを `none^v に設定して，~box生成をまるごと抑止する。 ◎ To suppress box generation entirely, set the display property to none.
  • `visibility$p を~propを設定して，~boxを不可視にする。 ◎ To make a box invisible, set the visibility property.
• この仕様は、［ `~page~box$の外側に位置された~boxを，どう取扱うか ］については定義しない。 ［ それらを破棄する／ それら用の`~page~box$を文書の末端に作成する ］なども，あり得る。 ◎ This specification does not define how boxes positioned outside the page box are handled. Possibilities include discarding them or creating page boxes for them at the end of the document.

3.3. ~page進行

~CSSでは、 すべての文書において，左pageと右pageとが判別される — 両面印刷されるかどうかを問わず。 左pageと右pageは【~page進行の順で】交互に来る。 左右の~pageには、［ `left$ps, `right$ps ］疑似類で異なる~styleをあてがえる。 ◎ CSS distinguishes between left pages and right pages on all documents, whether they are printed duplex or not. Each left page is followed by a right page and vice versa. Left and right pages can be styled differently with the :left and :right pseudo-classes.

文書の最初の~pageが［ 左page, 右page ］どちらになるかは、 文書の`~page進行$に依存する。 `~page進行@ とは、 文書の印刷される~pageが横並びに~lay-outされるとき並べられていく方向である。 例えば、［ 英語／横組みの日本語 ］~pageでは，概して右向きへ進行する一方で、 ［ ~Arabic／縦組みの日本語 ］~pageでは，概して左向きへ進行する。 ◎ Whether the first page of a document is a left page or a right page depends on the page progression of the document. The page progression is the direction in which the printed pages of a document would be sequenced when laid out side-to-side. For example, English and horizontally-set Japanese typically progress from left to right, whereas Arabic and vertically-set Japanese pages typically progress from right to left.

`~page進行$~方向は、 次に従って決定される： ◎ The page progression direction is determined as follows:

• ~textが横書き行lに~lay-outされる場合 ⇒ `行内~基底~方向$と同じ。 ◎ If text is laid out in horizontal lines, the page progression is the same as the inline base direction.
• ~textが縦書き行lに~lay-outされる場合 ⇒ `塊~flow方向$と同じ。 ◎ If text is laid out in vertical lines, the page progression is the same as the block flow direction.

［ `direction$p, `writing-mode$p ］~prop `CSS-WRITING-MODES-3$r を~supportする~UAは、 `~page進行$を`首要な書字~mode$から決定するモノトスル。 ◎ If the UA supports the direction and writing-mode properties from the CSS 3 Writing Modes Module [CSS-WRITING-MODES-3], it must determine the page progression is determined by the principal writing mode.

文書の最初の~pageは、 `~page進行$に応じて［ 右向きならば右page／左向きならば左page ］になる。 作者は、 `break-before$p `CSS-BREAK-3$r に［ 根まで`伝播-＠~CSSBREAK#propagate$する~page分断~値 ］を指定することにより， 文書の印刷ngを［ 左pageまたは右page ］から始めるよう明示的に強制できる。 この事例では，~UAは、 （空になる）最初の~page（たち） （および，最初に印刷される~pageに合致する `first$ps 疑似類） を抑止するモノトスル。 ◎ In documents with a left-to-right page progression the first page of the document is a right page, and vice versa. To explicitly force a document to begin printing on a left or right page, authors can specify a break-before value that that propagates a page break to the root. [CSS-BREAK-3] The UA must suppress the first (empty) page(s) in this case (and the :first pseudo-class matches the first printed page).

html { break-before: always }

html { break-before: left }

4.1. `page^at 規則

`選択子~list$を伴わない `page$at 規則は、 どの~pageにも適用される。 選択子~listを伴う `page$at 規則は、 ~list内のいずれかの選択子に`合致する$~pageに適用される。 `~page文脈$の中で宣言された~propは、 【当の~at-規則が適用される~pageの】`~page~box$に適用される。 ◎ @page rules without a selector list apply to every page. Other @page rules apply to pages that match at least one of their selectors. Properties declared within the page context apply to the page box.

［ `~page文脈$／`~margin文脈$ ］の中で，`宣言~block$の処理~時に~errorに遭遇した場合、 `構文解析-時の~error取扱い規則＠~CSSSYN#error-handling$が適用される 【！~CSS22/syndata.html#parsing-errors】 — すなわち、 ~blockの中の妥当な宣言は，適用される。 ◎ If an error is encountered during the processing of a declaration block within a page or a margin context, the Rules for handling parsing errors apply; that is, valid declarations within the block are applied.

4.2. ~page選択子

`~page選択子@ （ `page-selector$t ）は、 順に， 1 個の［ `~page種別~選択子$／`~page疑似類$ ］, 0 個以上の［ 追加的な`~page疑似類$ ］からなる。 選択子の各~成分の合間には、 空白は許容されない。 `page-selector$t の文法とその例は、 以下に見出せる。 ◎ A page selector is made of either a page type selector or a page pseudo-class, followed by zero or more additional page pseudo-classes. No whitespace is allowed between components of a selector. The <page-selector> grammar and examples can be found below.

`~page選択子$は、 すべての成分が所与の~pageに合致するとき，そのときに限り， 当の~pageに `合致する@ とされる。 ◎ A page selector is said to match a given page if and only if all of its components match the page.

`~page種別~選択子@ は、 `~CSS識別子$であり，文字大小区別でもある。 【 この識別子（ `page-selector$t を成す `ident-token$t ）は、 `~page種別~名@ とも称される。 】 それは、［ `page$p ~propにより生成される`名前を伴う~page＠#using-named-pages$に`合致する$。 ~page種別~名 `auto^v （`~ASCII大小無視$）は、 規則を無効にはしないが，どの~pageにも合致しないモノトスル。 ◎ A page type selector is a case-sensitive CSS identifier [CSS2]. It matches pages of the named page type generated by the page property. A page type name of auto (ASCII case-insensitive) does not make the rule invalid, but must never match.

`~page疑似類@ （ `pseudo-page$t ）は、 `~ASCII大小無視$であり， その構文は定例の選択子における`疑似類$ `SELECT$r と同じである。 以下に，種々の`~page疑似類$が定義される。 ◎ A page pseudo-class is ASCII case-insensitive and has the same syntax as pseudo-classes in regular Selectors. [SELECT] The various page pseudo-classes are defined below.

4.2.1. 見開き疑似類： `left^ps, `right^ps

両面~文書を印刷するとき，［ `左page$, `右page$ ］の整形は異なることが多い。 これは、［ `left$ps, `right$ps ］~page疑似類を利用して表出できる。 ◎ When printing double-sided documents, left and right pages are often formatted differently. This can be expressed by using the :left and :right page pseudo-classes.

すべての~pageは、 `~page進行$に基づいて，~UAにより自動的に［ `左page$, `右page$ ］どちらかに分類される。 ［ `left@ps 疑似類は`左page$のみ／ `right@ps 疑似類は`右page$のみ ］に`合致する$。 ◎ All pages are automatically classified by user agents as either left pages or right pages, based on page progression. The :left and :right pseudo-classes only match left or right pages, respectively.

【 参考： `~page進行$に相対的に合致する `recto$ps, `verso$ps 疑似類もある。 】

@page :left {
  margin-left: 3cm;
  margin-right: 4cm;
}

@page :right {
  margin-left: 4cm;
  margin-right: 3cm;
}

［ `左page$, `右page$ ］用に異なる宣言が与えられた場合、 ~UAは，［ 各`~page~box$を左右の用紙へ転送しないときでも，これらの宣言を尊守する ］モノトスル （すなわち、 媒体の片~側にしか印刷しないときでも， 整形された出力を正しく生産するモノトスル）。 ◎ If different declarations have been given for left and right pages, the user agent must honor these declarations even if the user agent does not transfer the page boxes to left and right sheets (i.e., a printer that only prints on one side of the medium must nevertheless produce correctly formatted output).

注記： ［ `left$ps ／ `right$ps ］疑似類における宣言の有無を［ 文書を［ 両面, 片面 ］どちらに印刷するかに波及させる ］ことは必要yでない （それは、 この仕様の視野から外れる）。 ◎ Note. Adding declarations to the :left or :right pseudo-class does not necessarily influence whether the document comes out of the printer double- or single-sided (which is outside the scope of this specification).

4.2.2. 最初の~page疑似類： `first^ps

`first@ps 疑似類は、 文書の最初に印刷される~pageに`合致する$。 ◎ The :first pseudo-class matches the first printed page of a document.

@page {
  margin: 2cm; /*
    すべての~marginは 2cm に設定される */
}

@page :first {
  margin-top: 10cm; /*
    最初の~pageだけ上端~marginを 10cm にする */
}

4.2.3. 白紙~page疑似類： `blank^ps

`blank@ps 疑似類は、 `強制d~page分断$の結果として現れる`無内容な~page$たちに`合致する$。 ◎ The :blank pseudo-class matches content-empty pages that appear as a result of forced page breaks.

注記： `blank$ps に合致する~pageを生成させ得るものは、［ `break-before$p ／ `break-after$p ］~propに対する値［ `left^v, `right^v, `recto^v, `verso^v ］に限られる。 ◎ Only the left, right, recto and verso values of the break-before and break-after properties can generate pages that match :blank.

h1 {
  break-before: left;
}

@page :blank {
  @top-center {
    content: "This page is intentionally left blank";
    content: "この~pageは意図的に白紙にされている";
  }
}

`blank$ps に合致した~pageは、 他の~page疑似類にも合致し得る。 ◎ A page matched by :blank can also be matched by other page pseudo-classes.

h1 { break-before: left }

@page :blank {
  @top-center {
    content: none
  }
}

@page :right {
  @top-center {
    content: "Preliminary edition"; /* (1) */
  }
  @bottom-center {
    content: counter(page); /* (2) */
  }
}

注記： ~CSSの将来~versionでは、 ~~新たな~page疑似類も~~追加され得る。 ◎ Note. Future versions of CSS may include other page pseudo-classes.

4.3. `page^at 規則の文法

`page$at 規則は、 次の文法, および下に注記される追加的な規則に則って，`構文解析-$される： ◎ @page rules are parsed according to the following grammar, plus the additional rules noted below:

@page
	= @page `page-selector-list$t? { `declaration-rule-list$t }
`page-selector-list@t
	= `page-selector$t#
`page-selector@t
	= [ `ident-token$t? `pseudo-page$t* ]!
`pseudo-page@t
	= : [ left | right | first | blank ]

/* 
~margin規則
◎
Margin rules
 */
`top-left-corner@at
	= @top-left-corner { `declaration-list$t };
`top-left@at
	= @top-left { `declaration-list$t };
`top-center@at
	= @top-center { `declaration-list$t };
`top-right@at
	= @top-right { `declaration-list$t };
`top-right-corner@at
	= @top-right-corner { `declaration-list$t };
`bottom-left-corner@at
	= @bottom-left-corner { `declaration-list$t };
`bottom-left@at
	= @bottom-left { `declaration-list$t };
`bottom-center@at
	= @bottom-center { `declaration-list$t };
`bottom-right@at
	= @bottom-right { `declaration-list$t };
`bottom-right-corner@at
	= @bottom-right-corner { `declaration-list$t };
`left-top@at
	= @left-top { `declaration-list$t };
`left-middle@at
	= @left-middle { `declaration-list$t };
`left-bottom@at
	= @left-bottom { `declaration-list$t };
`right-top@at
	= @right-top { `declaration-list$t };
`right-middle@at
	= @right-middle { `declaration-list$t };
`right-bottom@at
	= @right-bottom { `declaration-list$t };

加えて，次の規則が適用される： ◎ In addition, the following rules apply:

• ［ `page-selector$t ／ `pseudo-page$t ］内の各 生成規則の合間には、 空白は許容されない （ `compound-selector$t 用の規則と類似に）。 ◎ No whitespace is allowed between the productions in <page-selector> or <pseudo-page> (similar to the rule for <compound-selector>).
• `page$at 規則が包含できるのは、［ `~page~prop$, `~margin~at-規則$ ］に限られる。 ◎ The @page rule can only contain page properties and margin at-rules.
• `~margin~at-規則$が包含できるのは、 `~page-margin~prop$に限られる。 ◎ The margin at-rules can only contain page-margin properties.

@page { ... }
@page :left { ... }
@page :right { ... }
@page LandscapeTable { ... }
@page CompanyLetterHead:first { ... } /* 識別子と疑似類。 */
@page:first { ... }
@page toc, index { ... }
@page :blank:first { ... }

@page {
  @top-left {
    ... /* 文書~名 */
  }
  @bottom-center {
    ... /* ~page番号 */
  }
}
@page :left {
  @left-middle {
    ... /* 左端~margin内の~page番号 */ 
  }
}
@page :right{
  @right-middle {
    ... /* 右pageの右端~margin内の~page番号 */
  }
}

@page :left {
  @bottom-left-corner {
    ... /* 左pageの番号 */ 
  }
}
@page :right {
  @bottom-right-corner {
    ... /* 右pageの番号 */ 
  }
}
@page :first {
  @bottom-left-corner {
    ... /* 最初の~pageの空【？】~footer */ 
  }
@bottom-right-corner {
    ... /* 空【？】~footer */ 
  }
}

4.4. ~page文脈における~cascade法

［ `~page文脈$／`~margin文脈$ ］内の宣言は、 要素~用の~style規則~内の宣言とちょうど同じく`~cascade$する。 ◎ Declarations in page and margin contexts cascade just like declarations in style rule for elements.

~page選択子の `詳細度@ は、 `SELECT$r にて定義される`詳細度＠~SELECTORS4#specificity$に相似的な方式で算出される： ◎ The specificity of a page selector is computed in a manner analogous to the computations defined in the Selectors module:

まず，次に挙げるものの個数を数える： ◎ ↓

• %f ~EQ `~page種別~名$の個数 ◎ Count the number of page type names (= f)

  注記： ~page選択子の構文の下では、 %f は 0 か 1 しかとり得ない。 ◎ Given the syntax of page selectors, f can only ever be 0 or 1.

• %g ~EQ ［ `first$ps, `blank$ps ］疑似類の合計個数 ◎ Count the number of ':first' or ':blank' pseudo-classes (= g)
• %h ~EQ ［ `left$ps, `right$ps ］疑似類の合計個数 ◎ Count the number of ':left' or ':right' pseudo-classes (= h)

注記： 同じ疑似類の繰返しも許容され，詳細度を増やす。 ◎ Note: Repeated occurrences of the same pseudo-classes are allowed and do increase specificity.

実装は、 ~storage制限に応じて %f, %g, %h の~sizeに制限を設けてもヨイ。 その場合、 上限を超えた値は，その上限までに切詰めるモノトスル。 ◎ Due to storage limitations, implementations may have limitations on the size of f, g, or h. If so, values higher than the limit must be clamped to that limit, and not overflow.

詳細度は、 3 成分（ %f, %g, %h ）を順に比較することにより比較される ⇒＃ %f が大きいものほど詳細度が高く， %f が同じ場合は %g が大きいものほど詳細度が高く， %g も同じ場合は %h が大きいものほど詳細度が高く， %h も同じ場合は 詳細度は等しいとする。 ◎ Specificities are compared by comparing the three components in order (f, g, h): the specificity with a larger f value is more specific; if the two f values are tied, then the two g values are compared, etc. If all the values are tied, the two specificities are equal.

@page { }             /* 詳細度 ~EQ (0,0,0) */
@page :left { }       /* 詳細度 ~EQ (0,0,1) */
@page :first { }      /* 詳細度 ~EQ (0,1,0) */
@page :blank:left { } /* 詳細度 ~EQ (0,1,1) */
@page artsy { }       /* 詳細度 ~EQ (1,0,0) */
@page artsy:left { }  /* 詳細度 ~EQ (1,0,1) */
@page artsy:first { } /* 詳細度 ~EQ (1,1,0) */

@page :left {
  margin-left: 4cm;
}

@page {
  margin-left: 3cm;
}

@page :first {
  color: green;

  @top-left {
    content: "foo";
    color: blue;
  }
  @top-right {
    content: "bar";
  }
}

@page {
  color: red;

  @top-center {
    content: "Page " counter(page);
  }
}

@page { margin: 25mm;}
@page { font-size: 14pt;}

5.1. ~page-margin~box用の~at-規則

`~page-margin~box$は、 `~page文脈$の内側にて，`~margin~at-規則$により作成される。 作者は、 これらの規則を~page文脈~内のどの宣言よりも後に~~置くべきである — 旧来の~UA【！client】は、 ~margin~at-規則の後に来る宣言を正しく取扱えないかもしれないので。 ◎ Page-margin boxes are created by margin at-rules inside the page context. Authors should put these rules after any declarations in the page context as legacy clients may not handle declarations after margin at-rules correctly.

`~margin~at-規則@ は、 順に［ `~page-margin~box$を識別する`~at-規則$（例 `top-left$at ）, 記述子たちが成す~block ］からなる。 ~blockの内側は `~margin文脈@ 内にあると称される。 ◎ A margin at-rule is an at-rule that identifies the page-margin box (e.g. @top-left) and a block of descriptors (said to be in the margin context).

@page {
  size: 8.5in 11in;
  margin: 10%;

  @top-left {
    content: "Hamlet";
  }
  @top-right {
    content: "Page " counter(page);
  }
}

5.2. ~page-margin~boxの拡充-法

［ `before$pe ／ `after$pe ］疑似要素のときと同じく、 `~page-margin~box$の `content$p ~propに指定された値 `normal^v は， `none^v に算出される。 【と記されているが、 `content$p の記述と食い違っている。】 `~page-margin~box$は、 その `content$p ~propの算出d値が `none$v でないとき, そのときに限り `生成され@ る。 他の場合、 `display$p が `none^v にされた要素と同じく，~boxは生成されない。 ◎ As with the :before and :after pseudo-elements, a specified content: normal on a page-margin box computes to none. A page-margin box is generated if and only if the computed value of its content property is not none. Otherwise, no box is generated, as for elements with display: none.

注記： `display$p ~propは、 `~page-margin~box$には適用されない。 ◎ The display property does not apply to page-margin boxes.

@page {
  @top-left-corner {
    content: " ";
    border: solid green;
  }
  @top-right-corner {
    content: url(/sitelet?url=https%3A%2F%2Ftriple-underscore.github.io%2Ffoo.png);
    border: solid green;
  }
  @bottom-right-corner {
    content: counter(page);
    border: solid green;
  }
  @bottom-left-corner {
    content: normal;
    border: solid green;
  }
}

5.3. ~page-margin~boxの寸法の算出-法

`~page-margin~box$の横幅, 縦幅は、 下の規則により決定される。 これらの規則は、 `~page-margin~box$に対し， `CSS2$r の `§ 横幅と~marginの計算-法＠~CSS2J#Computing_widths_and_margins$, `§ 縦幅と~marginの計算-法＠~CSS2J#Computing_heights_and_margins$ に等価なものを定義する。 ◎ The width and height of each page-margin box is determined by the rules below. These rules define the equivalent of CSS2.1 Sections 10.3 and 10.6 for page-margin boxes.

［ `min-height$p, `max-height$p, `min-width$p, `max-width$p ］ `CSS2$r 用に適用される規則は， `~page-margin~box$にも適用され、 指定された［ `width$p ／ `height$p ］による結果の寸法が それらの拘束に觝触する場合、［ 横幅, 縦幅, ~margin ］のうち，いくつかは計算し直される。 ［ `min-height$p ／ `min-width$p ］~propを~supportしない~UAは、 その値が常に `0^v であるかのように挙動するモノトスル。 ◎ The rules for applying min-height, max-height, min-width, and max-width [CSS2] do apply to page-margin boxes and may imply a recalculation of the width, height, and/or margins if the dimensions resulting from the specified width or height violate their constraints. If the UA does not support the min-height or min-width properties then it must behave as if min-height and min-width were always zero.

5.3.1. ~page-margin ~box~layoutの各種用語

`CSS2$r による~box~modelの定義と `CSS-SIZING-3$r による内在的~sizingの用語に加えて、 以下に挙げる用語が定義され，後続な`~page-margin~box$の計算に利用される： ◎ In addition to the box model definitions in CSS2.1 [CSS2], and the sizing terms in CSS Sizing [CSS-SIZING-3], the following terms are defined for use in the subsequent page-margin box calculations:

`可用な横幅@ ◎ available width

~pageの［ 左端~border線幅, 左端~padding, `~page区画$の横幅, 右端~padding, 右端~border線幅 ］の総和。 言い換えれば，`~page~box$の左右~border辺の距離。 ◎ The sum of the page’s left border width, left padding, page area width, right padding, and right border width. In other words, it is the distance between the page box’s left right border edges.＼

この数量は、 上下端の`~page-margin~box$の寸法を計算するときに利用される。 ◎ This quantity is used when calculating dimensions of the top and bottom page-margin boxes.

`可用な縦幅@ ◎ available height

~pageの［ 上端~border線幅, 上端~padding, `~page区画$の縦幅, 下端~padding, 下端~border線幅 ］の総和。 言い換えれば，`~page~box$の上下~border辺の距離。 ◎ The sum of the page’s top border width, top padding, page area height, bottom padding, and bottom border width. In other words, it is the distance between the page box’s top bottom border edges.＼

この数量は、 左右端の`~page-margin~box$の寸法を計算するときに利用される。 ◎ This quantity is used when calculating dimensions of the left and right page-margin boxes.

`外縁~横幅@ ◎ outer width

`外縁~辺$の横幅。 `CSS-BOX-3$r ◎ The width of the outer edge, as defined in [CSS-BOX-3].

`最小-内容 横幅@ ◎ min-content width

物理-横幅の方の`最小-内容~size$。 【物理-〜 — すなわち，~pageの方位に相対的な（縦置きならば短辺（とされる方）の横幅）】 ◎ Whichever of min-content block size or min-content inline size is the physical width.

`最大-内容 横幅@ ◎ max-content width

物理-横幅の方の`最大-内容~size$。 ◎ Whichever of max-content block size or max-content inline size is the physical width.

`外縁 最小-横幅@ ◎ outer min width

次を除いて、 `外縁~横幅$と同様 ⇒ `width$p の算出d値が `auto^v のときには、 `最小-内容 横幅$が利用される ◎ Like the outer width, except the min-content width is used when the computed width is auto.

`外縁 最大-横幅@ ◎ outer max width

次を除いて、 `外縁~横幅$と同様 ⇒ `width$p の算出d値が `auto^v のときには、 `最大-内容 横幅$が利用される ◎ Like the outer width, except the max-content width is used when the computed width is auto.

`~page-margin~box$用の `包含塊@ は、 その所在に依存して決まる： ◎ The containing block for a page-margin box depends on its location:

• 隅の`~page-margin~box$用の`包含塊$は ⇒ その隅で出会う 2 本の~page~marginの交差域で定義される矩形。 ◎ For a corner page-margin box, it is the rectangle defined by the intersection of the two page margins meeting at that corner.

• 他の`~page-margin~box$用の`包含塊$は ⇒ その~boxがある側の~page~marginから，［ ~boxの両隣にある隅の`~page-margin~box$の包含塊 ］を除いて形成される矩形。 ◎ For all other page-margin boxes, the containing block is the rectangle formed by the encapsulating page margin minus the containing blocks of the adjacent corners' page-margin boxes.＼

  このことは、 この包含塊の~sizeが［ 一方の寸法は使用~page~marginにより, 他方の寸法は次により ］与えられることを意味する ⇒＃ 上下端の`~page-margin~box$用には`可用な横幅$／ 左右端の`~page-margin~box$用には`可用な縦幅$ ◎ This means that the size of this containing block is given in one dimension by the used page margin and in the other dimension by the available width (for top and bottom page-margin boxes) or available height (for left and right page-margin boxes).

5.3.2. ~page-margin~boxの可変~寸法~用の算出~規則

【 可変~寸法 — すなわち，上下端の~margin~boxにおいては横方向の寸法, 左右端の~margin~boxにおいては縦方向の寸法。 】

以下の規則が［ `上端左$, `上端中央$, `上端右$ ］の`~page-margin~box$ （以下，順に、 %左~box, %中央~box, %右~box と記す） に適用される。 ◎ The following rules apply to @top-left, @top-center and @top-right page-margin boxes, which are referred to as A, B, and C, respectively, in this section.

【 他の側の~boxについては、 この節の最後 `§ 他の側の~box＠#variable-mapping$にて述べられる。 】

5.3.2.1. ~margin

三つの~boxのいずれに対しても、 算出d値が `auto^v になる［ `margin-left$p ／ `margin-right$p ］~propの使用~値は， `0^v になる。 ◎ If the margin-left or margin-right property of any of the three boxes computes to auto, the used value is zero.

5.3.2.2. `auto^v 横幅の解決-法

次の~algoは、 各~boxの使用【外縁】横幅を決定する。 この目的においては、 `生成され$ない~boxの［ `width$p, `外縁~横幅$ ］は， 0 と見做す。 ◎ The following algorithm determines the used width of each box. For this purpose, boxes that are not generated are assumed to have a width and an outer width of zero.

注記： より高~levelな目標は、 内容の分量に比例するように空間を分配することにある — （優先度~順で）次を行うことにより ⇒＃ (1) ~overflow, 重合nを最小限にする／ (2) %中央~box が生成されるときは中央化する ◎ Note: The high-level goals are (in order of priority) to center the middle box (B) if it is generated, to minimize overflow and overlap, and to distribute space proportionally to the amount of content.

%中央~box が`生成され$ない場合、 `可用な横幅$を次に従って［ %左~box, %右~box ］に分配する： ◎ If the middle box (B) is not generated, distribute the available width to A and C as follows:

• 片方の~boxのみ `auto^v 横幅の場合 （すなわち， `width^p の算出d値は `auto^v である）、 その使用~値は，［ 両~boxの`外縁~横幅$の総和 ~EQ `可用な横幅$ ］になるように解決される。 ◎ If only one box has 'width: auto', its used width is resolved so that the sum of the outer widths equals available width.

• %左~box, %右~box ともに `auto^v 横幅の場合、 次の式により，各~boxに空間を分配する ⇒ ~boxの使用~外縁~横幅 ~EQ %W ~PLUS ( `~flex空間$V ~MUL ( `~flex係数$V ~DIV ( 両~boxの `~flex係数$V の総和 ) ) )

  ここで， `~flex空間@V, および~boxごとに異なり得る量［ %W, `~flex係数@V ］は、 次で与えられる：

  ◎ If A and C both have 'width: auto', distribute the space to each box as follows: ◎ ↓
  1. `~flex空間$V ~SET `可用な横幅$ ~MINUS ( 両~boxの外縁 `最大-内容 横幅$の総和 ) ◎ ↓

  2. ［ `~flex空間$V ~GTE 0 ］ならば：

     • `~flex係数$V ~SET ~boxの外縁 `最大-内容 横幅$に比例する量
     • %W ~SET ~boxの`最大-内容 横幅$
     ◎ If the sum of the outer max-content widths is less than the available width, call that difference the flex space. Calculate each box’s flex factor as proportional to its outer max-content width, and set its used outer width to: max-content width + flex space × flex factor ÷ ∑flex factors

  3. 他の場合：

     • `~flex空間$V ~SET `可用な横幅$ ~MINUS ( 両~boxの外縁 `最小-内容 横幅$の総和 )

     • `~flex係数$V ~SET 次で与えられる量：

       • `~flex空間$V ~GTE 0 ならば： ~boxの ( `最大-内容 横幅$ ~MINUS `最小-内容 横幅$ ) に比例する量
       • 他の場合： ~boxの外縁 `最小-内容 横幅$に比例する量
     • %W ~SET ~boxの`最小-内容 横幅$
     ◎ Otherwise if the sum of the outer min-content widths is less than the available width, call that difference the flex space calculate each box’s flex factor as proportional to its max-content width minus min-content width, and set its used outer width to: min-content width + flex space × flex factor ÷ ∑flex factors ◎ Otherwise, calculate its outer size as in the previous case, but set each box’s flex factor as proportional to its outer min-content width.
  4. ここで、 両~boxの `~flex係数$V の総和が 0 になる場合 ⇒ 両~boxとも `~flex係数$V は 1 と見做す ◎ In each case, both flex factors are assumed to be 1 if their sum is equal to zero.

%中央~box が`生成され$る場合、［ %左~box ／ %中央~box ／ %右~box ］に対する `auto^v 横幅を次に従って決定する： ◎ If the middle box (B) is generated, determine the auto widths of A, B, and C as follows:

1. まず、 %中央~box に対する `auto^v 横幅を解決する。 ここでは，［ %左~box, %右~box ］の代わりに仮想の~box %左~右~box があって、 その横幅は次を満たすと見做す （これは %中央~box の中央寄せを保全する） ⇒ %左~右~box の横幅 ~EQ `max^op( %左~box の横幅, %右~box の横幅 ) ~MUL 2

   【 明示的に述べられていないが、 `max^op() の中の横幅 `auto^v は無視し，両方とも `auto^v ならば結果は `auto^v と見做す下で，次を適用することになるであろう。 】

   ［ %左~box, %右~box ］に対し`中央~boxが生成されない場合＠#flex-fit$に述べたように，［ %中央~box, %左~右~box ］に空間を分配する。

   ◎ First, resolve any auto width of the middle box (B): Assume there are two boxes, B and AC, where each of AC’s dimensions is double the maximum of A and C. (This preserves B’s centering.) Distribute the space to these two boxes (B and the imaginary AC) as described for A and C above.
2. 次に、［ %左~box ／ %右~box ］に対する `auto^v 横幅を，次の式の結果に解決する ⇒ ~boxの使用~外縁~横幅 ~EQ ( `可用な横幅$ ~MINUS %中央~box の使用~外縁~横幅 ) ~DIV 2 ◎ Then, resolve any auto widths of the side boxes (A and C) by setting that box’s outer width to (available width − used outer widths of B) ÷ 2

5.3.2.3. `min-width^p, `max-width^p の取扱い

［ `min-width$p, `max-width$p ］~prop `CSS2$r は、 通常の要素に対するときと同様に，`~page-margin~box$の可変~寸法にも適用される — ただし、 同じ側にある三つの~boxは，まとめて考慮される。 ◎ The min-width and max-width properties [CSS2] apply to page-margin boxes in the variable dimension like on normal elements, except that the three boxes on the same side are considered together.

より精確には： ◎ More precisely:

1. 仮の使用~横幅は、 【三つの~boxのそれぞれに対し，】 `前節の規則＠#variable-auto-sizing$の下で （ `min-width$p, `max-width$p は織り込まずに） 横幅を計算した結果とする。 ◎ The tentative used widths are calculated (without min-width and max-width) following the rules under § 5.3.2.2 Resolving auto widths.
2. 三つの~boxいずれかにおいて，仮の使用~横幅 ~GT `max-width$p ならば ⇒ 【該当する~boxたちに限り】 `width$p 用の算出d値に代えて `max-width$p の算出d値を利用する下で、 前節の規則を再び適用する。 ◎ If the tentative used width of any of the three boxes is greater than max-width, the rules above are applied again, but this time using the computed value of max-width as the computed value for width.
3. 三つの~boxいずれかにおいて，前~段の結果の横幅 ~LT `min-width$p ならば ⇒ 【該当する~boxたちに限り】 `width$p 用の算出d値に代えて `min-width$p の算出d値を利用する下で、 前節の規則を再び適用する。 ◎ If the resulting width of any of the three boxes is smaller than min-width, the rules above are applied again, but this time using the value of min-width as the computed value for width.

5.3.2.4. 位置決め

各~boxの寸法が決定されたなら、 それらを，次に従って位置させる： ◎ Once the dimensions of the boxes are determined, they are positioned as follows:

• %左~box の左端~外縁~辺は、 包含塊の左端~辺に接合する。 ◎ The left outer edge of A is flush with the left edge of the containing block
• %中央~box の外縁~区画は、 包含塊~内で中央化する。 ◎ The outer area of B is centered in the containing block.
• %右~box の右端~外縁~辺は、 包含塊の右端~辺に接合する。 ◎ The right outer edge of C is flush with the right edge of the containing block.

5.3.2.5. 他の側の~box

他の側の`~page-margin~box$の使用~値は、 次の規則により確立される：

`下端左$, `下端中央$, `下端右$

順に［ `上端左$, `上端中央$, `上端右$ ］用の規則と同じ規則により。 ◎ The used values for @bottom-left, @bottom-center and @bottom-right page-margin boxes are established by the same rules as for @top-left, @top-center, and @top-right, respectively.

`左端上$, `左端中段$, `左端下$

`右端上$, `右端中段$, `右端下$

順に［ `上端左$, `上端中央$, `上端右$ ］用の規則を成す［ "width" ／ "left" ／ "center" ／ "right" （横幅／左端／中央／右端） ］を［ "height" ／ "top" ／ "middle" ／ "bottom" （縦幅／上端／中段／下端） ］に読替えた規則により。 ◎ The used values for @left-top, @left-middle and @left-bottom boxes are established by the same rules, with "width" replaced by "height", "left" by "top", "right" by "bottom" and "center" by "middle". ◎ The used values for @right-top, @right-middle and @right-bottom page-margin boxes are established by the same rules as for @left-top, @left-middle and @left-bottom, respectively.

5.3.3. ~page-margin~boxの固定d寸法~用の算出~規則

【 固定d寸法 — すなわち，上下端の~margin~boxにおいては縦方向の寸法, 左右端の~margin~boxにおいては横方向の寸法。 】

以下の規則が、 上端~側の`~page-margin~box$（`左上隅$, `上端左$, `上端中央$, `上端右$, `右上隅$）の［ `height$p, `margin-top$p, `margin-bottom$p ］~propの使用~値を計算する — すなわち， “不定” な値 `auto^v を解決する — ために利用される： ◎ The rules below are used to calculate the used values of each @top-left-corner, @top-left, @top-center, @top-right, and @top-right-corner page-margin box’s height, margin-top, and margin-bottom properties:

1. ［ %H, %mT, %mB のうち，不定でないもの ］の総和 ~GT %M ならば ⇒ 不定な［ %mT ／ %mB ］を `safe-printable-inset$t として解決した上で，以下を適用する。 ◎ If border-top-width + padding-top + height (if it is not auto) + padding-bottom + border-bottom-width, plus margin-top and/or margin-bottom if not auto, is larger than the height of the top page margin, then any auto values for margin-top or margin-bottom are, for the following rules, treated as <safe-printable-inset>.
2. %H は不定である場合 ⇒ 不定な［ %mT ／ %mB ］を `safe-printable-inset$t として解決した上で， %H について等式を解いて解決する。 ◎ ↓

3. %H は不定でない場合： ◎ ↓

   • %mT, %mB どちらも不定でない場合 ⇒ この事例は `拘束され過ぎ@ と称される。 %mT は不定であると見做す下で， %mT について等式を解いて解決する。 ◎ If at this point all of height, margin-top, and margin-bottom have a computed value other than auto, the values are said to be "over-constrained". In this case, the specified value of margin-top is treated as auto.
   • %mT, %mB のうち片方だけ不定である場合 ⇒ その片方について等式を解いて解決する。 ◎ If there is now exactly one value specified as auto, its used value follows from the equality. ◎ ↑ If height is set to auto, any auto margin values become <safe-printable-inset> and height follows from the resulting equality.

   • %mT, %mB どちらも不定である場合： ◎ If both margin-top and margin-bottom are auto,＼

     1. %mT = %mB と見做す下で等式を解いて，それらを解決する。 これは、 `~page-margin~box$の内容を上端~page~marginの中で縦方向に中央化する。 ◎ their used values become equal. This vertically centers the page-margin box content within the top page margin.＼
     2. `safe-printable-inset$t ~NEQ `0^v かつ結果の %mT ~LT `safe-printable-inset$t になった場合には、 追加的な調整~段として次を遂行する ⇒ %mB から %差 を減算して %mT に %差 を加算する — ここでの %差 は、 次の結果になるとする ⇒ `min^op( `safe-printable-inset$t ~MINUS %mT, %mB ) ◎ If <safe-printable-inset> is not 0 here, an additional adjustment step is performed: If the resulting margin-top in the previous step became less than <safe-printable-inset>, subtract as much as possible of this difference from margin-bottom without making it negative. Then add this value to margin-top.

同じ規則は、 下端の`~page-margin~box$（`左下隅$, `下端左$, `下端中央$, `下端右$, `右下隅$）に対しても適用される — ただし，`拘束され過ぎ$になる場合は、 %mT ではなく %mB を不定と~~見なす。 ◎ The same rules apply to the bottom page-margin boxes (bottom-left-corner, bottom-left, bottom-center, bottom-right, and bottom-right-corner), except that in the overconstrained case, the margin-bottom is ignored rather than the margin-top.

左右端の`~page-margin~box$（［ `左上隅$, `左端上$, `左端中段$, `左端下$, `左下隅$ ］, ［ `右上隅$, `右端上$, `右端中段$, `右端下$, `右下隅$ ］）用の `width$p に関する各種~propも，相似的な規則で統治される： ［ "top" ／ "bottom" ／ "height" （上端／下端／縦幅） ］を順に［ "left" ／ "right" ／ "width" （左端／右端／横幅） ］に読替えた上で、［ 左端／右端 ］`~page-margin~box$が`拘束され過ぎ$になる事例では，［ `margin-left$p ／ `margin-right$p ］を不定と~~見なす。 ◎ Analogous rules govern the properties for the left and right page-margin boxes with respect to width (top-left-corner, left-top, left-middle, left-bottom, and bottom-left-corner; top-right-corner, right-top, right-middle, right-bottom, bottom-right-corner), with "top" replaced by "left", "bottom" replaced by "right", and "height" replaced by "width". In the overconstrained case for left (right) page-margin boxes, the specified value of margin-left (margin-right) is ignored.

5.4. ~page-margin~boxの例

`~page-margin~box$ の用例集を以下に示す： ◎ The following is a collection of examples of page-margin box usage.

@page {
  @top-left {
    content: "~~左セル内のヘッダ";
  }
}

@page {
  @top-center {
    content: "~~中央セル内のヘッダ";
  }
}

@page {
  @top-right {
    content: "~~右セル内のヘッダ";
  }
}

@page {
  @top-left {
    content: "~~左セル";
  }
  @top-center {
    content: "~~中央セル内のヘッダ";
  }
}

@page {
  @top-center {
    content: "~~中央セル内のヘッダ";
  }
  @top-right {
    content: "~~右セル";
  }
}

@page {
  @top-left {
    content: "~~上端左のヘッダ";
  }
  @top-right {
    content: "~~右セル";
  }
}

6.1. ~pageに基づく~counter

~counterは、 `page$at 規則の中でも定義して制御でき， `~page-margin~box$内の内容として利用できる。 これは、 ~page数を保守するときに有用になる。 ◎ Counters can be defined and controlled within an @page rule, and used as content in page-margin boxes. This is useful for maintaining a page count.

［ `~page文脈$／`~margin文脈$ ］の中の `counter-increment$p は、 各`~page~box$の生成ごとに~counterを増分する。 ◎ A counter-increment within either a page or margin context causes the counter to increment with the generation of each page box.

`~page文脈$の中で［ 設定し直される／増分される ］~counterは、 すべての`~page-margin~box$の視野に入る — 文書の中に同じ名前の~counterが在る場合、 それらを隠蔽する。 ◎ If a counter is reset or incremented within the page context, it is in scope for all page-margin boxes and obscures all counters of the same name within the document.

`~margin文脈$の中で［ 設定し直される／増分される ］~counterは、 その`~page-margin~box$の視野に入る — `~page文脈$や文書の中に同じ名前の~counterが在る場合、 それらを隠蔽する。 ◎ If a counter is reset or incremented within a margin context, it is in scope for that page-margin box and obscures any counters of the same name in both the page context and the document.

［ `~margin文脈$／`~page文脈$ ］の中で，まだ設定し直されても増分されてもいない~counterが， `~margin文脈$内で `counter()$f や `counters()$f に利用された場合、 結果の値は， 正確に，当の`~page-margin~box$が［ 文書の中で~pageの始端にある要素である ］かつ［ ~page分断【に？まで？を？】~spanするような，通常~flow内の最も深い要素の内側にある ］かのようになる。 この仕方で~counterを利用しても、 ~counterの値の計算に影響しない。 ◎ If a counter that has not been reset or incremented within the margin context or the page context is used by counter() or counters() in the margin context, then the resultant value is exactly as if the page-margin box were an element within the document at the start of the page, inside the deepest element in the normal flow that spans the page break. Use of the counter in this way does not affect the calculation of the counter’s value.

`page^v と命名される~counterは、 自動的に作成される。 それは、 文書を成す~pageごとに 1 ずつ増分される — `counter-increment$p ~propが， `~page文脈$内で `page^v ~counter用に異なる増分を明示的に指定していない限り。 暗黙な~counterである `page^v は，【 `list-item$v と同様に】本物の~counterであり、［ `counter-increment$p, `counter-reset$p ］~prop内で明示的に名前 `page^v を指定することにより【！when named】，直に影響させ得る。 それは、 `counter()$f や `counters()$f 関数~形にも利用できる。 ◎ A counter named page is automatically created and incremented by 1 on every page of the document, unless the counter-increment property in the page context explicitly specifies a different increment for the page counter. The implied page counter is a real counter, and can be directly affected using the counter-increment and counter-reset properties when named explicitly in those properties. It can also be used in the 'counter()' and 'counters()' function forms.

@page {
  margin: 10%;

  @top-center {
    font-family: sans-serif;
    font-weight: bold;
    font-size: 2em;
    content: counter(page);
  }
}

@page {
  counter-increment: page 2;
}

加えて， `pages^v と命名される~counterも、 ~UAにより自動的に作成される。 その値は，常に文書~内の総~page数になる （`連続的~媒体$においては、 これは常に 1 になる）。 `pages^v の値は操作できない — それを設定する［ `counter-reset$p ／ `counter-increment$p ］宣言【！statement】は、 妥当であるが，その効果は無い。 ◎ Additionally, a counter named pages is automatically created by the UA. Its value is always the total number of pages in the document. (In continuous media this is always 1.) The value of pages cannot be manipulated: while counter-reset and counter-increment statements that set it are valid, they have no effect.

~pageに結付けられた他のすべての~counterに関しては、 `CSS2$r `§ 入子な~counterとその視野＠~CSS22/generate.html#scope$, `§ ~counter＠~CSS22/syndata.html#counter$ の記述に従って挙動する。 【`CSS-LISTS-3$r においては `§ 入子な~counterとその視野＠~CSSLIST#nested-counters$, `§ ~counter＠~CSSLIST#counter$ 】 ◎ In all other respects, page-associated counters behave as described in [CSS2], Nested Counters and Scope and Counters.

6.2. 各種~page-margin~boxと既定~値

［ `~page文脈$／`~margin文脈$ ］の中で利用される~propは，その初期~値を対応する~prop定義からとるが、 次の表tに挙げる値に対しては，~UAは［ 自身の既定の~stylesheet内の規則により確立されたかのように挙動する ］モノトスル。 ◎ Properties used within page or margin contexts take their initial values from their respective property definitions; however, user agents must behave as though the values in the following table were established by rules in the UA default style sheet.

body {counter-reset: chapter;}
div.chapter {counter-increment: chapter;}
@page {
  margin: 10%;
  @top-center {
    content: "Chapter" counter(chapter);
  }
}

7.1. ~page~size： `size^d ~prop

`size$d ~propは、 `~page~box$の包含塊に対し，~~目的の~sizeと方位を指定する。 加えて、 一般的な事例 — 1 個の`~page~box$が 1 枚の`用紙$に描画される事例 — においては，出力先の用紙の~sizeも指示する。 ◎ This property specifies the target size and orientation of the page box’s containing block. In the general case, where one page box is rendered onto one page sheet, the size property also indicates the size of the destination page sheet.

`~page~box$の~sizeは、 “絶対的” （固定d~size）にも, “可変size”（すなわち，可用な用紙~sizeに収める）にもなり得る。 可変sizeの`~page~box$を作成するときは、 値［ `auto$v ／ `portrait$v ／ `landscape$v ］を利用できる。 他の値は、 固定d~sizeの`~page~box$を定義し，選好される出力~媒体~sizeを指示する。 アリなときには、 出力は，指示された媒体~sizeで描画されるべきである。 指定された~sizeが可用でない場合、 `~page~boxを異なる~sizeへ移転するときの規則＠#renderingpages$が適用される。 ◎ The size of a page box can either be "absolute" (fixed size) or "scalable" (i.e., fitting available sheet sizes). The first three values in the table below can be used to create scalable page boxes. Other values define a fixed-size page box, and thereby indicate the preferred output media size. When possible, output should be rendered on the media size indicated. If the specified size is not available, the rules for transposing a page box to a different size apply.

`size$d ~prop宣言が，次のいずれかの`媒体~query$［ `width$d, `height$d, `device-width$d, `device-height$d, `aspect-ratio$d, `device-aspect-ratio$d, `orientation$d ］ `MEDIAQ$r （または紙~sizeに対する他の条件付き規則） により選抜される場合、 当の宣言を`無視-$するモノトスル — 媒体~queryは、 `size$d を尊守せず，［ `page$at 規則が一つも指定されなかったとするときに選ばれる紙~size ］であると見做す。 ◎ If a size property declaration is qualified by a width, height, device-width, device-height, aspect-ratio, device-aspect-ratio or orientation media query [MEDIAQ] (or other conditional on the size of the paper), then the declaration must be ignored. Media queries do not honor size: they assume the paper size that would be chosen if no @page rules were specified.

@page {
  size: 4in 6in;
}

@media (max-width: 6in) {
  @page {
    size: letter;
  }
}

`auto@v

`~page~box$は、 ~UAにより選ばれる~sizeと方位に設定される。 通例的には、 `~page~box$の~sizeと方位は，~~目的の媒体~用紙に合致するよう選ばれる。 ◎ The page box will be set to a size and orientation chosen by the UA. In the usual case, the page box size and orientation is chosen to match the target media sheet.

`landscape@v

~pageの内容は、 `横置き方位$に印刷されることを指定する。 `~page~box$のより長い側が横方向になる。 `page-size$t が指定されなかった場合、 用紙の~sizeは，~UAにより選ばれる。 ◎ Specifies that the page’s content be printed in landscape orientation. The longer sides of the page box are horizontal. If a <page-size> is not specified, the size of the page sheet is chosen by the UA.

`portrait@v

~pageの内容は、 `縦置き方位$に印刷されることを指定する。 `~page~box$の より短い側が横方向になる。 `page-size$t が指定されなかった場合、 用紙の~sizeは，~UAにより選ばれる。 ◎ Specifies that the page’s content be printed in portrait orientation. The shorter sides of the page box are horizontal. If a <page-size> is not specified, the size of the page sheet is chosen by the UA.

`length [0,∞]$t

`~page~box$は、 所与の絶対的~寸法に設定される。 長さ値が 1 個だけ指定された場合、 それが，`~page~box$の［ 横幅, 縦幅 ］を設定する（すなわち，~boxは正方形になる）。 長さ値が 2 個 指定された場合、 順に，`~page~box$の［ 横幅, 縦幅 ］を確立する。 ［ `em$u ／ `ex$u ］単位を伴う値は、 `~page文脈$の~fontを参照rする。 負な長さは妥当でない【！illegal】。 ◎ The page box will be set to the given absolute dimension(s). If only one length value is specified, it sets both the width and height of the page box (i.e., the box is a square). If two length values are specified, the first establishes the page box width, and the second the page box height. Values in units of em and ex refer to the page context’s font. Negative lengths are illegal.

`page-size@t

~page~sizeは、 次に挙げるいずれかの媒体~名を利用して指定することもできる。 これは、 長さ値を利用して `size$d を指定することと等価である。 各~媒体~名の定義は、 `Media Standardized Names^cite `PWGMSN$r に基づく。 ◎ A page size can be specified using one of the following media names. This is the equivalent of specifying size using length values. The definition of the media names comes from Media Standardized Names [PWGMSN].

`A5@v

ISO A5 ~size： 幅 148mm × 高さ 210mm に等価。 ◎ Equivalent to the size of ISO A5 media: 148mm wide and 210 mm high.

`A4@v

ISO A4 ~size： 幅 210mm × 高さ 297mm に等価。 ◎ Equivalent to the size of ISO A4 media: 210 mm wide and 297 mm high.

`A3@v

ISO A3 ~size： 幅 297mm × 高さ 420mm に等価。 ◎ Equivalent to the size of ISO A3 media: 297mm wide and 420mm high.

`B5@v

ISO B5 ~size： 幅 176mm × 高さ 250mm に等価。 ◎ Equivalent to the size of ISO B5 media: 176mm wide by 250mm high.

`B4@v

ISO B4 ~size： 幅 250mm × 高さ 353mm に等価。 ◎ Equivalent to the size of ISO B4 media: 250mm wide by 353mm high.

`JIS-B5@v

JIS B5 ~size： 幅 182mm × 高さ 257mm に等価。 ◎ Equivalent to the size of JIS B5 media: 182mm wide by 257mm high.

`JIS-B4@v

JIS B4 ~size： 幅 257mm × 高さ 364mm に等価。 ◎ Equivalent to the size of JIS B4 media: 257mm wide by 364mm high.

`letter@v

北米 letter ~size： 幅 8.5in × 高さ 11in （ in = ~inch ） に等価。 ◎ Equivalent to the size of North American letter media: 8.5 inches wide and 11 inches high

`legal@v

北米 legal ~size： 幅 8.5in × 高さ 14in に等価。 ◎ Equivalent to the size of North American legal: 8.5 inches wide by 14 inches high.

`ledger@v

北米 ledger ~size： 幅 11in × 高さ 17in に等価。 ◎ Equivalent to the size of North American ledger: 11 inches wide by 17 inches high.

`page-size$t による名前は、［ `landscape$v ／ `portrait$v ］との併用で，~sizeと方位を指示するために利用できる。 ◎ The <page-size> names can be used in conjunction with landscape or portrait to indicate both size and orientation.

@page {
  size: A4 landscape;
}

@page {
  size: auto;/* `auto^v が初期~値 */
  margin: 10%;
}

@page {
  size: 8.5in 11in;/* 横幅 縦幅 */
}

/* “A4” 印刷ng用の~stylesheet */
@media print and (width: 21cm) and (height: 29.7cm) {
  @page {
     margin: 3cm;
  }
}

/* “letter” 印刷ng用の~stylesheet */
@media print and (width: 8.5in) and (height: 11in) {
  @page {
    margin: 1in;
  }
}

7.2. 断裁markと見当mark： `marks^d ~prop

この~propは、 文書に，断裁markや見当mark【いわゆるトンボ】を追加する。 これらは、 用紙の裁断と整列を手助けするために，`~page~box$の外側に印刷される。 各種 値の意味は： ◎ This property adds crop and/or registration marks to the document. These are printed outside the page box to facilitate the trimming and alignment of sheets of paper. Values have the following meanings:

`none@v

［ 断裁mark, 見当mark ］どちらも印刷されるべきでないものと指定する。 `裁切り区画$の外側の区画は、 完全に白紙になる。 ◎ Specifies that neither crop marks nor registration marks should be printed: the area outside the bleed area will be completely blank.

`crop@v

断裁markは印刷されるべきであるものと指定する。 これらは概して、 実質的に，`~page~box$の 4 辺の外側への延長に重なる短い線であり、 `~page~box$の中や近辺には何も刷ることなく， 4 辺の精確な所在を指示する。 ◎ Specifies that crop marks should be printed. These are typically short lines outside the page box that are effectively extensions of the page box’s four edges, thereby indicating the precise location of those edges without placing any ink near or within the page box itself.

`cross@v

見当markは印刷されるべきであるものと指定する。 これらは概して、 `~page~box$の各~辺の外側にある十字markであり， 印刷ng工程において用紙を互いに整列するために利用される。 ◎ Specifies that registration marks should be printed. These are typically cross-shaped marks outside each edge of the page box used to align sheets of paper during the printing process.

断裁markと見当markは、 `~page~box$が`印刷-可能な区画$より狭いときに限り，可視になることに注意。 ◎ Note that crop marks and registration marks are only visible if the page box is smaller than the printable area.

@page {
    marks: crop cross;
}

7.3. 裁切り区画： `bleed^d ~prop

この~propは、 `~page~box$の外側へ拡がる `裁切り区画@ — 言い換えれば、 そこで~page描画が切取られるような，`~page~box$を超える拡がり — を指定する。 各種 値の意味は： ◎ This property specifies the extent of the bleed area outside the page box; in other words the extent beyond the page box at which the page rendering is clipped. Values have the following meanings:

`auto@v

［ `marks$d が `crop^v ならば `6pt^v ／ 他の場合は `0^v ］に算出される。 ◎ Computes to 6pt if marks has crop and to zero otherwise.

`length$t

各~方向について，`裁切り区画$が［ `~page~box$を超えて，どこまで外方へ拡がるか ］を指定する。 値は負でもヨイが、 実装に特有な制限sがあり得る。 ◎ Specifies by how far outward, in each direction, the bleed area extends past the page box. Values may be negative, but there may be implementation-specific limits.

7.4. 用紙に収まらない~page~boxの描画

`~page~box$が，~~目的の用紙~寸法に合致しない場合、 ~UAは，次に挙げるいずれか一つを行うべきである（選好~順に挙げる）： ◎ If a page box does not match the target page sheet dimensions, the user agent should do one of the following (in order of preference):

1. より大きな用紙~上に，指示された~sizeで~page~boxを描画する。 ◎ Render the page box at the indicated size on a larger page sheet.
2. ~page~boxを 90° 回転したときに用紙に収まるならば，そうする。 ◎ Rotate the page box 90° if this will make the page box fit the page sheet.
3. ~page~boxを用紙に収まるように拡縮する（~page~boxの縦横比は保全されるべきである）。 ◎ Scale the page box to fit the page sheet. (The aspect ratio of the page box should be preserved.)
4. 複数の用紙に，~page~boxを~graphic的に “切分ける” 。 ◎ Graphically "slice" the page box onto multiple page sheets.
5. ~overflowした内容を切取る（最も選好されない）。 ◎ Clip overflowed content (least preferred).

~UAは、 これらの演算を遂行する前に，利用者に~~指示を仰いでもよい。 ◎ The user agent may wish to consult the user before performing these operations.

7.5. 用紙~上の~page~boxの位置決め

`~page~box$が用紙より小さいときは、 ~UAは，次に挙げるいずれか一つを行うべきである： ◎ When the page box is smaller than the page sheet, the user agent should either:

• ~page~boxを用紙~上で中央化して，両面~pageを整列させる — 用紙の辺~近くに印刷される情報が不用意に失われないよう。 ◎ center the page box on the sheet since this will align double-sided pages and avoid accidental loss of information that is printed near the edge of the sheet; or
• ~page~boxを用紙の~~左上~隅に （あるいは，~page~box の `direction$p と `writing-mode$p ~propに基づく別の隅に） 位置させる — 媒体の消費を最小限にするよう。 ◎ position the page box in the upper left corner of the page sheet (or another corner, based on the direction and writing-mode properties of the page box) as this may minimize media consumption.

~UAは、 これに関して，利用者に~~指示を仰いでもよい。 ◎ The user agent may wish to consult the user in this regard.

7.6. 印刷-可能な区画の中に居続ける： `page-margin-safety$d ~prop

ほとんどの印刷機には、 用紙の各~辺に沿って印刷-不能な狭い領域がある — 概して，その［ 紙を取扱う仕組み ］に因り。 この~propは、［ ~pageの~margin／`~page-margin~box$の~margin ］を調整することにより， `印刷-可能な区画$の中に居続ける助けに利用できる。 ◎ Most printers have a small region along each edge of the page sheet which is unprintable, typically due to the printer’s paper handling mechanism. This property can be used to help staying within the printable area, by adjusting the page margins and page margin box margins.

印刷機には，紙の 4 辺に沿う印刷-不能な区画の幅が一様でないものもあり、 印刷-出力を自前の裁量で回転することもある。 したがって，~UAは、 用紙が［ どの辺から, あるいは どの方位で【すなわち，回転されるか否か】 ］印刷機の中へ送り込まれるかについて前提を置けないこともある。 ~UAが，そのような前提を置けない場合、 これら【 4 辺の~marginを調整するための】 4 個の値のうち最~大な値に限り供される （それが，すべての側に利用されることになる）。 他の場合，~UAが［ 当の 4 個の値が個別に利用-可能であるものと信用でき, 回転は施されないと見做せる, 等々 ］ならば、 ~pageを成す各~側は，個々の値を有し得る。 ◎ Some printers don’t have a uniform unprintable area width along each of the four paper edges, and the printer may rotate the print output at their own discretion. The user agent may therefore not be able to make assumptions about which edge will be fed first into the printer, or what orientation the sheet of paper has. If the user agent cannot make such assumptions, only one will be provided (to be used on all 4 sides): The larger of these four values. Otherwise, if the user agent can trust that the four values are usable individually, and that no rotation is going to take place, and so on, each side of the page may have individual values.

この値~FN は、 `safe-printable-inset@t と称される — それは、 `length$t 値である。 ◎ Let this value be <safe-printable-inset>, which is a <length>.

【~FN ~UAが各~側の~marginを調整するために供するこれら 4 個の値 — 以下に述べるとおり，それらのうち どの値が利用されるかは、 どの`~margin~at-規則$の中で指定されたかに応じて変わり得る。 】

この~propは、 `用紙$を成す いずれかの辺に隣接な~marginに限り影響する。 他のすべての~margin — すなわち，`~page区画$に接している~margin — 用には， その値【 `safe-printable-inset$t 】は 0 になる。 言い換えれば、 ある`~margin文脈$において `page-margin-safety$d が指定されたとき， その効果が及ぶ側は 2 つまでに限られることになる。 一例として、 `page$at { `top-right-corner$at { `page-margin-safety$d: `clamp$v; } } が切詰める対象になり得る~marginの値は，［ 上端, 右端 ］のそれらに限られる — ［ 下端, 左端 ］~marginは、 ~pageの辺ではなく，文書の内容に接しているので。 ◎ This property only affects margins that are adjacent to one of the edges of a sheet. For all other margins, i.e. those margins facing the page’s page area, its value is 0. In other words, when page-margin-safety is specified in a margin context, it will only have an effect at one or two sides. For instance, @page { @top-right-corner { page-margin-safety: clamp; } } may only clamp top and right margin values, as the bottom and left margins face the document’s contents, not the page’s edges.

`none@v

~marginは、 印刷-不能な領域により影響されない。 ◎ Margins are not affected by unprintable regions

`clamp@v

~marginの使用~値は［ 解決d値, 所与の側~用の `safe-printable-inset$t ］の最大になる。 ◎ The used margin values will be the maximum of the resolved value, and <safe-printable-inset> for the given side.

`add@v

~marginの使用~値は、 解決d値に `safe-printable-inset$t を加算した結果になる。 ◎ The used margin values will be the resolved value, plus <safe-printable-inset> for the given side.

【 `clamp^v と `add^v の相違が `safe-printable-inset$t を利用している `§ ~page-margin~boxの固定d寸法~用の算出~規則＠#fixed-sizing$ にどう反映されるのか，はっきりしない。 `none^v については、 `safe-printable-inset$t を 0 と見做す下で， その規則を適用する（すなわち，この節が導入される前の挙動に従う）ものと思われるが。 ここでの解決d値（ `resolved value^en ）が［ ~CSSが定義する`解決d値$, （ `none^v であったとするとき）その規則を適用して `auto^v ~marginを解決した結果 ］どちらを指しているのか，はっきりしない。 】

8.1. 有名~pageの利用： `page^p

【~FN “作成する” の定義がはっきりしない。 分断点を~boxの前後に作成する？内側に作成する？ あるいは、［ 分断点を合間に作成するような一連の~box ］に適用される？ 】

`page$p ~propは、 要素が表示されるモノトスル~page — `有名~page@ と呼ばれる，特定0の種別を成す~page~FN1 — を指定するために利用される。 必要yなら，`強制d~page分断$が導入され、 指定された種別を成す新たな~pageが生成される~FN2。 ◎ The page property is used to specify a particular type of page (called a named page) on which an element must be displayed. If necessary, a forced page break is introduced and a new page generated of the specified type.

【~FN1 すなわち、 この~propは，`~page種別~名$を指定する — 当の要素は、 その名前に`合致する$~page内に~lay-outされる。 】【~FN2 すなわち、 `page$p ~prop（の使用~値）が異なる~boxたちが同じ~page内に~lay-outされないよう， それらの合間のどこかで “改~page” される。 】

注記： この~pageには、 `~page選択子$にて同じ種別~名を利用して，~styleをあてがえる。 ◎ Note: This page can be styled by using the same type name in a page selector.

`~page種別~名$は、 文字大小区別な識別子である。 ただし，値 `auto^v は、 `~CSS~keyword$なので，`~ASCII大小無視$である。 ◎ Page type names are case-sensitive identifiers. However the auto value, being a CSS keyword, is ASCII case-insensitive.

`page$p ~propは継承されない。 しかしながら，要素の `page$p に値 `auto^v が指定された場合、 その使用~値は，当の要素の先祖に非 `auto^v 値が指定されたものが ⇒＃ 在るならば，それらのうち当の要素に最も近い先祖に指定された値になる。 無いならば（特に，`根~要素$に指定された場合も），空~文字列になる。 ◎ The page property does not inherit. However, if the page value on an element is auto, then its used value is the value specified on its nearest ancestor with a non-auto value. When specified on the root element, the used value for auto is the empty string.

この仕様の以前の~versionでは，`page$p ~propは継承されるものと指示していたので、［ `page$p ~propを継承させ， `auto^v を常に空~文字列による名前として扱う ］ような実装も，この仕様に適合tであり続ける。 この例外は、 Level 4 においては除去されることになることに注意。 したがって，作者は、 非 `auto^v 値を伴う要素の子孫には， `auto^v 値を明示的に指定するべきでない — 結果の挙動が予測-不能になるので。 ◎ Because a previous version of this specification indicated that the page property is inherited, an implementation that inherits the page property and treats auto as always naming the empty string remains conformant to CSS Paged Media Level 3. Note that this exception will be removed in Level 4. Therefore authors should not explicitly specify the auto value on a descendant of an element with a non-auto value, as the resulting behavior will be unpredictable.

`page$p ~propは、 次に従って働く： ◎ The page property works as follows:

1. 【すべての~boxに対し，】 各~boxの `auto^v 値は、 （上で指定したとおり，） 非 `auto^v 値を伴う先祖を~~基準に解決される。 ◎ First, any auto values are resolved against non-auto ancestors (as specified above).

2. 【すべての~boxに対し，】 各~boxの `始端~pageV@ が，次に従って決定される：

   • 当の~boxに最初の子~boxは在るならば，そこから伝播される値~FNになる。
   • 他の場合、 当の~boxの `page$p ~propの使用~値になる。

   子~boxは、 自身が【最初の子~boxである, かつ】 `page$p ~propの適用-対象であるとき, そのときに限り， 自前の`始端~pageV$を【親へ】伝播する。

   【~FN 正確には、 “最初の子~boxは在る, かつ そこ（子の子孫も含む）から伝播される値は在るならば，その値” と定義されるべきであろう。 】

   各~boxの `終端~pageV@ も，最後の子~boxに関して`始端~pageV$と相似的に決定される。

   ◎ Next, a start page value and end page value is determined for each box as the value (if any) propagated from its first or last child box (respectively), else the used value on the box itself. A child propagates its own start or end page value if and only if the page property applies to it.

   注記： ［ 最初／最後 ］の子~boxは、［ 最初／最後 ］の子~要素から生成されるとは限らない。 例えば、 最初の子~要素の `display^p が `none^v であったなら，それは~boxを生成しないので、 最初の子~boxは，後続する他の同胞が生成することになる。 ◎ Note: A first or last child box is not always generated by a first or last child element. For example, an element could only have a previous sibling with 'display: none' which does not generate any box.

3. 根の`始端~pageV$が、 最初に印刷される~pageの種別になる。 ◎ The first printed page’s type is the start page value of the root.
4. `A類~分断点$にて出会う 2 個の~boxに対し，その分断に［ 先行する~boxの`終端~pageV$, 後続する~boxの`始端~pageV$ ］が合致しない場合、 それらの合間にて~page分断が強制され、 分断より後の内容は， 【後続する~boxの始端~pageVによる】 有名~種別を成す`~page~box$から再開する。 ◎ If for any two boxes meeting at a class A break point, the end page value of the box preceding the break and start page value of the box succeeding the break do not match, then a page break is forced between the two boxes, and content after the break resumes on a page box of the named type.

注記： 本質的に，比較される 2 個の `page$p 値は、 `A類~分断点$にて出会う最も深い~boxによるものになる — `page$p ~propが適用されない~boxを根とする下位treeを無視して。 ◎ Note: Essentially, the two page values compared are those from the deepest boxes meeting at the class A break point, ignoring any subtrees rooted by boxes to which the page property does not apply.

~page分断~用の追加的な詳細は `CSS-BREAK-3$r を見よ。 ◎ See [CSS-BREAK-3] for additional details on page breaks.

@page narrow {
    size: 9cm 18cm;
}
@page rotated {
    size: landscape;
}
div {
    page: narrow;
}
table {
    page: rotated;
}

<div>
<table>...</table>
<table>...</table>
<p>This text is rendered on a 'narrow' page</p>
</div>

<!DOCTYPE html>
<html lang="ja">
  <style>
    html   {
      writing-mode: vertical-rl;
      line-height: 1.6;
    }
    .main  {
      page: main;
      columns: 2;       /* 段数 */
      column-gap: 1rem; /* ~gap */
    }
    .index {
      page: index;
      columns: 3;
      column-gap: 1rem;
    }
    @page {
      margin: auto;  /* 基本版面を~page上の中央に */
      width:  40rem; /* 1.6 ~MUL 25 行l */
    }
    @page main  {
      height: 61rem; /* 2 ~~段 ~MUL 30 文字 ~PLUS 1 ~MUL ~gap */
    }
    @page index {
      height: 62rem; /* 3 ~~段 ~MUL 20 文字 ~PLUS 2 ~MUL ~gap */
    }
  </style>
  <section class="main"> ... </section>
  <section class="index"> ... </section>
</html>

~page文脈の中で適用される各種 `CSS2$r ~prop

各種 `~page~prop@ は、 以下に挙げるものとして定義される。 これらについては、 `§ ~page~prop＠#page-properties$ にて述べられている： ◎ This list defines the page properties. They are further described in § 6 Page Properties.

• `direction＠~CSS2J#direction$p
• `各種~背景~prop＠~CSSBG#backgrounds$：
  • `background-color^p
  • `background-image^p
  • `background-repeat^p
  • `background-attachment^p
  • `background-position^p
  • `background^p
• `各種~border~prop＠~CSSBORDER#borders$：
  • `border-top-width^p
  • `border-right-width^p
  • `border-bottom-width^p
  • `border-left-width^p
  • `border-width^p
  • `border-top-color^p
  • `border-right-color^p
  • `border-bottom-color^p
  • `border-left-color^p
  • `border-color^p
  • `border-top-style^p
  • `border-right-style^p
  • `border-bottom-style^p
  • `border-left-style^p
  • `border-style^p
  • `border-top^p
  • `border-right^p
  • `border-bottom^p
  • `border-left^p
  • `border^p
• `各種~counter~prop＠~CSS22/generate.html#counters$：
  • `counter-reset^p
  • `counter-increment^p
• `color＠~CSS22/colors.html#propdef-color$p
• `各種~font~prop＠~CSS22/fonts.html#fonts$：
  • `font-family^p
  • `font-size^p
  • `font-style^p
  • `font-variant^p
  • `font-weight^p
  • `font^p
• 各種~縦幅~prop： 【！CSS2J#the-height-property／CSS2J#min-max-heights】
  • `height$p
  • `min-height$p
  • `max-height$p
• `line-height$p
• `各種~margin~prop＠~CSSBOX#margin-properties$：
  • `margin-top^p
  • `margin-right^p
  • `margin-bottom^p
  • `margin-left^p
  • `margin^p
• `各種~外形線~prop＠~CSS22/ui.html#dynamic-outlines$：
  • `outline-width^p
  • `outline-style^p
  • `outline-color^p
  • `outline^p
• `各種~padding~prop＠~CSSBOX#padding-properties$：
  • `padding-top^p
  • `padding-right^p
  • `padding-bottom^p
  • `padding-left^p
  • `padding^p
• `quotes＠~CSS22/generate.html#quotes-specify$p
• `各種~text~prop＠~CSS22/text.html#text$：
  • `letter-spacing^p
  • `text-align^p
  • `text-decoration^p
  • `text-indent^p
  • `text-transform^p
  • `white-space^p
  • `word-spacing^p
• `visibility$p
• 各種~横幅~prop： 【！CSS2J#the-width-property／CSS2J#min-max-widths】
  • `width$p
  • `min-width$p
  • `max-width$p

~margin文脈の中で適用される各種 `CSS2$r ~prop

各種 `~page-margin~prop@ は、 以下に挙げるものとして定義される。 これらについては、 `§ ~page~prop＠#page-properties$ にて述べられている： ◎ This list defines the page-margin properties. They are further described in § 6 Page Properties.

• `~page~boxに適用される各種~prop＠#page-property-list$
• `unicode-bidi＠~CSS22/visuren.html#propdef-unicode-bidi$p
• `content＠~CSS22/generate.html#propdef-content$p
• `overflow＠~CSS22/visufx.html#overflow$p
• `vertical-align＠~CSS2J#line-height$p
• `visibility＠~CSS22/visufx.html#visibility$p
• `z-index$p