Saltar al contingut principal
Recepta número 58

Receptari · Capítol 1 · Pàgina i retícula

Carta comercial segons la DIN 5008

Un pressupost en alemany de dos fulls A4. L'assumpte és l'H1, i el seu disseny col·loca el membret, l'adreça i el bloc d'informació on indica la forma B.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Llicència
Actualitzada el 16 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 1 columna
  • Nunito Sans 10,5/15
  • Familjen Grotesk
  • Reddit Mono
  • 2 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 71 ms
  • 180 línies de codi

En poques paraules

Un pressupost de dues pàgines d'un taller de finestres alemany. Ensenya a col·locar l'adreça i les altres parts d'una carta comercial on indica la norma alemanya, perquè encaixi en un sobre amb finestreta.

Què compondràs

La Fensterwerkstatt Tessin, un taller berlinès inventat que restaura finestres dobles, envia un pressupost a l'administració d'una finca. Són dos fulls A4 en alemany, compostos segons la forma B de la DIN 5008. A dalt, una banda de blau de Berlín porta el logotip i el nom del taller. A sota, tot és on ho posa la norma: la línia de remitent i l'adreça, dins del camp de 85 × 45 mm que treu el cap per la finestreta d'un sobre DL; el bloc d'informació, a 125 mm de la vora esquerra; l'assumpte en negreta, dues línies en blanc sota el camp, i les marques de plec i perforació, a 105, 148,5 i 210 mm. Les dades de l'empresa ocupen tres columnes al peu de tots dos fulls. El segon repeteix la referència al costat de «Seite 2 von 2» i acaba amb una signatura dibuixada en codi.

Aquesta recepta respon a

  • Com fixo una insígnia o un adhesiu en una posició concreta de la pàgina?
  • Com afegeixo una marca d'aigua, un fons de color o una imatge decorativa a totes les pàgines?
  • Com amago les capçaleres a les obertures i a les pàgines en blanc, o pinto una pàgina parella en blanc amb el color de la part?
  • Com componc un epígraf, una dedicatòria, una signatura o una cita destacada amb una cometa gran?

La resposta curta

script.js · línies 59–78al codi complet
const at = (x, y, size) => ({ anchor: { to: 'page', edge: 'top-left' }, // mm from the corner
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const ZONE = DIN.field.y + DIN.notes; // 62.7 mm: where the six address lines start
const SUBJECT = DIN.field.y + DIN.field.h + 2 * LEAD * PT; // two blank lines under the field
const firstPage = () => ({ enabled: true, slot: { elements: [ // in paint order
  ...letterhead(), // band, logo and name, and the corners of the window
  text('from', FROM, FACE.from, at(DIN.left, ZONE - 3.6)), // the return line, underlined
  rule('from-rule', 'muted', { anchor: { to: '#from', edge: 'below' }, offset: { y: mm(0.6) },
    size: { width: mm(WINDOW) } }),
  // One attribute holds the whole address: each '\n' in it starts a new line.
  text('to', '{attr.to}', FACE.address, at(DIN.left, ZONE, { width: mm(WINDOW) })),
  ...infoBlock(), // labels, and values from {attr.*}
  text('subject', '{titleText}', FACE.subject, at(DIN.left, SUBJECT, { width: mm(TEXT) })),
] } });
// The H1 reserves the sheet down to its lowest element (gotcha: opener-reserves-anchored).
// fontFamily: the design paints the H1, but the build measures it (default: Open Sans).
const headings = () => ({ fontFamily: 'Familjen Grotesk', levels: [{ level: 1,
  breakBefore: { enabled: true, parity: 'any' }, // a letter starts on the next sheet
  marginBottom: pt(2 * LEAD), // two blank lines between the subject and the salutation
  advancedDesign: firstPage() }] });

Ingredients

Tipografia
Nunito Sans, Familjen Grotesk, Reddit Mono (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Fixa la primera pàgina al full en mil·límetres

script.js · línies 59–78al codi complet
const at = (x, y, size) => ({ anchor: { to: 'page', edge: 'top-left' }, // mm from the corner
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const ZONE = DIN.field.y + DIN.notes; // 62.7 mm: where the six address lines start
const SUBJECT = DIN.field.y + DIN.field.h + 2 * LEAD * PT; // two blank lines under the field
const firstPage = () => ({ enabled: true, slot: { elements: [ // in paint order
  ...letterhead(), // band, logo and name, and the corners of the window
  text('from', FROM, FACE.from, at(DIN.left, ZONE - 3.6)), // the return line, underlined
  rule('from-rule', 'muted', { anchor: { to: '#from', edge: 'below' }, offset: { y: mm(0.6) },
    size: { width: mm(WINDOW) } }),
  // One attribute holds the whole address: each '\n' in it starts a new line.
  text('to', '{attr.to}', FACE.address, at(DIN.left, ZONE, { width: mm(WINDOW) })),
  ...infoBlock(), // labels, and values from {attr.*}
  text('subject', '{titleText}', FACE.subject, at(DIN.left, SUBJECT, { width: mm(TEXT) })),
] } });
// The H1 reserves the sheet down to its lowest element (gotcha: opener-reserves-anchored).
// fontFamily: the design paints the H1, but the build measures it (default: Open Sans).
const headings = () => ({ fontFamily: 'Familjen Grotesk', levels: [{ level: 1,
  breakBefore: { enabled: true, parity: 'any' }, // a letter starts on the next sheet
  marginBottom: pt(2 * LEAD), // two blank lines between the subject and the salutation
  advancedDesign: firstPage() }] });

at() ancora un element per la cantonada superior esquerra a 'page', la caixa de tall (posicionament d'elements). Cada x i cada y mesuren, per tant, la distància a la cantonada del full, i les xifres de la norma es copien tal qual: l'adreça, a 25 mm de la vora esquerra i a 62,7 mm de la superior; la primera etiqueta del bloc d'informació, a 125 i 50. Tots aquests elements formen el disseny de l'H1. El text del títol és l'assumpte ({titleText}), i l'adreça i les referències en són atributs, així que el paper de cartes queda a la configuració i la carta, al Markdown. L'assumpte, a 100,6 mm, és l'element més baix, de manera que el títol reserva el full fins al peu de l'assumpte. marginBottom hi afegeix les dues línies en blanc, i la salutació comença a la línia següent de la retícula de base, a 117 mm.

L'adreça és un únic atribut amb \n entre les seves línies, i cada \n obre una línia nova al text de disseny. El títol és a la columna de text, i el seu disseny pinta igualment la banda, el logotip i el nom per damunt del marge superior de 27 mm, perquè cada element va fixat a la pàgina.

#2 · Encadena el bloc d'informació des d'una etiqueta fixa

script.js · línies 82–93al codi complet
const INFO = [['Ihr Zeichen', 'ihr-zeichen'], ['Ihre Nachricht vom', 'ihre-nachricht'],
  ['Unser Zeichen', 'unser-zeichen'], ['Name', 'name'], ['Telefon', 'telefon'],
  ['E-Mail', 'email'], ['Datum', 'datum']]; // [label, heading attribute]
const VALUE = 29; // mm from the labels to the values
const infoBlock = () => INFO.flatMap(([label, key], i) => [
  text(`label-${i}`, label, FACE.label, i === 0 ? at(DIN.info.x, DIN.info.y) : {
    anchor: { to: `#label-${i - 1}`, edge: 'below' }, // each label under the last
    offset: { y: mm(key === 'datum' ? ROW * PT : 0) } }), // a blank row before the date
  text(`value-${i}`, `{attr.${key}}`, FACE.value, { // a 12 pt row as well, on the label's baseline
    anchor: { to: `#label-${i}`, edge: 'align-top' }, offset: { x: mm(VALUE) },
    size: { width: mm(DIN.info.w - VALUE) } }),
]);

Només la primera etiqueta està fixada al full. Les altres pengen 'below' de l'anterior, i cada valor penja de la seva etiqueta amb 'align-top' i 29 mm de desplaçament, així que afegir una fila a INFO no obliga a calcular coordenades. El text de disseny situa la línia de base al 80 % de l'alçada de línia. L'etiqueta de 7 pt i el valor de 9 pt porten tots dos lineHeight: pt(ROW), una línia de 12 pt, i per això comparteixen línia de base a cada fila de 4,23 mm.

#3 · Dibuixa el membret al mateix disseny

script.js · línies 97–118al codi complet
const [BAND, TICK] = [32, 3]; // mm: the band's depth, each arm of the window's corner angles
const LOGO = { y: 7, h: 18 }; // mm: the mark, centred in the band
const CRAFTS = 3 * 7.5 * 1.45 * PT; // mm: three 7.5 pt lines at 1.45
const letterhead = () => [
  { kind: 'box', id: 'band', style: { backgroundColor: col('brand') },
    placement: at(0, 0, { width: 'fill', height: mm(BAND) }) },
  { kind: 'image', id: 'logo', resourceId: 'logo',
    placement: at(DIN.left, LOGO.y, { height: mm(LOGO.h) }) },
  text('name', 'Tessin', face('Familjen Grotesk', 30, 700, 'paper', { lineHeight: 1 }),
    { anchor: { to: '#logo', edge: 'right-of' }, offset: { x: mm(5), y: mm(1.2) } }),
  text('trade', 'FENSTERWERKSTATT · BERLIN', face('Reddit Mono', 7.5, 500, 'sky',
    { letterSpacing: pt(1.2) }), { anchor: { to: '#name', edge: 'below' },
    offset: { x: mm(0.4), y: mm(1.5) } }),
  text('crafts', 'Kastenfenster\nHolzfenster\nDenkmalpflege', face('Reddit Mono', 7.5,
    400, 'sky', { lineHeight: 1.45, align: 'right' }),
    at(210 - DIN.right - 45, LOGO.y + (LOGO.h - CRAFTS) / 2, { width: mm(45) })),
  ...[[0, 0], [1, 0], [0, 1], [1, 1]].flatMap(([right, low], i) => { // turned inwards
    const [x, y] = [DIN.field.x + right * DIN.field.w, DIN.field.y + low * DIN.field.h];
    return [rule(`across-${i}`, 'marks', at(x - right * TICK, y, { width: mm(TICK) })),
      rule(`down-${i}`, 'marks', at(x, y - low * TICK, { height: mm(TICK) }), 'vertical')];
  }),
];

La banda és una caixa fixada a la cantonada del full. width: 'fill' l'estén de vora a vora, i els seus 32 mm d'alçada la porten 5 mm per sota del marge superior, que és a 27 mm. El logotip és un element d'imatge que dibuixa un recurs de 18 mm d'alçada i pren l'amplada del mateix dibuix (elements d'imatge). El nom penja 'right-of' del logotip, i la línia de l'ofici, 'below' del nom. Vuit filets de 3 mm formen un escaire a cada cantonada del camp d'adreça, els 85 × 45 mm del full que treuen el cap per la finestreta del sobre.

#4 · Posa a la capçalera i al peu el que comparteixen tots els fulls

script.js · línies 122–144al codi complet
const header = { elements: [
  // In the H1's design they would stretch its reserve (gotcha: opener-reserves-anchored).
  ...[[DIN.folds[0], 5], [DIN.punch, 8], [DIN.folds[1], 5]].map(([y, length], i) =>
    rule(`mark-${i}`, 'marks', at(0, y, { width: mm(length) }))), // fold, punch, fold
  // Page 1 opens with the H1, which makes it an 'opener'; later sheets are 'body' pages.
  { kind: 'box', id: 'strip', pages: 'body', style: { backgroundColor: col('brand') },
    placement: at(0, 0, { width: 'fill', height: mm(4) }) },
  text('ref', 'Fensterwerkstatt Tessin · Unser Zeichen {attr.unser-zeichen} · {attr.datum}',
    FACE.small, at(DIN.left, 13.2), { pages: 'body' }),
  text('page', 'Seite {pageNumber} von {totalPages}', FACE.small,
    at(210 - DIN.right - 40, 13.2, { width: mm(40) }), { pages: 'body', align: 'right' }),
] };
const FOOT = 297 - DIN.bottom + 5; // mm: the hairline over the company data
const COMPANY = [ // three columns, 57 mm apart, inside the bottom margin
  'Fensterwerkstatt Tessin GmbH\nRennbahnstraße 48\n13086 Berlin\nTelefon 030 23125-400',
  'Geschäftsführer Martin Tessin\nAmtsgericht Charlottenburg\nHRB 000000 B\nUSt-IdNr. DE000000000',
  'Musterbank Berlin\nIBAN DE00 0000 0000 0000 0000 00\nBIC MUSTDEBBXXX',
];
const footer = { elements: [
  rule('foot-rule', 'rule', at(DIN.left, FOOT, { width: mm(TEXT) })),
  ...COMPANY.map((lines, i) => text(`company-${i}`, lines, FACE.small,
    at(DIN.left + 57 * i, FOOT + 2.5, { width: mm(52) }))),
] };

Qualsevol element del disseny de l'H1 fixat per sota de l'assumpte suma alçada a la reserva del títol. Amb la marca de plec de 210 mm al disseny, la salutació baixa a 222,8 mm i la carta passa a tres pàgines. La zona de la capçalera es pinta a totes les pàgines sense reservar espai, i per això les tres marques hi van (capçaleres i peus). La pàgina 1 comença amb l'H1, cosa que la converteix en pàgina d'obertura ('opener'), així que pages: 'body' limita la franja blava, la línia de referència i Seite {pageNumber} von {totalPages} als fulls següents. La línia de referència pren els atributs de l'H1 amb {attr.unser-zeichen} i {attr.datum}.

#5 · Col·loca la signatura al flux del text

script.js · línies 148–157al codi complet
const resourceTypes = [{ id: 'drawing', name: 'Zeichnung', shortLabel: 'Zeichnung',
  numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }];
const drawing = (id, width, height, altText, placement) => ({ id, typeId: 'drawing',
  kind: 'svg', svg: { fileId: `${id}.svg`, width, height }, altText, placement,
  createdAt: 0, updatedAt: 0 });
const resources = [ // an image element draws the logo; nothing cites it
  drawing('logo', 200, 280, 'Zeichen der Fensterwerkstatt Tessin, ein Kastenfenster'),
  drawing('signature', 760, 328, 'Unterschrift von Martin Tessin',
    { position: 'here', width: 0.297 }), // 49 × 21.1 mm: under 4 lines, no grid gap below
];

::resource{id="signature"} posa el dibuix sota «Mit freundlichen Grüßen», i width: 0.297 li dona 49 mm d'amplada i 21,1 mm d'alçada, una mica menys de quatre línies de 15 pt. El text que segueix un recurs al flux torna a la retícula de base. Amb 0.25, el dibuix feia 17,8 mm d'alçada, i els 3,4 mm que la retícula hi afegia a sota allunyaven el nom de la signatura. El tipus de recurs té el captionPrefix buit, i Postext no compon peu quan el prefix i el peu són buits, així que sota la signatura no apareix ni etiqueta ni número (tipus de recurs). El logotip és un recurs del mateix tipus, i només el dibuixa l'element d'imatge. Cap :ref ni ::resource no hi fa referència, així que mai no entra al flux.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 058 · Business letter to DIN 5008 ═════════════════════
// https://postext.dev/en/cookbook/din-business-letter
// Code: MIT · Text: original, in German (CC BY 4.0) · Logo, signature: drawn in code (CC BY 4.0)
// Fonts: Nunito Sans, Familjen Grotesk, Reddit Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A German quotation on A4 whose H1 design pins the letterhead and the address to DIN 5008.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'din-business-letter';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#1f2429', brand: '#1b4a73', // text, a blue-grey near-black; Berlin blue, for the band
  sky: '#b4cbe0', paper: '#ffffff', // the trade and the crafts on the band; the logo and name
  muted: '#5b6670', pen: '#26408f', // labels, return line, company data; the signature's ink
  marks: '#98a3ad', rule: '#c9d1d8', // fold marks, window corners; the hairline in the footer
};
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// main-color is the engine's default accent: the dashes of the list take it.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.brand })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

// DIN 5008, form B: every position in mm from the sheet's top-left corner.
const DIN = {
  left: 25, right: 20, top: 27, bottom: 30, // the margins of the text
  field: { x: 20, y: 45, w: 85, h: 45 }, // the address field, behind the envelope window
  notes: 17.7, // the field's top zone, for the return line; the address zone takes the rest
  info: { x: 125, y: 50, w: 75 }, // the information block
  folds: [105, 210], punch: 148.5, // fold marks for a DL envelope, and the punch mark
};
const TEXT = 210 - DIN.left - DIN.right; // 165 mm of text width
const WINDOW = DIN.field.w - 2 * (DIN.left - DIN.field.x); // 75 mm: text inset 5 mm each side
const PT = 25.4 / 72; // mm per point
const [LEAD, ROW] = [15, 12]; // pt: the body's leading, a row of the information block

// Design text is centred by default, and a header or footer line ends in '…': left, wrapped.
const text = (id, content, face, placement, more) => ({ kind: 'text', id, content,
  align: 'left', overflow: 'wrap', ...face, placement, ...more }); // more: pages, align
const rule = (id, colour, placement, direction = 'horizontal') => ({ kind: 'rule', id,
  direction, thickness: pt(0.5), color: col(colour), placement });
const face = (fontFamily, size, fontWeight, colour, more) => ({ fontFamily, fontSize: pt(size),
  fontWeight, color: col(colour), ...more });
const FACE = { // lineHeight: a dimension is the line's depth, a number multiplies the size
  label: face('Reddit Mono', 7, 400, 'muted', { lineHeight: pt(ROW) }),

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Errors freqüents

Error freqüent

Una obertura reserva alçada fins al seu element ancorat més baix

Una obertura de disseny avançat reserva l'alçada del seu element més baix, i també hi compten els ancorats a la pàgina o a la sang que queden per sota del títol, així que un ornament al peu de la pàgina empeny el text a la següent. Dona a aquest element reserve: false (des de postext 1.5): es pinta on està ancorat i no reserva res. Els elements que segueixen la mateixa banda (ancorats al seu peu, o d'alçada 'fill') no en fixen mai l'alçada. Obertures dissenyades →

Error freqüent

Els elements de capçalera i peu es pinten damunt del text

Els elements de capçalera i peu es pinten sobre la pàgina i l'àrea de text no els deixa lloc. Mantén-los dins dels marges, que són els que els reserven l'espai. Capçaleres i folis →

  • {totalPages} compta les pàgines de tot el document: amb dues cartes en un mateix Markdown, el segon full de la primera diria «Seite 2 von 4». Compon cada carta per separat.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Nunito Sans (SIL OFL 1.1) · Familjen Grotesk (SIL OFL 1.1) · Reddit Mono (SIL OFL 1.1)
SandboxPDF