設定：テンプレートページ

#ページテンプレート

テンプレートページは、形を設定のテンプレートから、中身を::::page{template="…"}フェンスのMarkdownから受け取るページです。テンプレートはフレームと呼ぶ長方形に名前を付け、Markdownはそれぞれの中身を名前（スロット）でフレームに送ります。Markdownに位置や大きさが現れることはなく、テンプレートに本文が現れることもありません。本のテンプレートはpageTemplatesプロパティに入れます。

const config: PostextConfig = {
  calloutStyles: [{ id: 'caja-azul' }, { id: 'tab-titulo' }],
  pageTemplates: [
    {
      id: 'tema-cajas',
      decoration: {
        elements: [
          { kind: 'image', id: 'fondo', resourceId: '{attr.fondo}', decorative: true,
            placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill', height: 'fill' } } },
        ],
      },
      frames: [
        { name: 'titulo', takes: 'h1', style: 'tab-titulo' },
        { name: 'texto', flow: true },
        { name: 'dinero', style: 'caja-azul', padding: { right: { value: 62, unit: 'mm' } } },
        { name: 'dinero-fotos', layer: 2, width: { value: 60, unit: 'mm' },
          placement: { anchor: { to: '#dinero', edge: 'top-right' } } },
      ],
      groups: [
        { name: 'pagina', kind: 'stack', gap: { value: 6, unit: 'mm' }, frames: ['titulo', 'texto', 'dinero'] },
      ],
    },
  ],
};

idとフレーム1つだけを指定したテンプレートは、そのフレームが版面いっぱいに広がる1ページになります。ほかの項目はすべて省略できます。

#フレーム

フレームは、組まれた中身を受け取る名前付きの長方形です。nameがMarkdownの指定するスロットで、テンプレートの中で一意です（アンカーはフレームとグループを同じ書き方で指すので、グループもフレームの名前を使えません）。

テンプレートにグリッドがあればフレームはgridのセルで、なければplacementで配置します。placementはデザイン要素の配置と同じしくみで、アンカー（'container'は領域、'page'、'bleed'、ほかのフレームやグループなら'#name'）、辺、オフセット、サイズからなります。ほかのフレームに固定したフレームは、そのフレームと一緒に動きます。どちらもなければ、フレームは領域全体を占めます。

#グループ

グループは、空間を分け合って一緒に動くフレームの積み重ね（上から下）または並び（始端から終端）です。グループの中では、グループの方向に沿ったフレーム自身の位置は無視され、グループが順に並べて、あいだにgapを空けます。あるフレームの文字が増えると、その後のフレームが一緒に動きます。グループはボックスでもあり、フレームや装飾をそこに固定できます（'#pagina'）。

#継承とバリアント

extendsを持つテンプレートは、指定したテンプレート（それ自身がさらにほかのテンプレートを拡張していてもかまいません）から始まり、書いたところだけを変えます。

• area、header、overflowTemplateなどの項目は親の値を置き換えます。gridはキーごとに統合します。spread、gutter、roleも継承しますが、id、name、extendsはテンプレート自身のものです。
• framesとgroupsは名前で統合します。継承した項目と同じ名前の項目は、書いたフィールドだけを変えて残りを保ちます（fit、overflow、paddingはキーごとに統合し、placementは丸ごと置き換えます）。remove: trueはその項目を取り除き、新しい名前は継承した項目の後に加わります。
• 装飾の要素も同じようにidで統合します。新しいidの要素やidのない要素は加わります。

variants.rectoとvariants.versoはテンプレートと同じように書き、同じように統合して、右ページと左ページに適用します。適用はextendsの連鎖全体の後で、根のテンプレートのバリアントが先です。見開きは両方の側を持つので、どちらのバリアントも適用しません。

pageTemplates: [
  { id: 'tema', frames: [{ name: 'texto', flow: true }, { name: 'margen', width: { value: 30, unit: 'mm' },
      placement: { anchor: { to: 'container', edge: 'top-left' } } }],
    variants: { recto: { frames: [{ name: 'margen', placement: { anchor: { to: 'container', edge: 'top-right' } } }] } } },
  { id: 'tema-sin-margen', extends: 'tema', frames: [{ name: 'margen', remove: true }] },
]

Sandboxがテンプレートを保存するとき、既定値と同じ値も捨てずに残します。ほかのテンプレートを拡張するテンプレートやバリアントの中では、その値が親の値を上書きするからです。

コードからは、resolvePageTemplate(config, id, { parity })が、連鎖を統合し、その側のバリアントを適用し、すべての既定値を埋め、下の警告で説明するとおりにすべての参照を解決したテンプレートを返します。validatePageTemplates(config)は警告を返します。

#ラベルスタイル

labelStylesプロパティは、画像の上に置くラベルの見た目に名前を付けます。地図の海や町、図の各部の名前などです。ラベルは画像のアンカー（漫画の話し手と同じく、リソースと一緒に保存する点）に立ち、アンカーまたはラベルが指定するスタイルを使います。

labelStyles: [
  { id: 'mar', fontStyle: 'italic', textTransform: 'uppercase', letterSpacing: 0.12,
    color: { hex: '#2b6ca3', model: 'hex' } },
  { id: 'ciudad', fontWeight: 600, halo: { color: { hex: '#ffffff', model: 'hex' }, width: { value: 0.6, unit: 'pt' } } },
]

#アンカーのラベル項目

画像のアンカー（Resource.anchors、漫画が話し手に使う点）は、ラベルのための省略可能な項目をいくつか持てます。どれも画像に対する割合なので、どの言語でも、画像をどう切り抜いても成り立ちます。漫画はこれらを無視します。

#ページテンプレートの警告

ほかの設定では、エンジンは知らないキーを無視します。ページテンプレートとラベルスタイルはそうではなく検査され、問題はすべて設定の警告としてpostext checkとSandboxの検査パネルに出ます。これらの警告のpathは、問題のある項目を指すJSONポインターです。たとえば/pageTemplates/3/frames/2/style、/pageTemplates/0/variants/recto/frames/1/next、/resources/4/anchors/0/styleです。項目が継承されたものなら、ポインターはそれを書いたテンプレートを指します。存在しないidや名前を指す警告は、存在するもののうち最も近いものも示します。

テンプレート、フレーム、グループ、グリッド、fit、overflow、バリアント、ラベルスタイルのキーの綴り違いはunknownConfigKeyになります。設定の選択肢にない語（area、verticalAlign、exclude、takes、kind、align、writingMode、direction、fontStyle、textTransform）はunknownConfigValueになり、その設定は既定値のままです。idのないテンプレートや、nameのないフレームとグループは無視され、その項目にunknownConfigValueが出ます。

ページテンプレートの導入以来、設定のバージョンは15です（それ以前に書かれたバンドルはこれまでどおり読み込めます。古い設定に書かれた内容の意味は何も変わりません）。