かんたんな説明
電気ケトルのドイツ語の取扱説明書、7ページです。危険の度合いに応じて赤や黄色に塗り分け、警告の三角形を付けた安全上の注意の囲みの作り方を示します。
できあがり
架空の電気ケトルVerra W1の取扱説明書7ページを、A5判にドイツ語で組みます。安全上の注意のページでは、2段階の危険の度合いを囲みで示します。信号色の帯が左側を縦に走って警告の三角形を載せ、同じ色の細枠が囲みを閉じます。WARNUNGは赤、VORSICHTは黄色です。機器の損傷を示す段階のHINWEISは、帯と三角形を使わず、角丸のティールの地色にします。囲みの上の段落では、3つの信号語をすべて塗りのチップで示します。3ページ目には番号付きの引出線を付けた部品図と、その下に凡例があり、4ページ目では大きな手順番号の横に、キーの名前を枠線のチップで組みます。トラブルシューティングの表は6ページと7ページにまたがります。キャプションはAbbildungとTabelleで、分割した表には両方のページにFortsetzungと入ります。
このレシピが答える質問
- アイコン、色付きの帯、角丸を備えた注記・ヒント・警告の囲みを作るには?
- キーボードのキー、タグ、練習問題の語群などのインラインのチップを作るには?
- リストをカスタマイズするには(レベルごとの記号、(a)/(i)の番号、タスクのチェックボックス、グリッドに乗る間隔)?
- 番号付きキャプションのある図を加え、本文で参照するには(「図3.2を参照」)?
- 見出し行、結合セル、列幅、セルごとのそろえを備えた表を作るには?
- 長い表を、見出し行を繰り返し「続く」の表示を付けて、ページをまたいで分割するには?
- 「図」や「表」のラベルを文書の言語で表示するには?
手短な答え
const BAND = 8.5; // mm: a stripe on the side is the icon's column; the icon is centred on it
const [TITLE, TITLE_GAP] = [8.6, 2.4]; // pt; a box title's line is 1.2 times its size
const PAD_Y = (2 * LEAD - 1.2 * TITLE - TITLE_GAP) / 2; // pt: title and padding fill two lines
const notice = (id, hue, ink, icon) => ({ id, backgroundEnabled: false,
stripe: { enabled: true, side: 'left', width: mm(BAND), color: col(hue) },
border: { enabled: true, color: col(hue), width: pt(0.75) }, // closes the band into a frame
icon: { kind: 'resource', resourceId: icon, size: mm(5.6), align: 'top' },
padding: { top: pt(PAD_Y), right: mm(3.2), bottom: pt(PAD_Y), left: mm(3.2) },
titleStyle: { fontFamily: DISPLAY, fontWeight: 800, fontSize: pt(TITLE), color: col(ink),
textTransform: 'uppercase', letterSpacing: pt(1.3), gap: pt(TITLE_GAP) },
body: { fontSize: pt(8.8), lineHeight: pt(LEAD) }, // on the grid: a box is whole lines tall
lists: { color: col(ink), gap: mm(2) }, marginTop: pt(LEAD), marginBottom: pt(0) });
const calloutStyles = [
notice('warnung', 'warning', 'warning', 'triangle-white'), // white triangle, red '!'
notice('vorsicht', 'caution', 'ink', 'triangle-ink'), // amber type would fail contrast
{ ...notice('hinweis', 'brand', 'brand'), stripe: { enabled: false }, border: { enabled: false },
backgroundEnabled: true, background: col('tint'), borderRadius: mm(2), // property damage:
icon: { kind: 'resource', resourceId: 'info', size: mm(4.6) } }, // no band, an icon column
];
材料
- 機能
- 囲みのアイコンと角のバッジ囲み独自のリソースの種類印刷物でのリンクのアドレスインラインのチップ図を配置する参照その場に置く図図の配置データから作る表表スタイルページをまたぐ表番号付き見出し番号付きリストハイフネーションと文書の言語「図」と「表」を文書の言語でデザインした章扉見出しスタイル表紙、扉、奥付柱とノンブルページデザインのテキスト・罫・ボックス
- 種類
- Red Hat Text, Red Hat Display, Red Hat Mono (SIL OFL 1.1)
- 素材
- なし:画像はすべてコードで描画
作り方
#1 · 三角形を載せる帯
コードは前出の手短な答えにあります。stripeが左端に帯を塗ります。側面に帯のある囲みでは、アイコンは専用の列を取らず、帯の中央に置かれます(囲みスタイル)。align: 'top'でアイコンの上端をタイトルの上端にそろえます。同じ色のborderが帯を閉じて枠にします。これがないと、囲みの本文は色のついた帯の横で、紙の上にむき出しで立つことになります。PAD_Yは、タイトル、その下の間隔、上下の内側余白の合計が12.8 ptのグリッドの2行分になるように計算します。本文はグリッドの行送りを保つので、どの囲みも高さが行の整数倍になり(WARNUNGは10行、VORSICHTは8行)、marginTop: pt(LEAD)が2ページ目の2つの囲みの間をちょうど1行空けます。VORSICHTは帯と枠に黄色を使い、タイトルと箇条書きの記号は墨で組みます。白地に黄色のコントラストは2.0:1しかなく、小さな文字には4.5:1が必要だからです。HINWEISは同じ土台(...notice(…))から作り、帯と枠をオフにします。そのためinfoアイコンには専用の列が与えられ、borderRadiusが無地の地色の角を丸めます。
#2 · 図と表のドイツ語の名前
const counted = { numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }; // 1, 2…
// The built-in types in German, Abbildung and Tabelle; a table is captioned over its head.
const resourceTypes = defaultResourceTypes('de').map((type) => ({ ...type, ...counted,
...(type.id === 'table' && { captionStyle: { position: 'above' } }) }));
const tableStyle = { rules: 'horizontal', borderColor: col('rule'), borderWidth: pt(0.5),
headerBackground: col('ink'), headerColor: col('paper'), headerFontFamily: MONO,
headerFontSize: pt(7.6), bodyFontSize: pt(8.2), cellPadding: mm(1.3),
// The engine's own German strings are '(Forts.)' and 'Wird fortgesetzt': these spell them out.
continuedSuffix: '(Fortsetzung)', continuesMarker: 'Fortsetzung auf der nächsten Seite' };
locale: 'de'で取扱説明書にドイツ語のハイフネーションが適用され、組み込みの種類もドイツ語の名前になります。ほかに何も指定しなければ、キャプションはAbbildung 2.1やTabelle 5.1となり、分割した表の前半の下の注記はWird fortgesetztになります。表スタイルではこの注記とキャプションの接尾辞を省略せずに書き、defaultResourceTypes('de')は2か所を変えるために渡しています。1つ目がcountedです。resetOn: 'never'を付けた{n}で、節ごとにやり直さず取扱説明書全体を通して数えます(Abbildung 1、Tabelle 1から3)。captionStyle.position: 'above'を指定するのは表の種類だけなので、表はキャプションを上に置き、図はキャプションを下に置いたままです。
#3 · キー、信号語、部品番号をチップにする
const filled = (id, fill, ink) => ({ id, fontFamily: DISPLAY, bold: true, fontSize: em(0.82),
background: col(fill), color: col(ink), borderWidth: pt(0), paddingX: em(0.45) }); // no outline
const chipStyles = [
{ id: 'taste', fontFamily: MONO, bold: true, fontSize: em(0.92), backgroundEnabled: false,
borderColor: col('ink'), borderWidth: pt(0.6), borderRadius: pt(2.2), paddingX: em(0.4) },
filled('warnung', 'warning', 'paper'), filled('vorsicht', 'caution', 'ink'),
filled('hinweis', 'brand', 'paper'), { ...filled('nr', 'brand', 'paper'), fontSize: em(0.95),
borderRadius: em(1) }, // a part number, round like the drawing's
];
tasteは、ボタンに刷られたラベルのように、キーの名前を等幅書体で塗りなしの枠線で囲みます。信号語のチップはそれぞれの囲みの色で塗り、黄色のチップはVORSICHTのタイトルと同じく語を墨で組みます。nrは部品番号に高さの半分より大きい角丸を与えるので、図の番号付きの丸と同じ円形になります。チップのサイズは周囲のテキストのemで指定します。キーは本文中では8.6 pt、表のセルでは7.5 ptになります(チップスタイル)。
#4 · ベースラインに立つ手順番号
const orderedLists = { separator: '', fontFamily: DISPLAY, fontWeight: 800, color: col('brand'),
numberFontSize: pt(15), gap: mm(3), itemSpacing: pt(5), marginTop: pt(LEAD / 2),
marginBottom: pt(0), numberVerticalOffset: pt(-1) }; // gotcha: list-number-centred
const unorderedLists = { color: col('brand'), gap: mm(2), marginTop: pt(0), marginBottom: pt(0),
levels: [{ level: 2, bulletChar: '–', indent: mm(6.5) }, // at a step's text: number + 3 mm gap
{ level: 3, bulletChar: '–', color: col('muted') }] }; // teal •, teal –, grey –
手順は番号付きリストで、番号はRed Hat Display 800、15 pt、ティールで、区切り記号は付けません。リストの番号はベースラインに立たず、1行目の中央に置かれるので、9.3 ptの本文の横の15 ptの数字は行から約1 pt下がります。numberVerticalOffset: pt(-1)はキャプチャー上で測った値で、数字の下端をベースラインまで持ち上げます。itemSpacingで手順の間を5 pt空け、大きな数字の場所を作ります。手順の下に入れ子になった箇条書きは6.5 mmから始まり、手順の本文にそろいます。記号はティールのダッシュで、3階層目は灰色です(番号付きリスト)。
#5 · 白抜きのタブに入れる節番号
const H1 = 14, TAB = 2 * LEAD - 3.6, PAD = (TAB - H1 * 1.2) / 2; // pt: a square 2 lines less 3.6
const face = { fontFamily: DISPLAY, fontWeight: 800, fontSize: pt(H1), lineHeight: 1.2 }; // both
const section = { level: 1, numberingTemplate: '{1}', // {number}: 1, 2, 3 …
breakBefore: { enabled: false }, marginTop: pt(LEAD), marginBottom: pt(LEAD / 2), // run on
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'text', id: 'tab', content: '{number}', ...face, color: col('paper'), align: 'center',
box: { backgroundColor: col('brand'), padding: pad(PAD) },
placement: pin('container', 'top-left', 0, 0, { width: pt(TAB) }) },
{ kind: 'text', id: 'title', content: '{titleText}', ...face, color: col('ink'),
overflow: 'wrap', box: { padding: { top: pt(PAD) } }, placement: pin('#tab', 'right-of', 3) },
] } } };
各節は段内のレベル1の見出しで、デザイン要素の枠から描きます。タブはティールの正方形に{number}(numberingTemplate: '{1}'で埋まる)を白で刷り、タイトルはその3 mm右から始まります。番号とタイトルはサイズと行送りが同じなので、同じ上の内側余白でひとつのベースラインにそろいます。タブは22 ptの正方形で、12.8 ptのグリッドの2行分より3.6 pt小さいため、見出しはグリッド2行の中に収まります。表紙も番号なしの見出しスタイルで組んだレベル1の見出しなので、Sicherheitshinweisesが第1節になります。
#6 · セルを結合したトラブルシューティングの表を分割する
function faultTable(tsv) { // the first line is the head row; the widths are weights
let m = { ...parseTSV(tsv, { headerRows: 1 }), columnWidths: [30, 34, 36] };
for (let r = 2, top = 1; r < m.rows.length; r++) { // a rowspan per fault: no cut runs through it
if (m.rows[r][0].content) top = r; // mergeCells hides what it covers: merged-cells-hiddenby
else m = mergeCells(m, { start: { row: top, col: 0 }, end: { row: r, col: 0 } });
}
return m;
}
const fold = (rows, columnWidths) => ({ columnWidths, rows: rows.slice(0, rows.length / 2) // 2 up
.map((row, k) => [...row, ...rows[k + rows.length / 2]]) });
const legend = fold(parseTSV(parts).rows.map(([chip, name]) => [{ ...chip, align: 'center' },
name]), [7, 43, 7, 43]); // each part's number chip centred in its narrow column
const HERE = { placement: { position: 'here' } }; // at the resource's ::resource line
const table = (id, caption, model, styleId = 'bare', where = HERE) => ({ id, typeId: 'table',
kind: 'table', caption, table: { model, styleId }, createdAt: 0, updatedAt: 0, ...where });
const tables = [table('legende', 'Teile des Verra W1', legend),
table('daten', 'Kenndaten des VW-170', fold(parseTSV(data).rows, [20, 30, 20, 30])),
table('stoerungen', 'Störungen und ihre Behebung', faultTable(faults), null, // the house style,
{ placement: { position: 'top' } })]; // a float: it heads the page after its citation
表はそれぞれ専用のコンテンツファイルにTSVで書きます。トラブルシューティングのデータでは、最初のセルが空の行はその上の故障に属します。mergeCellsはそうした最初のセルをひとつの縦長のセルに結合し、覆われたセルを非表示にします。parseTSVは見出し行を設定しないので、headerRowCount: 1で宣言します。7ページ目で繰り返されるのがこの行です。表は1ページより高いので、分割されて次のページに続きます。position: 'top'で6ページの頭に置くフロートにします。postext 1.25からは'here'に置いても同じように分割されますが、その場合は表の後の本文が7ページのもっと下から始まり、最後の数行が8ページ目に送られます。分割は行と行の間で行われ、結合したセルの途中では切れないため、どの故障もその原因と同じページに収まります(ページより高い表)。表は5ページ目で引用され、引用の後で上のフロートを置ける最初のページである6ページ目の頭に来ます。foldはリストを半分ずつ横に並べます。凡例と技術データに使い、凡例ではalign: 'center'で番号のチップを中央にそろえます。
#7 · 紙で読む人のためのウェブアドレスとコード
廃棄の節は、ドイツの使用済み電気製品の登録機関Stiftung EARの回収場所検索を、普通のMarkdownリンクで案内しています。画面とPDFではリンクのままですが、紙ではたどれません。そこでlinks: { print: 'notes', show: 'both' }がリンクの文字のあとに注番号を付け、ページの下部にアドレスとQRコードを組みます。urlDisplay: 'short'は印刷するアドレスからhttps://と末尾のスラッシュを省き、qr: { size: mm(12), side: 'start' }は12 mmのコードを注の行の前に置きます。リンクの注は脚注なので、大きさ、色、区切り線はfootnotesで決まります。注が7ページの3行分を使うため、廃棄の段落、表の対処法の一つ、奥付を短くし、7ページに収めました(印刷物でのリンク)。
レシピの全体
// ═══ Postext Cookbook · Nº 050 · Product manual with safety notices ════════════════
// https://postext.dev/en/cookbook/product-manual-warnings
// Code: MIT · Text: original, in German (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Red Hat Text, Red Hat Display, Red Hat Mono (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage, parseTSV,
mergeCells, defaultResourceTypes, inlineSvgFonts } from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'product-manual-warnings';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#1a1f24', paper: '#ffffff', // a blue-black on white
brand: '#10727b', tint: '#e4f0f1', // the house teal (5.7:1 on white) and its pale tint
warning: '#d62e1f', caution: '#f2a900', // the signal colours of WARNUNG and VORSICHT
rule: '#cfd5da', muted: '#5b6570' }; // hairlines; running heads and notes
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.brand }) // the defaults
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, MONO] = ['Red Hat Text', 'Red Hat Display', 'Red Hat Mono'];
const PAGE = { w: 148, h: 210, top: 19, bottom: 19.4, inner: 17, outer: 13 }; // mm: A5, mirrored
const LEAD = 12.8; // pt: the body's leading and baseline grid, 38 lines to the page
const pin = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const pad = (y, x = 0) => ({ top: pt(y), bottom: pt(y), left: pt(x), right: pt(x) }); // pt
// #region answer: signal-word boxes: a band in the hazard's colour carries its triangle
const BAND = 8.5; // mm: a stripe on the side is the icon's column; the icon is centred on it
const [TITLE, TITLE_GAP] = [8.6, 2.4]; // pt; a box title's line is 1.2 times its size
const PAD_Y = (2 * LEAD - 1.2 * TITLE - TITLE_GAP) / 2; // pt: title and padding fill two lines
const notice = (id, hue, ink, icon) => ({ id, backgroundEnabled: false,
stripe: { enabled: true, side: 'left', width: mm(BAND), color: col(hue) },
border: { enabled: true, color: col(hue), width: pt(0.75) }, // closes the band into a frame
icon: { kind: 'resource', resourceId: icon, size: mm(5.6), align: 'top' },
padding: { top: pt(PAD_Y), right: mm(3.2), bottom: pt(PAD_Y), left: mm(3.2) },
titleStyle: { fontFamily: DISPLAY, fontWeight: 800, fontSize: pt(TITLE), color: col(ink),
textTransform: 'uppercase', letterSpacing: pt(1.3), gap: pt(TITLE_GAP) },
body: { fontSize: pt(8.8), lineHeight: pt(LEAD) }, // on the grid: a box is whole lines tall
lists: { color: col(ink), gap: mm(2) }, marginTop: pt(LEAD), marginBottom: pt(0) });
const calloutStyles = [
notice('warnung', 'warning', 'warning', 'triangle-white'), // white triangle, red '!'
notice('vorsicht', 'caution', 'ink', 'triangle-ink'), // amber type would fail contrast
{ ...notice('hinweis', 'brand', 'brand'), stripe: { enabled: false }, border: { enabled: false },
backgroundEnabled: true, background: col('tint'), borderRadius: mm(2), // property damage:
icon: { kind: 'resource', resourceId: 'info', size: mm(4.6) } }, // no band, an icon column
];
// #endregion
組み立てたscript.jsはそのまま動きます。任意のページのモジュールスクリプトに貼り付けるか、レシピをCodePenで開いてください。 GitHub上のレシピのフォルダー ↗ (新しいタブで開きます)
アレンジ
#図と表に節ごとの番号を振る
テンプレートに節番号を入れ、節ごとにリセットすると、部品図はAbbildung 2.1、トラブルシューティングの表はTabelle 5.1になります。
-const counted = { numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }; // 1, 2…
+const counted = { numberingTemplate: '{h1}.{n}', resetOn: 'h1', counterFormat: 'decimal' };よくあるつまずき
つまずき
'top'のフロートは参照ページの先頭を許さない限り次のページに置かれる
既定では、フロートが自分の参照より上に置かれることはありません。そのため、Nページで参照したページ幅の'top'フロートはN+1ページの頭に置かれます。リソースまたはその種類のdefaultPlacementにplacement.citingPage: trueを設定すると(本全体ならlayout.floatsAtCitingPage、postext 1.25から)、layout.maxTopFraction以内に収まり参照行がそのページに残る場合は代わりにNページの先頭に置かれ、参照より前の本文はその下に送られます。章の最初のページと強制改ページの後のページの先頭には置かれません。その場合は次のページに置かれ、'auto'または'bottom'なら参照したページの下端に入れられます。 図の配置 →
つまずき
リストの番号はベースラインではなく1行目の中央に置かれる
番号付きリストの番号はCanvasの'middle'ベースラインで描かれ、項目の1行目のベースラインからテキストの0.3 em上が基準になります。そのため、別の書体やより大きなnumberFontSizeの番号は、行の上に立つのではなく、そこから上下に広がります。ディスプレイ書体は浮き、大きな手順番号は1行目にかぶさります。orderedLists.numberVerticalOffsetで位置を調整し、結果を原寸で確認してください。目次の番号はpostext 1.5からベースラインに載りますが、リストの番号は今も中央に置かれます。 番号付きリスト →
- 段末そろえは、ページを締めくくる囲みをページの最後のグリッド行まで押し下げるので、ページに残った余白は囲みの上に開きます(段末そろえ)。2ページ目の本文は、段をちょうど埋めるように調整しました。VORSICHTの箇条書きを1つ削っても囲みは地で終わりますが、2つの囲みの間隔は4.5 mmから13.6 mmに広がります。
headings: { balancing: { enabled: false } }にすると、囲みはWARNUNGの1行下にとどまり、ページの終わりが2行足りなくなります。
クレジット
- 本文
- 書き下ろしの文章, CC BY 4.0
- フォント
- Red Hat Text (SIL OFL 1.1) · Red Hat Display (SIL OFL 1.1) · Red Hat Mono (SIL OFL 1.1)


