En poques paraules
Una carta de dues cares per a un restaurant inventat de París. Ensenya a portar cada preu a la vora dreta amb un tabulador i a compondre una carta de vins en una taula sense línies visibles.
Què compondràs
La carta de tardor de Les Tanneurs, un bistrot parisenc imaginari: un sol full de 230 × 310 mm imprès per les dues cares. Al recto, un tendal a ratlles penja sobre el nom, compost en Limelight. Cada títol d'apartat va entre dos filets de llautó que arriben als marges, i a sota vénen quatre plats. Cada plat porta el nom francès en negreta amb la guarnició, la traducció en cursiva a sota i el preu en negreta, enganxat al marge dret. Un disc verd fosc amb una V marca els plats vegetarians, i una pastilla perfilada amb SG, els que no porten gluten. Cada plat és un sol paràgraf, i un tabulador porta el preu a una tabulació al marge dret. Al verso, la carta de vins va sota un prestatge d'ampolles, amb el preu de la copa i el de l'ampolla en columnes encapçalades per 12 cl i 75 cl, en una taula sense filets ni peu.
Aquesta recepta respon a
- Com faig una taula amb files de capçalera, cel·les combinades, amplades de columna i alineació per cel·la?
- Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
- Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?
- Com afegeixo imatges i taules des del codi (recursos) en lloc de ![]() de Markdown?
La resposta curta
// Each course is a :::paragraphs group in the dish style. Its one tab stop stands at the end of
// the measure and ends there the text after the tab, so `:tab **7**` sets the price flush right
// however long the dish is. A backslash at the end of the line breaks it: the dish and its
// translation are one paragraph, and the price shares the dish's first line.
const dish = { id: 'dish', name: 'Dish', textAlign: 'left', // the card is centred; a dish is not
tabStops: [{ position: 'end', align: 'end' }],
spaceBetween: pt(LEAD / 2), // half a line between two dishes: each dish 2½ lines of LEAD
marginTop: pt(LEAD), // a line of air under the course head
indent: pt(LEAD / 4), endIndent: pt(LEAD / 4) }; // in line with the wine list's cell text
// The wine list stays a table: its prices stand in two columns under the heads 12 cl and 75 cl.
// The document's tableStyle turns off every rule and fill (#region wines).
const tableStyle = { rules: 'none', cellPadding: pt(LEAD / 4), // a row: 1½ lines of LEAD
bodyFontFamily: TEXT, bodyFontSize: pt(BODY), bodyColor: col('ink'),
headerFontFamily: LABEL, headerFontSize: pt(8.5), headerColor: col('wine'),
headerBackgroundEnabled: false }; // header cells: the wine list's labels
Ingredients
- Funcions
- Tabuladors i farcimentsEstils de paràgrafTaules a partir de dadesAncoratge d'elements de dissenyEstil de taulesChips en líniaObertures dissenyadesTextos, filets i caixes als dissenys de pàginaTipus de recurs propisFigures just aquíFigures i taules com a recursosColor del paperNivells de títolPaleta de color semànticaSalts de pàgina i de columnaPàgines en un canvas
- Tipografia
- Limelight, Noticia Text, Josefin Sans (SIL OFL 1.1)
- Recursos
- The awning and the shelf of bottles, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Elaboració
#1 · Una tabulació on va el preu
El codi és a la resposta curta, més amunt. Cada apartat és un grup :::paragraphs{style="dish"}, un paràgraf per plat (estils de paràgraf). L'estil del plat té una sola tabulació, a 'end', el final de la mesura, amb align: 'end': el text que segueix un tabulador hi acaba. Així, :tab **7** després de la guarnició i els distintius porta el preu al marge dret, sigui quina sigui la llargada del plat (tabuladors i tabulacions). :tab inclou els espais que l'envolten, i la barra inversa al final de la línia és un salt de línia forçat, de manera que la traducció en cursiva comença una segona línia del mateix paràgraf i el preu es queda a la primera. spaceBetween deixa mitja línia entre dos plats, així que cada plat ocupa dues línies i mitja de l'interlineat de 14,5 pt. indent i endIndent d'un quart de línia alineen els plats amb el text de les cel·les de la carta de vins del verso. Un paràgraf amb tabuladors es compon línia a línia; aquí totes les línies van en bandera igualment.
#2 · Un sol tipus de recurs, al seu lloc i sense número
// No caption prefix and no caption, so no 'Table 1' line prints under the wine list. Placement
// 'here' sets each piece at its ::resource line; a list that outgrows the page is cut
// between rows and goes on at the head of the next one.
const resourceTypes = [{ id: 'menu', name: 'Menu', shortLabel: 'Menu', captionPrefix: '',
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
defaultPlacement: { position: 'here' } }];
const piece = (id, kind, body) => ({ id, typeId: 'menu', kind, createdAt: 0, updatedAt: 0,
...body });
Els tipus de figura i taula que porta el motor imprimeixen una línia de peu i fan flotar cada recurs al primer espai lliure després de la primera referència. El tipus menu no té prefix de peu i les seves peces no porten peu, així que sota els dibuixos i la carta de vins no s'imprimeix res. Amb captionPrefix: 'Menu', cada peça porta a sota una línia numerada, començant per «Menu 1.» sota el tendal, i la carta passa a quatre pàgines. defaultPlacement col·loca la carta de vins i cada dibuix a la seva línia ::resource (inserció en bloc). Sense ell, la carta de vins flota al peu del verso, sota Le Comptoir i el colofó. El tendal i les ampolles són recursos SVG del mateix tipus, dibuixats en codi i registrats amb la funció loadSvg del kit.
#3 · Combina les files de regió
function wineList(tsv) {
let m = { ...parseTSV(tsv, { headerRows: 1 }), columnWidths: [5, 1, 1] }; // the head row
m.rows = m.rows.map((row, r) => row.map((cell, c) => (c === 0 ? cell : { ...cell, align: 'right',
content: r > 0 && cell.content ? `**${cell.content}**` : cell.content }))); // as the dishes'
m.rows.forEach(([first, ...rest], r) => { // a line with one field names a region
if (r === 0 || !first.content || rest.some((cell) => cell.content)) return;
// One cell across the table, centred on the card like the course heads; a label centred
// in the first column alone would sit 22.6 mm left of them. The label face is the header's.
m.rows[r][0] = { ...first, isHeader: true, align: 'center' };
// mergeCells marks the two cells it covers hiddenBy (gotcha: merged-cells-hiddenby).
m = mergeCells(m, { start: { row: r, col: 0 }, end: { row: r, col: 2 } });
});
return piece('wines', 'table', { table: { model: m } });
}
La carta de vins continua sent una taula: els seus dos preus van en columnes sota les capçaleres, 12 cl i 75 cl, que una fila de tabulacions deixaria sense capçalera. parseTSV(tsv, { headerRows: 1 }) llegeix la primera línia com a fila de capçalera, així que Appellation · cépage, 12 cl i 75 cl surten sobre les seves columnes en Josefin Sans, la lletra de les cel·les de capçalera. Una línia amb un sol camp dona nom a una regió. La seva cel·la passa a ser de capçalera, centrada, i mergeCells l'estén per les tres columnes i marca amb hiddenBy les dues que cobreix (construir models de taula). Centrat només a la primera columna, BLANCS quedaria 22,6 mm a l'esquerra de l'eix de la carta, sobre el qual van La Cave i Le Comptoir. Una línia en blanc del TSV es converteix en una fila de cel·les buides, d'una línia i mitja d'alt, que deixa aire sobre Blancs i Rouges.
#4 · Penja un filet a cada costat del títol d'apartat
// The title has no width, so it shrink-wraps its text, and 'top' centres it on the column. Each
// rule hangs off one edge of the title ('left-of', 'right-of'), 4 mm away, and 'fill' runs it
// to the column's edge: 66.7 mm beside PLATS, 56.2 mm beside the longer LE COMPTOIR.
const rule = (edge, x) => ({ kind: 'rule', id: `rule-${edge}`, color: col('brass'),
thickness: pt(0.75), // heavier than the default 0.5 pt hairline
placement: { anchor: { to: '#title', edge },
size: { width: 'fill' }, // to the column's edge
offset: { x: mm(x), y: pt(6) } } }); // 6 pt down: the middle of Limelight's capitals
const courseHead = { enabled: true, slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(15),
lineHeight: 0.96, // 14.4 pt: the title stays inside one 14.5 pt grid line
textTransform: 'uppercase', color: col('wine'),
placement: { anchor: { to: 'container', edge: 'top' } } },
rule('left-of', -4), rule('right-of', 4),
] } };
Un títol d'apartat és un disseny dins de la columna. L'element {titleText} no té amplada, així que la seva caixa fa el que fan les seves majúscules, i l'àncora 'top' el centra a la columna. Cada filet penja d'una vora del títol amb 'left-of' o 'right-of' i s'estira fins a la vora de la columna (posicionament d'elements), de manera que els filets al costat de PLATS fan 66,7 mm i els de LE COMPTOIR 56,2 mm, sempre a 4 mm de les lletres. El lineHeight del títol és un múltiple, 0,96, que deixa la seva caixa en 14,4 pt, dins d'una línia de 14,5 pt de la retícula. Amb 1, la caixa fa 15 pt, cada títol ocupa dues línies i la carta passa a quatre pàgines.
#5 · Distintius en xips, lletra petita en estils de paràgraf
// A chip is a box around inline text: the V disc is filled, the SG pill only outlined. A chip
// takes the weight of the text around it, so without bold the V is set in 400, a weight not loaded.
const badge = { fontFamily: LABEL, fontSize: pt(7.5), bold: true, // Josefin Sans 700
borderRadius: pt(8), paddingY: em(0.1), gap: em(0.6) }; // radius clamped to a half-height
const chipStyles = [
// V: paddingX makes the box as wide as it is tall, a disc. borderWidth 0 removes the default
// outline, 0.5 pt of main-color, which would ring the green in wine red.
{ id: 'veg', name: 'Vegetarian', ...badge, paddingX: em(0.3), borderWidth: pt(0),
background: col('bottle'), color: col('paper') },
{ id: 'gf', name: 'Gluten-free', ...badge, paddingX: em(0.45), backgroundEnabled: false,
borderColor: col('bottle'), borderWidth: pt(0.6), color: col('bottle') },
];
// The notes under the desserts and the colophon on the back: smaller, on the card's axis, a
// line of air above each.
const paragraphStyles = [dish,
{ id: 'notes', name: 'Notes', fontSize: pt(9), marginTop: pt(LEAD) },
{ id: 'colophon', name: 'Colophon', fontSize: pt(7.5), color: col('muted'),
marginTop: pt(LEAD) },
];
Un xip dibuixa una caixa al voltant d'un tros de text en línia (estils de xip), així que :chip[V]{style="veg"}, escrit després de la guarnició, posa el disc a la línia francesa del plat, abans del tabulador. Els estils de xip porten bold: true perquè un xip pren el gruix del text que l'envolta, i després de la guarnició aquest text és de gruix 400, que FONTS no carrega per a Josefin Sans. Les notes sota les postres i el colofó del verso són blocs :::paragraphs de 9 i 7,5 pt, i els dos estils porten un marginTop d'una línia (estils de paràgraf). Sense aquest marge, les notes comencen a la línia que segueix la traducció dels formatges, com si formessin part del plat.
#6 · Centra la carta sobre un eix
// bodyText (in config) centres the lines under the name and the notes; only the dishes and the
// wine list keep a left edge. Ragged text is hyphenated only with bodyText.hyphenation.ragged,
// so no word on this card is divided, the French dish names included. The config's locale
// names each edition's language, English or Spanish, for the bundle the Sandbox opens.
const headings = { fontFamily: DISPLAY, fontWeight: 400, color: col('wine'), textAlign: 'center',
levels: [ // Limelight ships one weight, 400, and no italic
// The H1 break is off: by default an H1 opens a recto, which would part the name from the
// awning and La Cave from its bottles.
{ level: 1, fontSize: pt(48), lineHeight: pt(3 * LEAD), breakBefore: { enabled: false },
marginTop: pt(LEAD), marginBottom: pt(0) }, // three grid lines, one of air above
{ level: 2, lineHeight: pt(LEAD), advancedDesign: courseHead, // one line; #region heads
marginTop: pt(LEAD), marginBottom: pt(0) }, // the dishes below add a line of their own
] };
headings.textAlign i bodyText.textAlign porten a l'eix de la carta tot excepte els plats i la carta de vins. lineHeight: pt(3 * LEAD) dona al nom de 48 pt tres línies de la retícula. Sense ell, el nom pren l'interlineat per defecte i ocupa quatre línies; la segona línia de notes passa llavors a una pàgina pròpia i la carta arriba a quatre pàgines. El nivell 1 desactiva el salt de l'H1, breakBefore: { enabled: false }, perquè el nom i La Cave van a la pàgina del dibuix que tenen a sobre. Si deixes el valor per defecte, { enabled: true, parity: 'always-odd' }, cada dibuix es queda sol a la seva pàgina i la carta arriba a set. La configuració no fixa cap locale: en aquesta carta no hi ha res justificat, i el text en bandera només aplica la partició de mots amb bodyText.hyphenation.ragged activat.
La recepta completa
// ═══ Postext Cookbook · Nº 052 · Bistro menu: prices on a tab stop ═══════════════════
// https://postext.dev/en/cookbook/bistro-menu
// Code: MIT · Text: original, in French (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Limelight, Noticia Text, Josefin Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// The autumn menu of an imaginary Paris bistro: two sides of one card, each dish a paragraph
// whose price a tab sends to the right margin, the wine list a table with no rules.
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage, parseTSV,
mergeCells,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'bistro-menu';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#1f2a24', paper: '#f6efdf', // green-black text on cream card
wine: '#6d1f2c', brass: '#a9823a', // the name, heads and labels; rules and the drawings' metal
straw: '#e8d4a8', bottle: '#2f4235', sage: '#8a9a78', // awning stripes and labels; glass
muted: '#6b6457' }; // the colophon
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color' (#295aa3, a blue); this palette makes it the wine red.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.wine })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Noticia Text', 'Limelight', 'Josefin Sans'];
const [BODY, LEAD] = [10.5, 14.5]; // pt: the text, and the leading every table row keeps
// #region answer: dish on the left, price flush right: a tab stop at the end of the measure
// Each course is a :::paragraphs group in the dish style. Its one tab stop stands at the end of
// the measure and ends there the text after the tab, so `:tab **7**` sets the price flush right
// however long the dish is. A backslash at the end of the line breaks it: the dish and its
// translation are one paragraph, and the price shares the dish's first line.
const dish = { id: 'dish', name: 'Dish', textAlign: 'left', // the card is centred; a dish is not
tabStops: [{ position: 'end', align: 'end' }],
spaceBetween: pt(LEAD / 2), // half a line between two dishes: each dish 2½ lines of LEAD
marginTop: pt(LEAD), // a line of air under the course head
indent: pt(LEAD / 4), endIndent: pt(LEAD / 4) }; // in line with the wine list's cell text
// The wine list stays a table: its prices stand in two columns under the heads 12 cl and 75 cl.
// The document's tableStyle turns off every rule and fill (#region wines).
const tableStyle = { rules: 'none', cellPadding: pt(LEAD / 4), // a row: 1½ lines of LEAD
bodyFontFamily: TEXT, bodyFontSize: pt(BODY), bodyColor: col('ink'),
headerFontFamily: LABEL, headerFontSize: pt(8.5), headerColor: col('wine'),
headerBackgroundEnabled: false }; // header cells: the wine list's labels
// #endregion
// #region type: one resource type for the whole card: set where it stands, never numbered
// No caption prefix and no caption, so no 'Table 1' line prints under the wine list. Placement
// 'here' sets each piece at its ::resource line; a list that outgrows the page is cut
// between rows and goes on at the head of the next one.
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)
Variants
#Fixa la longitud dels filets
Una amplada fixa en lloc de 'fill' deixa cada filet en 20 mm, a 4 mm del títol, així que al costat de PLATS la parella queda més a prop del centre que al costat de LE COMPTOIR.
- size: { width: 'fill' }, // to the column's edge
+ size: { width: mm(20) }, // 20 mm, wherever the title ends#Porta punts fins al preu
Un farciment omple l'espai que hi ha abans de la tabulació. '. ' repeteix un punt i un espai, des de mig em després de l'últim distintiu o l'última paraula del plat fins a mig em abans del preu.
- tabStops: [{ position: 'end', align: 'end' }],
+ tabStops: [{ position: 'end', align: 'end', leader: '. ' }],#Ratlla la carta de vins com un llibre de comptes
rules: 'horizontal' traça un filet de llautó de 0,5 pt a sobre i a sota de cada fila de la carta de vins. Els filets no ocupen espai, així que les dues cares conserven la composició, i les files en blanc sobre Blancs i Rouges també porten el seu parell de filets.
-const tableStyle = { rules: 'none', cellPadding: pt(LEAD / 4), // a row: 1½ lines of LEAD
+const tableStyle = { rules: 'horizontal', borderColor: col('brass'),
+ borderWidth: pt(0.5), cellPadding: pt(LEAD / 4),Errors freqüents
Deixa lloc per al preu a la primera línia del plat. Quan el plat i la guarnició passen del lloc que necessita el preu, la tabulació s'emporta l'última paraula del plat a la línia següent juntament amb el preu, i la traducció ve al darrere: llavors el plat ocupa tres línies i l'apartat acaba una línia més avall.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- The awning and the shelf of bottles, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fonts
- Limelight (SIL OFL 1.1) · Noticia Text (SIL OFL 1.1) · Josefin Sans (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


