章 3.12 · 部 II · 技法
設定:囲み
:::calloutの囲みに付ける名前付きスタイル:枠線、背景、帯、タイトル、アイコン、外側のマーカー、ラベルのタブ、角ごとの半径・辺ごとの枠線・つながったタブによる囲みの形、番号付きの定理、囲みの中の文字組み、ページをまたいで分割された囲み、囲みの中に描くデザイン
かんたんな説明
このページでは、注記、ヒント、警告、学習目標などを本文から切り離して見せる囲みを説明します。囲みの種類ごとに名前を付け、背景、枠線、色の帯、タイトル、アイコンといった見た目を決めます。教科書の定理や例題のように、囲みに番号を付けることもできます。囲みの中のフォントも選べます。長い囲みが次のページへ続くときは、その切れ目に何を示すかを選びます。
#囲みスタイル
calloutStylesプロパティは、文書が:::callout{type="…"}コンテナーで適用する名前付きの囲みスタイルを宣言します。注記、ヒント、警告、学習目標など、色付きの背景や枠線で本文から切り離して組む内容に使います。既定では中立的なスタイルnoteが1つ用意されています(薄いグレーの背景、枠線・帯・アイコン・タイトルなし)。そのため:::calloutは何も設定しなくても使えます。calloutStylesを宣言すると、この既定のリストは置き換えられます。
const config: PostextConfig = {
calloutStyles: [
{ id: 'note', name: 'Note' },
{
id: 'objectives',
name: 'Learning objectives',
title: 'Objectives',
stripe: { enabled: true, side: 'left' },
icon: { kind: 'glyph', glyph: '✓' },
titleStyle: { textTransform: 'uppercase' },
lists: { bulletChar: '–' },
},
{
id: 'warning',
title: 'Warning',
backgroundEnabled: false,
border: { enabled: true, color: { hex: '#AA0000', model: 'hex' }, width: { value: 1, unit: 'pt' } },
borderRadius: { value: 1, unit: 'mm' },
titleStyle: { color: { hex: '#AA0000', model: 'hex' } },
},
],
};:::callout{type="objectives"}
- Describe the parts of the lantern.
- Trim the wick at dusk.
:::
:::callout{type="warning" title="Do not touch the lens"}
The glass stays hot for an hour after the flame is out.
:::| プロパティ | 型 | 既定値 | 説明 |
|---|---|---|---|
id | string | — | :::callout{type="…"}で選ぶ識別子です。typeが未知または未指定のブロックには、設定した最初のスタイルが適用されます(未知のtypeはSandboxが警告します)。 |
name | string | id | 人が読むための名前です(エディターのUIでのみ使います)。 |
extends | string | — | このスタイルが元にする別のスタイルのidです。設定していない項目は、そのスタイルから受け継ぎます。ほかのスタイルを元にしたスタイルを参照してください。 |
title | string | '' | 既定のタイトルの文字列です。空ならタイトルはありません。ブロックのtitle属性で個別に上書きできます。 |
span | 'column' | 'page' | 'side' | 'column' | 横方向の広がりです。段、版面の全幅、または1段半レイアウトのフロート専用のサイド段(layout.)のいずれかです。サイド段のとき、囲みは流れから外れ、割り込んだ位置のテキストの横にあるその段に積まれます。span属性で個別に上書きできます。段組みのレイアウトでは'page'の囲みはページ幅のブロック(span block)になります。ページを段の帯に分け、全幅の独自の段に収まります(後述のコンテナーの節を参照)。そのページのサイド段に収まらないサイド段の囲みは、次のページのサイド段に置かれます。その前に章(または文書)が終わると、待っている囲みはそれぞれ、ブロックの順に、本文の後のページのサイド段に置かれ、ビルドがそれを知らせます(afterText。postext 1.24までは、そうした最初のページより後の囲みは失われていました)。 |
columns | number | 1 | フロートする囲み(placementが'auto'、'top'、'bottom'のいずれかで、span: 'column')がまたがる隣り合う段の数です。図のplacement.columnsと同じ働きで、新聞の5段のうち3段にまたがる記事の囲みなどに使います。ページの段数以上を指定すると、ページ幅の囲みになります。流れの中に組む囲み('here')は自分の段に収まります。インスタンスごとにcolumns属性で上書きできます。postext 1.18以降。 |
placement | 'here' | 'auto' | 'top' | 'bottom' | 'fixed' | 'here' | 囲みを置く場所です。'here'は流れの中にそのまま組みます。'top'/'bottom'はリソースと同じようにフロートとして配置します('auto'はページの上と下のうち先に空いた帯を使います)。囲みは現れた位置で流れから外れ、その位置以降で最初に空いている帯(現在のページの下、または流れが次に開くページの上か下)に入り、後に続くテキストがその周りのページを埋めます。'fixed'は後述のfixedでページ座標に固定し、段の流れから外します。詳しくはコンテナーの節を参照してください。placement属性で個別に上書きできます。 |
sideAtColumnEnd | 'before' | 'after' | 'before' | ブロックの後のテキストが同じ段で続かないときに、サイドの囲み(span: 'side')を置く位置です。続かないのは、段にそのテキストの入る余地がないときや、改段・改ページの規則がテキストを先へ送るとき(ウィドウとオーファンの規則で段落ごと送られる場合、見出しが本文と一緒に送られる場合)です。'before'は囲みをブロックの位置、つまりそのページで前のテキストの横に置きます。その位置から下に収まらないときは、段の下端からせり上げます。説明する箇所の後に書いた注釈に向いています。'after'はブロックの後のテキストの最初の行と高さをそろえ、そのテキストが続くページのサイド段に置きます。行の前に書いた行番号や欄外見出しに向いています。テキストが同じ段で続くときは、どちらもブロックの位置に置きます。章の中で後に何も続かない囲みは、どちらの場合も前のテキストとともに残り、続けて書いたサイドの囲みは順序を保ちます。postext 1.4まではすべてのサイドの囲みが'before'として動作しており、これが既定のままです。注釈用のスタイルでは、囲みは説明する箇所のページにとどまります。 |
fixed | { anchor?, offset? } | { anchor: { to: 'container', edge: 'bottom-left' } } | 'fixed'の囲みの位置です。ElementAnchor(to:'container'=版面、偶数ページでは左右反転、'page'=仕上がり枠、'bleed'=塗り足しを含む枠。edge:コンテナーの9つの基準位置のいずれか)と、省略できるoffset(x/yの寸法)で指定します。 |
floatBarrier | boolean | false | 囲みをフロートの区切りにします。囲みより前で参照された図や表は、すべて囲みより前に配置されます(ページの空いている場所、なければ囲みより先に開くページ)。こうして、章を締めくくる囲み(典型的には「要点」のまとめ)を越えてフロートが流れ出ることはありません。章扉、:::part、文書の末尾は常に区切りになります。 |
段組みのページにあるspan: 'page'の囲みは、直前のテキストの下で帯を切ります。囲みより前で参照された全幅の図は、先にその切れ目を使います。テキストの段の高さをそろえ、テキストが終わった位置に図を置き、囲みはその下に続きます(収まらなくなったときは次のページへ送ります)。高さをそろえたテキストの後に収まらないほど高い図は次のページの先頭に置き、囲みはその後に続きます。図が抜けた帯も高さをそろえて終わります。分割できる囲み(keepTogether: false)は、テキストと図の下で、入るだけの項目を収めて始まり、残りは次のページに続きます。 | |||
width | 'fill' | 'auto' | 'fill' | 'fill'は使える幅いっぱいに広がります。'auto'はタイトルに合わせて縮み(バッジ用)、子要素は無視します。 |
backgroundEnabled / background | boolean / ColorValue | true / #f4f4f4 | 囲みの塗りです。 |
border | { enabled, color, width, sides } | false, #cccccc, 0.5pt | 囲みの枠線です。ボックス要素の枠線と同じく、囲みの縁の内側に引きます(ボックス要素を参照)。postext 1.48以降、sidesで各辺(top、right、bottom、left)に、枠線全体の値より優先する{ enabled?, color?, width? }を指定できます。囲みの上だけの罫線や、太い下辺に使います(角、辺、つながったタブを参照)。 |
borderRadius | Dimension | { topLeft?, topRight?, bottomRight?, bottomLeft? } | 0 | 背景と枠線の角の半径です(囲みの幅と高さの半分までに制限されます)。帯もこれに従います。角の丸い囲みでは、CSSがborder-leftをborder-radiusで切り抜くのと同じように、帯を丸い枠で切り抜きます。labelのタブは、囲みとつながっていなければ角を四角いまま保ちます。postext 1.48以降は角ごとに半径を指定でき、オブジェクトに書かなかった角は四角になります。上の2つの角だけを丸めた囲みなどに使います。 |
padding | { top, right, bottom, left } | 各0.75em | 囲みの縁と内容の間の内側余白です。emの値は囲みの本文のサイズが基準です。 |
stripe | { enabled, side, width, color } | false、'left'、1.5em、メインカラー | 1辺に沿った塗りの帯です。'left'/'right'の帯は内容の幅を狭め、'top'の帯は内容を下へ押し下げます。'left'と'right'は本文の流れから見た側です(右から左の本では'left'は紙面の右になります)。'start'と'end'は囲み自身の方向に従うので、アラビア語の本の中の:::callout{dir=ltr}では'start'の帯は左に付きます。borderRadiusのある囲みでは、帯の外側の角は枠と同じく丸くなります(postext 1.4までは四角いままで、丸みからはみ出していました)。 |
icon | { kind, glyph, resourceId, fontFamily, fontWeight, size, width, color, align, position, cornerSide, shape, strokeWidth, tint } | 'none'、見出しのフォント、400、1.5em、メインカラー、'top'、'inline'、'right' | 内容の横に置く、文字のグリフ(kind: 'glyph')またはビットマップやSVGのリソース(kind: 'resource'+resourceId)です。側辺に帯があるときアイコンは帯の上の中央に置き、帯がなければ専用の列(size+titleStyle.gap)を確保します。align: 'center'は内容に対して縦方向の中央に置きます。リソースの画像は縦横比を保って正方形の中に収めます。widthを設定するとwidth×sizeの枠の中に収めます(横長のアイコンの列など)。内容より高いアイコンは、囲みをその高さまで広げます(align: 'center'のときは内容をアイコンの中央にそろえます)。position: 'corner'はアイコンをバッジとして上の角に掛け、半分を枠の外に出し、内容の場所は取りません。横長のアイコン(width)は描画される幅を基準に角の中央に置き、左の角ではタイトルをアイコンの内側の半分より先から始めます(postext 1.4までは高さを基準に置いていたため、横長の列が囲みからはみ出してタイトルに重なっていました)。cornerSideは角を選びます。'right'/'left'、左右対称の余白のページの奇偶に従う'outer'/'inner'(outerは奇数ページでは右、偶数ページでは左)、または帯と同じく囲み自身の書字方向に従う'start'/'end'です。postext 1.52 からはkind: 'shape'でアイコンを描画できます。colorで直径sizeのshape: 'ring'(輪、既定)または'dot'(点)を描き、輪の線の太さはstrokeWidth(既定はsizeの八分の一)です。フォントも画像も要らず、どの出力でも同じになります。tintはリソースの画像を一色で塗ります。trueならcolorで、色を指定すればその色で塗ります(パレットの色はパレットに従います)。一枚の輪の画像を本のどの色にも使えます。アイコンにラベルや見出しは要りません。iconがあってlabelのない囲みは、アイコンを自分の列に、position: 'corner'なら角のバッジとして置きます。 |
marker | { kind, glyph, resourceId, fontFamily, fontWeight, size, color, align, gap, rule, shape, strokeWidth, tint } | 'none'、見出しのフォント、400、1.5em、メインカラー、'center'、0.5em、罫線なし(0.5pt、メインカラー、長さ0) | 囲みの外、左側の列に描く2つ目のアイコンです。囲みとの間に縦のruleを引くこともできます。自己評価のバッジの横に置く「ここをタップ」の手のマークなどに使います。全体の枠は[marker][rule][gap][box]となり、高さは3つのうち最も高いものに合わせます。alignはそれらを互いの中央にそろえるか、上端にそろえます。rule.lengthは最小値で、罫線は常に少なくとも囲みの高さ分の長さになります。マーカーもアイコンと同じくkind: 'shape'、shape、strokeWidth、tintを使えます。 |
titleStyle | { fontFamily, fontSize, fontWeight, italic, color, textTransform, gap, letterSpacing, indent, lineHeight } | 見出しのフォント、本文のサイズ、700、false、メインカラー、'none'、0.5em、0、0、1.2em | タイトルの文字組みです。gapはタイトルと最初の子要素の間のアキです(アイコンの列とのアキにもなります)。lineHeightはタイトルの行送りで、emはタイトル自身のサイズが基準です。本文と同じく、ベースラインは各行の上から行送りの0.8の位置に来ます。そのため本文の行送りに合わせたタイトル(12 ptのグリッドでlineHeight: 12pt)なら、囲みの高さは行の整数倍のままで、タイトルもグリッドに乗ります。既定の1.2 emでは、囲みごとに1行の端数が加わります。textTransform: 'uppercase'は文字数を変えません。letterSpacingはタイトルにトラッキングをかけます(canvasのletterSpacing、PDFのTc)。indentはタイトルを囲みの内側の縁から右へ押し出します。タイトル側(左の角)に掛かる角のバッジは、先に自分の場所(バッジの内側の半分+gap)を確保するので、どのページに来てもタイトルはバッジにかかりません。indentはそれに上乗せされるだけです。letterSpacingを負の値にするとタイトルが詰まり、囲みもその幅で測ります。連結する文字(アラビア文字)のタイトルは字間を変えません。 |
body | { fontFamily, fontSize, lineHeight, color, boldColor, italicColor, fontWeight, boldFontWeight, italic, smallCaps, letterSpacing, textAlign, hyphenation, paragraphSpacing, firstLineIndent, hangingIndent, tabStops, tabInterval } | bodyTextを継承。italic/smallCapsはfalse | 囲みの中の段落とリスト項目の文字組みです。未設定のフィールドはすべて本文テキストを継承します。italicColorはイタリックの部分の色を設定します(囲みの色でイタリックにした引用文など)。fontWeight/boldFontWeightは通常と太字の部分のウェイトを設定します。italicは囲み全体をイタリックにし、*…*の部分は正体に戻ります。smallCapsは囲み全体をスモールキャピタルにします。tabStopsとtabIntervalは囲みの中で本文のものを置き換えます(タブ位置を参照)。囲みのテキストがほかに何を引き継ぐかは囲みの中の文字組みを参照してください。postext 1.42以降は、letterSpacingで囲みの段落とリスト項目の字間を調整できます。emは本文のサイズが基準で、負の値は字間を詰めます。字間は行の測定に含まれるので、数パーセント詰めて組んだ囲みは原稿と同じ位置で改行します。:::paragraphsブロック内の段落は、そのスタイル自身の字間を保ちます。このスタイルを使う枠にも同じ設定が適用されます。postext 1.71以降は、hangingIndentで囲みの段落をぶら下げインデントにできます(囲みの中の文字組みを参照)。長さを指定すると、段落スタイルのhangingIndentと同じく2行目以降をその距離まで下げます。trueにすると、bodyText.hangingIndentと同じくfirstLineIndentを1行目以外のすべての行のインデントとして読みます。 |
lists | { bulletChar, color, indent, gap, itemSpacing, bulletFontSize, bulletFontWeight, bulletFontFamily, marginTop, marginBottom } | unorderedListsを継承 | 囲みの中のリストの文字組みです(color、indent、gap、itemSpacingは番号付きリストにも適用されます)。bulletFontSize/bulletFontWeightは、行頭記号のグリフを囲みの本文の書体でそのサイズとウェイトにします(太い色付きの行頭記号など)。bulletFontFamilyは行頭記号を専用の書体(記号フォントなど)で組みます。未指定のとき、独自の書体を持つリスト(unorderedLists.や階層ごとのfontFamily)は、囲みの中でもその書体で行頭記号を組みます。marginTop/marginBottomは囲みの中のリスト(番号付きリストも)の前後のアキです。未指定のときは文書のリストのアキになります。 |
label | { fontFamily, fontSize, fontWeight, color, background, position, height, paddingX, offset, inset, icon, rule, joined, fillet, borderRadius, ownBackground } | 未設定(タブなし) | 囲みの上辺に付け、ブロックのlabel属性を印字するタブです。番号付きの囲みの番号(「BOX 1-1」)に使います。positionの角('top-right'/'top-left'、または帯の'start'/'end'と同じく囲み自身の書字方向に従う'top-start'/'top-end')に寄せてinsetだけ内側に置き、囲みの上端からoffsetだけ突き出します(この分はブロックの一部としてmarginTopに上乗せされるので、段の先頭でもタブの場所が確保されます)。高さはheightで、テキストの左右にpaddingXを取ります。横にiconリソース({ resourceId, width, gap }、角と反対側)を付けることも、上辺に沿って反対側の角からタブまでrule({ enabled, color, width })を引くこともできます。既定値は見出しのフォント、本文のサイズ、700、メインカラーの地に白、高さ1.4em、内側余白0.6em、持ち上げと内側へのずらしはなし、画像は幅1emで文字から0.3em離します。タブは枠の上に立つ独立した形なので、囲みのborderRadiusにかかわらず角は四角いままです。joined: true(postext 1.48以降)を指定すると、タブと囲みは1つの輪郭になり、filletが両者の接する内側の角を丸めます。bottom-right、bottom-left、bottom-start、bottom-endの位置(postext 1.48以降)は、タブを囲みの下端から下げ、ruleを下辺に沿って引きます。postext 1.48以降は、アイコンにフォントの文字も使えます(icon.kind: 'glyph'。タブの上のグリフを参照)。postext 1.42以降は、icon.placement: 'inside'で画像をタブの内側の先頭(右から左に組む囲みでは右端)、文字の前にgapだけ離して置けます。タブの幅は画像、間隔、文字、内側余白の合計になり、画像はicon.widthとタブの高さに収めて中央に置かれます。画像は元の色のままなので、色付きのタブの白い輪と、白いタブの色付きの輪は別々のリソースとして、スタイルごとに指定します。既定の'beside'は、タブの縁の外に画像を置きます。postext 1.43以降は、icon.tint: trueで画像を本来の色ではなくタブのcolorで描けます。画像が覆っている形を文字と同じ色で塗るので、1つの輪で本のすべての色調をまかなえます。透明部分のない画像は単色の長方形になります。PDFではSVGは縁をそのまま保ち、ビットマップは半透明になる境で切り抜かれます。印刷用の原版(svg.pdfFileId)はPDFのページで色を変えられないため使われません。postext 1.52 からはタブのアイコンも描画できます。icon: { kind: 'shape', shape: 'ring' }(または'dot')は、文字サイズのscale倍のグリフと同じ大きさで、color(既定は文字の色)で描かれ、タブの横にも中にも置けます。icon.tintにはtrueのほか色も指定できるので、色付きの輪を黒い文字の前に置けます。 |
columnGap | Dimension | 1.5em | 囲みの中の:::columnsグループの段間です(後述のコンテナーの節を参照)。 |
marginTop / marginBottom | Dimension | 0.75em / 0.75em | 囲みの上のアキ(前のブロックの下のアキと相殺されます)と、下の最小のアキ(snapToGrid: falseのときは正確なアキ)です。フロートとして配置した囲み(placement: 'top'、'bottom'、'auto')は、帯とテキストの間にフロートのアキ(本文1行分)を保ちます。それより広いmarginBottomは上の帯にある囲みの下のアキを、それより広いmarginTopは下の帯にある囲みの上のアキを決め、帯とともにグリッドに切り上げられます。postext 1.4までは、フロートとして配置した囲みはこれらのアキを無視していました。 |
snapToGrid | boolean | true | trueのとき、囲みの後の流れはベースライングリッドに戻るので、下のアキはmarginBottomをグリッドの行単位に切り上げた値になります。falseのとき、囲みは正確なmarginBottomを保ち、それが次のブロックの上のアキと相殺されます。このスタイルの囲みが2つ続けば、間隔はちょうどmax(marginBottom, marginTop)です。囲みの後のテキストは、次にグリッドに戻る位置(見出し、リストの終わり)までグリッドから外れることがあり、headings.の見出しの後と同じ動作になります。囲みを積み重ねて作る文書(ワークシート、書式)向けです。これが効くのは流れの中の囲みです。段組みのレイアウトのページ全幅の囲み、フロートとして配置した囲み、固定の囲み、サイドの囲みはグリッドを保ちます。段の帯とフロートの領域はグリッドに沿って組まれるためです。段末そろえの手段は変わりません。段を締めくくる囲みは、引き続き段の最後のグリッド位置まで押し下げられます。 |
snapTopToGrid | boolean | false | 囲みをグリッド線から始めます。前のブロックがどこで終わっても、上の間隔を次のグリッド線まで切り上げ、その間隔を含めて囲みが段に収まるかを判定します。既定ではオフです。本文の流れの中の囲みに適用され、フロート、固定、サイドの囲みはすでにグリッド上に配置された帯に入ります。Sandboxではグリッド線から始めるです。 |
keepTogether | boolean | true | trueのとき、囲みは分割しません。残りの場所に収まらない囲みは、まるごと次の段かページに送ります。分割せずに保てないのは、何も入っていない1段分(span: 'page'の囲みでは1ページ分)より高い囲みだけです。そうした囲みは、はみ出す代わりに後述のfalseの規則で分割し、現れた位置から始めます。1段に収まる続きは、そこからまるごと送ります。それほど高いフロートの囲み(placement: 'top' | 'bottom' | 'auto')はフロートにならず、現れた位置で流れの中にとどまります。falseのとき、どの囲みも子ブロックの間、または段落やリスト項目の行の間で分割できます。収まる最も深い切れ目で現在の段(span: 'page'の囲みではページ。段の下端にそろえます)を閉じ、残りは次の段の先頭で独立した囲みとして続きます。枠と帯は同じで、アイコンはなく、repeatTitleで繰り返さない限りタイトルもありません。それでも高すぎれば、さらに分割します。インラインのアイコンが先頭の部分で占める列は、どの断片でも空けたまま残すので、囲みはどのページでも同じ行長になります。リスト項目の中で切るときは、行頭記号を先頭の部分に残します。どの断片の枠もブロックのcontentIndex/containerIdを共有し、callout.part/callout.continuedを記録します。章を締めくくる長い「要点」の囲みにはheadings.と組み合わせて、また囲みが図をページから押し出してはならない注記のスタイルに使います。入れ子の囲み(別の囲みの中の:::callout)は親の子要素の1つとして扱います。切れ目はその前後に入り、入れ子の囲みの中で切るのは、そのスタイルが分割を許すとき(keepTogether: false、または1段より高いとき)だけで、そのスタイル自身のsplitMinLinesに従います。postext 1.39以降は、テンプレートページの枠と同じく本文の規則に従って切ります。見出しで断片が終わることはなく(headings.keepWithNext)、リスト項目の間で切るときは前後に少なくとも2項目を残し(bodyText. / avoidWidowsInLists。オフなら1項目)、shortListSplit: 'avoid'のもとでは、bodyText.項目以下のリストを項目の間で切りません。どの切り方も規則を満たさないときは、見出しやリストの前で断片を終えるか、項目の途中で切ります。 |
splitMinLines | number | 2 | 分割された囲み(keepTogether: false、または1段より高い分割しない囲み)の断片が、切れ目の前後それぞれに残すテキストの最小行数です。対象はテキストだけです。図、表、別行立ての数式、入れ子の囲みを1つ以上含む側は、行数にかかわらず認められるので、図版の囲みは1点だけをページに残すことがあります。段落やリスト項目の中で切るときも、前後それぞれのすべての行を数えます(そこにある図や数式は1行と数えます)。加えて、その段落や項目の行を前後それぞれに少なくともlayout.行残します(既定は2行。この最小値のほうが小さければその値なので、1にすれば1行を許します)。既定値では、2行や3行の項目は分割されず、4行の項目は2行ずつにだけ分割されます。既定値では、段の下端や次の段の先頭にテキストが1行だけ残るような分割はしません。最小値を満たす切れ目がないときは、囲みをまるごと送ります。(postext 1.5より前は、段落の中で切るときに側全体の行数しか確かめなかったため、囲みのほかの行で最小値に達すれば、2行の項目が1行ずつに分割されることがありました。) |
repeatTitle | boolean | false | 分割された囲みの続きの先頭ごとに、タイトルの後にcontinuedSuffixを付けて繰り返します(「Key points (cont.)」)。繰り返したタイトルにはタイトルのスタイルが適用されます。タイトルのない囲みは何も繰り返しません。分割された囲みの目印を参照してください。 |
continuedSuffix | string | '(cont.)' | 繰り返したタイトルの後に付ける文字列です。分割された表と同じく文書の言語(locale、なければハイフネーションのロケール)に従い、表と同じ方法でタイトルにつなげます。 |
continuesMarkerEnabled | boolean | false | 分割された囲みのうち、続きのある各部分の最終行の下、囲みの中にcontinuesMarkerを置きます。 |
continuesMarker | string | 'Continued' | そのマーカーの文字列です(脚本の「(MORE)」など)。囲みの本文の書体とサイズで組みます。既定値は分割された表と同じく文書の言語に従い、日本語では'次ページへ続く'、スペイン語では'Continúa'です。 |
continuesMarkerAlign | 'left' | 'center' | 'right' | 'right' | 囲みの内側の幅の中でマーカーを置く位置です。 |
continuesMarkerItalic | boolean | true | マーカーをイタリックで組みます。 |
numbering | { label, counter, numberingTemplate, resetOn, counterFormat, placement, bold, italic, suffix } | 未設定 | このスタイルの囲みを、定理、補題、定義のような番号付きの命題として数えます。番号付きの定理と証明を参照してください。 |
endMark | string | '' | 囲みの最終行の末尾に右端そろえで置く記号です。証明を'∎'や'□'で終えるときに使います。スペースを空けて収まれば最終行に、収まらなければ独立した行に置きます。番号のない別行立て数式で終わる囲みでは、その数式のタグとして置きます。数式が有効なときは、四角(∎ □ ■ ▪ ◻ ▫)をTeXのグリフで描くため、書体にその字形がなくても(Fontsourceのlatinファイルなど)印字されます。数式が無効なときは囲みの本文の書体で組まれます。 |
design | { enabled, slot, minHeight, setsContent } | 未設定 | 囲みのタイトルの下に内側の幅いっぱいに置く帯のデザイン。見出しのデザインと同じ要素(テキスト、画像、罫線、ボックス)で組み、囲み自身の内容を印字することもできます。囲みのデザインを参照。 |
#角、辺、つながったタブ
囲みは、4つの角が等しく枠線が1本の長方形である必要はありません。postext 1.48以降、スタイルは一部の角だけを丸め、一部の辺だけに枠線を引き、タブを囲みから1つの形として生やせます。題名のタブと本体が1つの輪郭になった教科書のカードを、ページの裏に置いた画像ではなく、スタイルで描けます。
calloutStyles: [
// Rounded at the top only, a rule over the box and a heavier foot.
{ id: 'ficha', background: { model: 'hex', hex: '#fff4d6' },
borderRadius: { topLeft: { value: 3, unit: 'mm' }, topRight: { value: 3, unit: 'mm' } },
border: { enabled: false, color: { model: 'hex', hex: '#c58b00' }, width: { value: 0.75, unit: 'pt' },
sides: { top: { enabled: true }, bottom: { enabled: true, width: { value: 2, unit: 'pt' } } } } },
// A card whose tab grows out of its top edge.
{ id: 'tarjeta', background: { model: 'hex', hex: '#ffffff' }, borderRadius: { value: 3, unit: 'mm' },
border: { enabled: true, color: { model: 'hex', hex: '#2a6f97' }, width: { value: 1, unit: 'pt' } },
label: { position: 'top-left', inset: { value: 4, unit: 'mm' }, joined: true, fillet: { value: 2, unit: 'mm' },
color: { model: 'hex', hex: '#2a6f97' } } },
]- 角:
borderRadiusは4つの角に共通の1つの長さか、{ topLeft, topRight, bottomRight, bottomLeft }です。オブジェクトに書かなかった角は四角になります。角は紙面の上での角です。2つの角が、その間の辺より多くを取ることはなく、それぞれが比率に応じて譲ります。 - 辺:
border.sides.top、right、bottom、leftはenabled、color、widthを取り、書かなかった項目は枠線全体の値になります。上辺だけに枠線のある囲みはborder: { enabled: false, sides: { top: { enabled: true } } }か、enabled: trueにしてほかの3辺を切ります。辺の内側の縁はその太さに従うので、細い辺と太い辺の間の丸い角は、CSSと同じ曲線になります。 - つながったタブ:
label.joined: trueにすると、タブと囲みは1つの輪郭、1つの塗り(囲みのbackground。タブ自身のbackgroundは塗りません)、タブの周りを回る1本の枠線になります。タブは辺の上に立ち、その高さだけ囲みの外に出るので、offsetは0でなければなりません(ほかの値はunknownConfigValueとして報告され、0として読みます)。タブの外側の角は、寄せている囲みの角の半径を取り、囲みと接する内側の角はfilletで丸めます(既定はその半径)。囲みの辺にぴったり寄せたタブ(insetが半ピクセル未満)は、その辺からまっすぐ立ち上がります。タブにはもう自分の塗りがないので、文字には囲みの塗りの上で読める色を付けます(label.color)。label.ownBackground: trueにすると、つながったタブはラベル自身のbackgroundで塗られます。ボックスの塗りの上、枠線の下に描くので、色付きのボックスに白いタブを、塗りのないボックスに色付きのタブをつなげられます。 - タブの角:
label.borderRadiusでタブに独自の角を与えます。一つの長さか、ボックスのborderRadiusと同じく紙面の角ごとの{ topLeft, topRight, bottomRight, bottomLeft }です。ボックスから離れたタブは、指定しなければ角が直角です。つながったタブは外側の二つの角をこれで丸めます(上のタブはtopLeftとtopRight、下のタブはbottomLeftとbottomRight)。指定がなければボックスの角の半径になります。へこみの曲線はどちらの場合もfilletのままです。 - 下のタブ:
position: 'bottom-right'、'bottom-left'、'bottom-start'、'bottom-end'は、タブを囲みの下端から下げます。つながったタブでも、そうでないタブでも使えます。上のタブを裏返したもので、offsetは下端より下、ruleは下辺に沿います。横のタブはありません。タブの文字は横に進むからです。
これらの形はどの出力でも描かれます。キャンバスとPDFはベクターの輪郭として、HTMLビューアーと固定レイアウトのEPUBは角ごと・辺ごとのCSSで描きます。リフロー型EPUBは角と辺をCSSに書き、つながったタブはふつうのタブとして組みます。枠のlook.border.colorはすべての辺の色を変え、部のパレットは各辺の色を変えます。角と辺がすべて同じスタイルは、これまでと同じように組まれます。
#タブの上のグリフ
label.iconには、画像の代わりにフォントの文字を置けます。kind: 'glyph'とglyph: '◉'です。タブに画像のリソースはいらず、グリフは自分の色を指定しなければ文字の色になるので、1つのスタイルで本のすべての色調をまかなえます。postext 1.48以降。
label: {
position: 'top-left', background: { model: 'hex', hex: '#0885bf' }, color: { model: 'hex', hex: '#ffffff' },
icon: { kind: 'glyph', glyph: '◉', placement: 'inside', scale: 1.1 },
}| 項目 | 型 | 既定値 | 説明 |
|---|---|---|---|
kind | 'resource' | 'glyph' | 説明を参照 | resourceIdがあれば'resource'、glyphだけなら'glyph'です。書いた場合はkindが優先され、kind: 'glyph'ならresourceIdにかかわらずグリフを置きます。 |
glyph | string | なし | アイコンとして置く文字です('◉'、'★'、'✎')。 |
fontFamily、fontWeight | string、number | ラベルの値 | グリフの書体とウェイトです。ラベル自身のもの、なければ見出しの書体と700です。その文字を持たない書体は、ブラウザーと同じく代替の書体に切り替わり、PDFではmissingGlyphが出ます。 |
scale | number | 1 | タブの文字サイズに対する倍率で表したグリフの大きさです。1では文字とベースラインを共有し、それ以外の大きさではタブの中央にとどまります。 |
color | ColorValue | ラベルのcolor | グリフの色です。指定しなければ文字の色に従い、枠のlook.label.colorは両方の色を変えます。 |
placement、gap | 'beside' | 'inside'、Dimension | 'beside'、0.3em | 画像と同じです。'inside'はグリフをタブの中の文字の前に置き、タブはその幅と間隔の分だけ広がります。'beside'はタブの縁の外に置きます。画像のwidthとtintは働きません。 |
グリフは装飾です。タグ付きPDFではレイアウトのアーティファクト、HTMLでは支援技術から隠され、リフロー型EPUBでは囲みのタイトルから外されるので、タブは文字だけで読まれます。
#ほかのスタイルを元にしたスタイル
extendsにはcalloutStylesの別のスタイルを指定します。このスタイルで設定していない項目は、すべてそのスタイルから受け継ぎます。padding、border、titleStyle、fixedのようなオブジェクトはキーごとに合成するので、内側余白の1辺だけ、あるいはfixed.offsetだけを変えられます。色と長さは丸ごと受け継ぎ、idとnameは受け継ぎません。元のスタイル自体が、さらに別のスタイルを元にしていてもかまいません。囲みをいろいろな場所に置く本では、見た目を1つのスタイルにまとめ、置き場所ごとに、場所だけを書いた小さなスタイルを作れます。
calloutStyles: [
{
id: 'caja',
background: { model: 'hex', hex: '#dff0fa' },
padding: { top: { value: 3, unit: 'mm' }, right: { value: 4, unit: 'mm' }, bottom: { value: 3, unit: 'mm' }, left: { value: 4, unit: 'mm' } },
},
{ id: 'caja-p5', extends: 'caja', placement: 'fixed', fixed: { offset: { x: { value: 12, unit: 'mm' }, y: { value: -40, unit: 'mm' } } } },
{ id: 'caja-p9', extends: 'caja', placement: 'fixed', fixed: { anchor: { to: 'container', edge: 'top-right' } } },
]cajaの見た目を変えれば、どの囲みもそれぞれの場所のまま見た目が変わります。存在しないスタイルを指すextendsはcalloutStyleExtendsUnknownの警告を出し(警告はいちばん近いidを示し、スタイルは既定値をもとに単独で使われます)、互いを元にして循環するスタイルはcalloutStyleExtendsCycleの警告を出します(どれかが循環の外のスタイルを元にするまで、単独で使われます)。Sandboxでは、囲みスタイルの元にするスタイルで設定します。ほかのスタイルの元になっているスタイルを削除すると、その設定を子のスタイルに書き込むので、囲みは変わりません。枠のスタイルの節で見た目だけを比べるを使って統合するとき、囲みを今の場所に残すがオン(既定)なら、置き場所の違うスタイルはこうした小さなスタイルとして残り、囲みは動きません(postext 1.39以降)。
#:::calloutコンテナー
:::callout{type="<id>"}の行で囲みを開き、:::だけの行で閉じます。開始行には5つの属性を書けます。type(スタイルのid)、title(スタイルのタイトルを上書き)、span、placement、columns(スタイルの値を上書き)です。間の内容は囲みの中に組まれます。省略できるタイトルの後に段落、リスト、引用、数式、リソースの埋め込みが続き、それぞれスタイルのbody/listsの文字組みで組まれます(見出しは通常のスタイルのままです)。子要素の間のアキは本文と同じく相殺されます。囲みの内部はベースライングリッドから外れ、囲みの後で流れはグリッドに戻り、下に少なくともmarginBottomのアキを取ります(グリッドが優先され、marginBottomは最小値です。リソースと同じ約束です)。snapToGrid: falseのスタイルでは代わりに正確なmarginBottomを保ち、囲みの後のテキストは次の見出しかリストの終わりまでグリッドから外れます。囲みの直前の見出しは囲みと一緒に送られます。
このバージョンでの制約は次のとおりです。
- 囲みは、スタイルで
keepTogether: falseを設定しない限り分割しません。段の残りの場所に収まらないときは、まるごと次の段かページに送ります。フロートの帯や帯の上限で短くなった空の段からも、1段分あれば収まる限り送ります。1段より高い囲みは、分割できる囲みと同じように分割します。どの切れ目でも分割できない囲み(段より高い図や表を含むもの、またはどの切れ目でもsplitMinLinesを満たせないもの)だけは、そのまま配置してはみ出させます。このときレイアウトはcalloutOverflow警告(VDTDocument.warnings)を記録し、Sandboxはそれを一覧に表示します。:::columnsグループは、それを囲む囲みと同じように、グループの段と段の間で切られます(postext 1.25から)。グループがまるごと保たれ、同じようにはみ出すことがあるのは、layout.flowColumns: falseのときと、入れ子の囲みの中にあるときだけです。分割できる囲みは、収まる部分(子要素まるごと、または前後それぞれにsplitMinLines行まで残した段落の行。図、表、別行立ての数式は1つで1つの側として足ります)を残し、次の段かページでアイコンのない囲みとして続きます。スタイルで繰り返さない限りタイトルはなく、残した部分の下にマーカーを付けることもできます(分割された囲みの目印を参照)。 - フロートは分割できない囲みに譲ります。図の参照の直後のブロックが
keepTogetherの囲みのとき、その囲みが現在の帯の中で入る段(フロートの前に囲みを収めていた参照元の段、またはその後の空の段)をなくしてしまう位置は使いません。図は次の候補の位置(たいていは次のページ)に移り、囲みは流れの中にとどまります。囲みをページから押し出して段に図だけを残すのではなく、組版者が組むとおりに組みます。 - 段組みのレイアウトで
span: 'page'を指定すると、囲みはページ幅のブロックになります。版面の全幅で組まれ、ページを段の帯に分けます。囲みの上の段は切れ目の線で閉じ、囲みは全幅の独自の段に入り、その下で新しい段の帯が始まるので、流れはすべての段で囲みの下に続きます。段の高さがそろっている位置(ページの先頭、span: 'page'の章扉の見出しの直下、別のページ幅のブロックの直下、上のフロートの帯の直下)では、囲みはそこでそのまま切ります。段の高さがそろわないページの途中に来たときは、組版者が組むとおりに組みます。囲みの上のテキストをすべての段で同じ高さに切り(エンジンは帯の段を同じグリッド行数に縮めて配置をやり直すので、テキストは段から段へ自然にあふれ、オーファン、ウィドウ、次と分離しない規則もすべて適用されます)、囲みはページ全幅に広がり、その下で段が再開します。切るには配置を何回か余分にやり直します。切れ目の線で、囲みと、その下にウィドウの最小行数分の本文行を入れる余地がなくなるとき、または数回試しても収まる配置がないときは、囲みを次のページの先頭へ送ります。囲みの上のテキストは切れ目に従います。図の下で段が上に残す数行に入りきらない段落は次の段に送り(その図は段の中で単独になります)、それでもあるブロックが切れ目を越えるときは、そのブロックの終わる位置ではなく、切れ目を1行下げます。帯を開く分割された囲みもそこで切るので、残りが切れ目を越えることはありません。headings.balancing.beforeSpan(既定)のときは、囲みが抜けた帯は章の最後の帯と同じように後ろで高さをそろえて切ります。スタイルが分割を許す(keepTogether: false)ときは、高さをそろえた段の下に収まる囲みの部分がページを締めくくり、残りが次のページの先頭に来ます。beforeSpan: falseのときは、抜けたページは通常どおり段末をそろえるだけで、改ページは強制しません。ページ幅のブロックの直前の見出しは、囲みと一緒には送られません。1段のレイアウトでは、span: 'page'はただのインラインです。 placement: 'fixed'は囲みを流れから外します。囲みは組まれた後(width: 'auto'はタイトルに合わせて縮み、'fill'はアンカーの点の下にあるテキストの段の幅を取ります)、流れの中で現れたページの、fixed.anchor/fixed.offsetが示す位置に固定されます。既定は版面の左下の角です。囲みが覆うテキストの段は、フロートの帯とまったく同じようにその領域を明け渡します(下から削り、段がまだ空なら上から削ります)。その領域にすでにテキスト、フロート、ページ幅のブロックがあるときは、囲みを次のページへ送ります。章を締めくくる固定の囲み(次のブロックが章扉、:::part、フロートの区切りの囲み、または文書の末尾のもの)は、まず上の段の高さをそろえる(headings.balancing.trailing)ので、短い最終ページは下のバッジとそろって終わります。枠と子要素はpage.floatsに入り、どのバックエンドでも段のクリップの外に描画されます。placement: 'top' | 'bottom'は囲みをリソースと同じようにフロートとして配置します。囲みは現れた位置で流れから外れ、その位置以降で最初に空いている帯(現在のページの下('bottom')、または流れが次に開くページの上か下)に、段の幅(span: 'column')または版面の全幅(span: 'page')で入ります。後に続くテキストが、囲みの抜けたページを埋めます。枠と子要素は、固定の囲みと同じくpage.floatsに入ります。新しいページの先頭に来るフロートの囲みは、そのページを待っている図より先に組まれます。前のページで引用され、その下に収まる図は、テキストが3行未満しか残らないときでも、そのページの残りを使います(図版のページ:囲みと図だけで、間にテキストはありません)。span: 'side'の囲みはフロートになりません。placementにかかわらず、テキストの横に積まれます。columnsが1より大きいとき(スタイルでもブロックの属性でも指定できます。postext 1.18以降)、span: 'column'の囲みはその数の隣り合う段を使います。上端のそろった空の段の並びの頭か、現在の段とその後の空の段の足です。例::::callout{placement="top" columns="2"}。width: 'auto'はタイトルにだけ合わせて縮み、子要素は無視します。- ほかの囲みの中に入れ子にした
:::calloutは、独立した囲みです。自分のスタイル(背景、枠線、角の半径、内側余白、帯、タイトル、アイコン、マーカー、ラベル、文字組み)で、親の内側の全幅に組まれ、親の子要素の1つとして積まれます。marginTop/marginBottomは隣の要素と相殺されます。spanとplacement(ブロックの属性でもスタイルでも)は無視され、入れ子の囲みは常に親の中を流れます。floatBarrierとsnapToGridも無視されます。囲みは何重にでも入れ子にでき、:::columnsグループの中にも置けます(それぞれ1つの段にまるごと入ります)。親が分割されるとき、切れ目は入れ子の囲みの前後に入り、入れ子のスタイルが分割を許すときはその中にも入ります。どの断片も、切れ目が通る枠を描き直します。前の断片から続く入れ子の囲みは、トップレベルの続きと同じく、タイトルとアイコンを省きます。 - 子要素の中の
:::columns{count=N}…:::グループは、囲みの中で、その子要素を等幅のN段にcolumnGapの間隔で組みます。段の高さが最もそろうブロックや行の境界で切り(途中で切れた段落やリスト項目は、次の段の先頭で行頭記号なしに続きます)、どの段もグループの上端から始まり、グループの高さは最も高い段に合わせます。グループの後の子要素は全幅に戻ります。分割される囲み(keepTogether: false、または段より高い囲み)は、グループの中でも段と段の間で切ります。snakeのグループは段を順に埋めて次の断片に続き、parallelのグループ(breaks)は流れごとに続きます(postext 1.25以降。文書形式 ›:::columnsを参照)。ブロックのgapはそのグループについてcolumnGapの代わりになり、ruleは各段間に罫線を引きます。要点を2段にまとめたり、幅の広い囲みで表を横に並べたりするのに使います。 - ブロックの6つ目の属性
labelは、スタイルのラベルタブに印字されます(前述のlabelを参照)。例::::callout{type="box" label="BOX 1-1" title="The octet rule"}。labelスタイルがなければこの属性は無視されます。
VDTでは、囲みはtype: 'callout'の枠ブロックになり、その装飾(背景、帯、アイコン、タイトル)はdesignOverlayに入ります。その後に、同じ段の中で子ブロックが続きます。枠とすべての子要素には、そのブロックのcontainerIdが付きます。入れ子の囲みは、子要素の中の独立したtype: 'callout'の枠で、その後に自分のブロックが続きます。それらはトップレベルのブロックのcontainerIdを保ち(配置と段末そろえからは1つの単位に見えます)、さらにcalloutPathが加わります。これは、周りを囲む入れ子のブロックのコンテナーidを外側から順に並べたものです(入れ子の枠自身のidが最後の要素です)。タグ付きPDFは、入れ子の囲みごとに、親の囲みの中にDivを作ります。アイコンの画像は、リソースの画像と同じ方法で取得されます。canvasの画像レジストリー、HTMLのresourceImageUrlオプション、PDFのresourceBytesプロバイダーです。リフロー型EPUBは、アイコンを囲みの先頭に支援技術から隠して書き、ページが描く位置にフロートさせます。側面の帯の上、専用の列、または上の角です。縦組みの本では行の方向に沿って置きます。一色で塗る画像(tint、#rrggbbの色)は、その色で塗ったSVGの複製として本に入ります。ビットマップはそこでは元の色のままです。
const resolved = resolveCalloutStylesConfig(config.calloutStyles, resolvedBodyText, resolvedHeadings, resolvedUnorderedLists, config.locale);
// => every inherited field filled from the resolved sections; the optional
// locale picks the language of the continuation strings
const minimal = stripCalloutStylesDefaults(config.calloutStyles);
// => undefined for the built-in `note` default; static defaults dropped#番号付きの定理と証明
numberingを設定したスタイルは、LaTeXのamsthmが定理環境を数えるように、その囲みを数えます(postext 1.19以降)。各囲みはラベルと番号を印字し(最初の段落の先頭に「定理2.」)、ブロックのtitleは番号の後に括弧に入れて続きます。:::callout{type="theorem" title="Bradley–Terry"}は「定理2(Bradley–Terry).」で始まります。識別子を付けて開いた囲み({#thm:main})は相互参照の対象になり、参照は「定理2」と印字し(:ref{id="thm:main"})、\ref{thm:main}やstyle=numberは2を印字します。
| プロパティ | 型 | 既定値 | 説明 |
|---|---|---|---|
label | string | — | 番号の前に置く語です。'定理'、'Lemma'、'Definición'など。 |
counter | string | false | スタイルのid | 囲みが進めるカウンターです。同じカウンターを指定したスタイルは、\newtheorem{lemma}[theorem]と同じようにそれを共有します(定理1、補題2、定理3)。'equation'は、ラベルを付けた数式と一緒に数えます。falseは番号なしでラベルを印字します(証明の「証明.」)。 |
numberingTemplate / resetOn / counterFormat | string / ResourceCounterReset / ResourceCounterFormat | '{n}' / 'never' / 'decimal' | リソースの種類のものと同じです。'{h1}.{n}'とresetOn: 'h1'で章ごとに定理2.1、2.2…と、'{h1}.{h2}.{n}'と'h2'で節ごとに番号を付けます。複数のスタイルが共有するカウンターは、それぞれのテンプレートが何を印字するかにかかわらず数え続けます。トークンは、リソースタイプのテンプレートと同じく、コロンの後に書式を取れます。'{h1:A}.{n}'は、アルファベットを振った付録で定理 A.1になります。 |
placement | 'runIn' | 'title' | 'runIn' | 'runIn'は囲みの最初の段落をラベルで始めます(リスト、数式、別の囲みで始まる囲みには、そのための段落を加えます)。'title'はラベルを囲みのタイトルにして、そのtitleStyleで組みます。「定理2(Bradley–Terry)」のようになります。 |
bold / italic | boolean | true / false | 段落頭のラベルとその後に付く文字の書体で、囲みの本文にかかわりません。本文がイタリック(body.italic)でも、正体のラベルは正体のままです。括弧内のタイトルは、通常のウェイトの正体で組みます。 |
suffix | string | '.' | 段落頭のラベルとそのタイトルの後に置く文字です。 |
証明は、番号のないラベルと終わりの記号を設定したスタイルです。
calloutStyles: [
{ id: 'theorem', numbering: { label: '定理' }, body: { italic: true } },
{ id: 'lemma', numbering: { label: '補題', counter: 'theorem' }, body: { italic: true } },
{ id: 'definition', numbering: { label: '定義' } },
{ id: 'proof', backgroundEnabled: false, endMark: '□',
numbering: { label: '証明', counter: false, bold: false, italic: true } },
]章ごとに組む本では、カウンターは前の章から続きます(LayoutContinuation.statementCounters。continuationAfterが埋めます)。本のアウトラインは番号付きの囲みのアンカーごとにそのラベルを与える(OutlineEntry.numberLabel)ので、別の章からの参照もそれを印字します。
#囲みの中の文字組み
囲みは内容を自分のbodyとlistsの文字組みで組みます。それ以外はすべて文書のスタイルのままです。
- 段落は囲みの
bodyに従います。書体、サイズ、行送り、色、強調の色、ウェイト、italic、smallCaps、行そろえ、ハイフネーション、字下げ、段落間隔です。未設定のフィールドはbodyTextを継承します。継承した強調の色はパレットとのリンクを保つので、囲みの中の太字、イタリック、:refのラベルは、囲みの外と同じくcolorPaletteに合わせて変わります。(postext 1.4までは、囲みの中の太字はメインカラーにかかわらず#295AA3のままでした。) - 箇条書きリストは
unorderedListsより囲みのlists(行頭記号の文字、色、グリフのサイズ、ウェイトと書体、字下げ、アキ、項目の間隔、リストの前後のアキ)を優先し、テキストは囲みの本文テキストになります。lists.bulletCharやlists.colorが文書の値(unorderedLists)と異なるときは、すべてのレベルの行頭記号や色を置き換えます。同じ値を繰り返すとき、または未設定のときは、各レベルの値(unorderedLists.levels)をそのまま残すので、入れ子のダッシュも囲みの中で保たれます。 - 番号付きリストは
lists.indent、gap、itemSpacingに従い、スタイルがlists.colorを設定していれば、文書の行頭記号の色と同じ値でもそれに従います。設定していないスタイルでは、番号はorderedLists.colorのままです。(postext 1.4までは、色がunorderedLists.colorと異なるときにしか番号に反映されなかったため、まさにその色に設定しても何も変わりませんでした。)番号そのもの(書体、サイズ、区切り)は全体のorderedListsから取ります。listsには行頭記号のフィールドしかないので、囲みの番号はそちらで設定してください。 - 囲みの中の
:::paragraphsコンテナーは、入れ子の囲みの中でも、その段落スタイルに従います。スタイルが設定しないフィールドは、囲みのbodyではなく文書のbodyTextを継承します(囲みのイタリックやスモールキャピタルも継承しません)。 :::columnsグループには独自のスタイルはありません。どの段も囲みの本文とリストの文字組みを共有し、columnGapが段間を決めます。- 引用は、囲みの本文の書体、サイズ、ウェイト(本文と同じくイタリックでグレー)と、スモールキャピタルに従います。見出しは見出しのスタイルのまま、別行立ての数式は数式の設定のままです。
- 図と表は文書のキャプションと表のスタイルのまま、囲みの内側の幅で組まれます。通常と太字のウェイトは囲みの
bodyのウェイトに従います。 - チップはチップのスタイルのままです。
emのサイズは囲みの本文のサイズを基準に読みます。 :::spaceのアキは囲みの本文の行で測ります(どこで省かれるかは:::spaceを参照)。- 入れ子の囲みは自分のスタイルにすべて従います。
span、placement、floatBarrier、snapToGridは無視されます。
ぶら下げの注記。表の下の注、番号付きの凡例、出典一覧では、記号を本文の前に突き出します。記号は囲みの内側の縁に置き、本文とその折り返しの行はすべて少し内側に下げます。body.hangingIndent(postext 1.71以降)は、このスタイルを使う囲みや枠のすべての段落をこの形に組みます。
- 長さを指定すると、1行目以外のすべての行を囲みの内側の縁からその距離に置きます。段落スタイルの
hangingIndentと同じです(段落スタイルを参照)。1行目は縁から始まり、スタイル自身がbody.firstLineIndentを設定していればその位置から始まります。bodyTextから引き継いだ1行目の字下げは使われません。 trueにすると、本文でのbodyText.hangingIndentと同じく、body.firstLineIndentを1行目以外のすべての行のインデントとして読みます。本文がぶら下げインデントの本で囲みをぶら下げずに組むにはfalseにします。未設定の場合、囲みはbodyText.hangingIndentに従います。
同じ位置にタブ位置を置くと、記号の幅にかかわらず、記号の後の文字列が折り返しの行の縁にそろいます。
calloutStyles: [{
id: 'notes',
padding: { top: { value: 0, unit: 'mm' }, right: { value: 0, unit: 'mm' }, bottom: { value: 0, unit: 'mm' }, left: { value: 0, unit: 'mm' } },
body: {
fontSize: { value: 7, unit: 'pt' },
hangingIndent: { value: 4.5, unit: 'mm' },
tabStops: [{ position: { value: 4.5, unit: 'mm' } }],
},
}],:::callout{type="notes"}
\* 価格には市内への配送料が含まれます。
\*\* 会員は半額です。この割引はほかの特典と併用できず、シーズン終了まで有効です。
:::注記はそれぞれ独立した段落にします。記号と本文の間にはタブ文字か:tabを入れます。行頭の*とタブは箇条書きの項目を始めるので、アスタリスクはエスケープしています。行はこの形で測られるので、canvas、PDF、ディスプレイリスト、EPUB(padding-inline-startと負のtext-indent)は同じように組み、Wordへの書き出しも同じぶら下げを書き込みます。リスト項目は自分のインデント(lists.indent、lists.gap)を保ち、:::paragraphsブロック内の段落はそのスタイルのインデントを保ちます。負のfirstLineIndentはこれまでどおり0として扱います。1行目が囲みの内側余白の中から始まることはありません。囲みの中の引用は、hangingIndentがtrueなら囲みと一緒にぶら下がります。長さを指定した場合にぶら下がるのは囲み自身の段落だけです。
#分割された囲みの目印
囲みが段やページをまたいで分割されるとき(keepTogether: false、または段より高い囲み)、最初の部分の後の各部分はタイトルとアイコンなしで始まり、既定では囲みが続いていることを読者に示すものは何もありません。2つのオプションで、本や脚本で使う目印を加えられます。
repeatTitle: trueにすると、続きの先頭ごとにタイトルを繰り返し、その後にcontinuedSuffixを付けます。既定は「Key points (cont.)」の形です。繰り返したタイトルにはタイトルのスタイルが適用されるので、textTransform: 'uppercase'と組み合わせれば脚本の「HAMLET (CONT'D)」になります。アイコンとラベルタブは最初の部分にだけ付きます。continuesMarkerEnabled: trueにすると、続きのある各部分の最終行の下、囲みの中にcontinuesMarker(「Continued」、スペイン語の文書では「Continúa」)を、囲みの本文の書体とサイズで置きます。continuesMarkerItalicがfalseでない限りイタリックで、continuesMarkerAlignが'left'か'center'でない限り右そろえです。マーカーは自分が締めくくる部分の中に場所を取り、切れ目はマーカーが収まるように選ばれます。
calloutStyles: [{
id: 'speech',
keepTogether: false,
titleStyle: { textTransform: 'uppercase' },
repeatTitle: true,
continuedSuffix: "(CONT'D)",
continuesMarkerEnabled: true,
continuesMarker: '(MORE)',
continuesMarkerAlign: 'center',
continuesMarkerItalic: false,
}],:::callout{type="speech" title="Hamlet"}
A speech long enough to run over the foot of the page…
:::ページを締めくくる部分は「(MORE)」で終わり、次のページは「HAMLET (CONT'D)」で始まります。どちらもページ割りのための補助的な表示です。アクセシブルなPDFではアーティファクトになり、HTMLでは支援技術から隠されるので、タイトルは1度だけ読み上げられます。VDTでは、artifact: trueの付いたdesignOverlayのテキストブロックです。
#囲みのデザイン
designは、見出しのデザインの要素(テキスト、画像、罫線、ボックス。幅と詳細デザインを参照)を、囲みのタイトルの下の帯に、囲みの内側の幅いっぱいに組みます。囲みの内容は帯の後に続き、両者の間はタイトルと同じアキになります。段やページをまたいで分割された囲みは、最初の部分にだけ帯を描きます。postext 1.45 から。
| プロパティ | 型 | 既定値 | 説明 |
|---|---|---|---|
enabled | boolean | true | デザインは設定した時点で有効になります。falseにすると、スタイルに残したまま帯を描きません。 |
slot | DesignSlot | — | 帯に対して配置する要素。anchor.to: 'container'が帯で、タイトルの下から内側の幅いっぱいに広がります。囲みの中では'page'と'bleed'のアンカーは読まれません。 |
minHeight | Dimension | 未設定 | 帯の最小の高さ。指定しなければ、帯は要素が届くところまでの高さになります。reserve: falseの要素と、帯の中央や下端にアンカーした要素は数えません。 |
setsContent | boolean | false | デザインが囲みの内容({boxText})を印字し、囲みは帯の下にその内容をもう一度組みません。デザインが内容を印字する囲みは分割されず、丸ごと次の段か次のページに移ります。 |
デザインのテキストは次のプレースホルダーを読みます。
{titleText}:囲みが印字するタイトル。フェンスのtitle、なければスタイルのタイトルです。{boxText}:囲みの内容をプレーンテキストにしたもの。段落またはリスト項目を1行に1つずつ並べ、空のものは省きます。{boxText.<n>}:n番目(1から数える)の段落またはリスト項目。囲みにそれだけの数がなければ空になります。{attr.<key>}:フェンスに書いた属性。フェンス自身が読む属性のほかに、どんな名前でも使えます。:::callout{type="card" kicker="メモ"}なら{attr.kicker}はメモになります。存在しない属性は何も印字しません。- 文書のプレースホルダー
{title}、{subtitle}、{author}、{publishDate}。
画像のresourceIdにも同じプレースホルダーが使えるため、囲みごとに別のリソースを描けます。{boxText}を読むのは囲みのデザインだけで、見出しのデザインでは何も印字されません。
setsContent: trueにすると、同じ形の囲みすべてに1つのスタイルを使い、それぞれに別の言葉を入れられます。書き方練習帳では、練習の1行ごとに、なぞる言葉を内容とする囲みを置きます。デザインはその言葉を手本の書体で印字し、続けてなぞるための点線の文字(dotted)で、行に入るだけ繰り返して組みます(repeat。インラインの書式記号と輪郭線を参照)。
calloutStyles: [{
id: 'practice',
backgroundEnabled: false,
border: { enabled: true, color: { hex: '#9aa6b2', model: 'hex' }, width: { value: 0.5, unit: 'pt' } },
design: {
setsContent: true,
minHeight: { value: 16, unit: 'mm' },
slot: { elements: [
{ kind: 'text', id: 'model', content: '{boxText}', fontFamily: 'Klee One', fontSize: { value: 26, unit: 'pt' },
placement: { anchor: { to: 'container', edge: 'top-left' } } },
{ kind: 'text', id: 'copies', content: '{boxText}', fontFamily: 'Klee One', fontSize: { value: 26, unit: 'pt' },
dotted: {}, repeat: { gap: { value: 8, unit: 'mm' } },
placement: { anchor: { to: '#model', edge: 'right-of' }, offset: { x: { value: 8, unit: 'mm' } } } },
] },
},
}],:::callout{type="practice"}
ねこ
:::
:::callout{type="practice"}
つき
:::1行目は「ねこ」を印字し、その後に点線の「ねこ」を並べます。2行目は「つき」で同じように組みます。どちらの言葉も帯の下にもう一度組まれることはありません。Markdownの言葉を書き換えると、手本もすべての写しも変わります。setsContentがfalseのままでも、デザインは同じように{boxText}を読み、内容は帯の下に組まれます。
VDTでは、帯の要素はタイトルと並んで、枠のdesignOverlayのデザインブロックになります。