Saltar al contenido principal
Receta número 52

Recetario · Capítulo 8 · Tablas

Carta de bistró: precios en una tabulación

Una carta de bistró a dos caras: precios en una tabulación al margen derecho, vinos en una tabla sin filetes y un filete de latón a cada lado de cada título.

En esta página
  • Formato 230 × 310 mm
  • 1 columna
  • Noticia Text 10,5/14,5
  • Josefin Sans
  • Limelight
  • 2 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 44 ms
  • 154 líneas de código

En pocas palabras

Una carta de dos caras para un restaurante inventado de París. Enseña a llevar cada precio al borde derecho con un tabulador y a componer una carta de vinos en una tabla sin líneas visibles.

Lo que vas a componer

La carta de otoño de Les Tanneurs, un bistró parisino imaginario: una sola hoja de 230 × 310 mm impresa por las dos caras. En el anverso, un toldo a rayas cuelga sobre el nombre, compuesto en Limelight. Cada título de apartado va entre dos filetes de latón que llegan a los márgenes, y debajo vienen cuatro platos. Cada plato lleva el nombre francés en negrita con su guarnición, la traducción en cursiva debajo y el precio en negrita, pegado al margen derecho. Un disco verde oscuro con una V marca los platos vegetarianos, y una pastilla perfilada con SG, los que no llevan gluten. Cada plato es un solo párrafo, y un tabulador lleva su precio a una tabulación en el margen derecho. En el dorso, la carta de vinos va bajo un estante de botellas, con el precio de la copa y el de la botella en columnas encabezadas por 12 cl y 75 cl, en una tabla sin filetes ni pie.

Esta receta responde a

  • ¿Cómo hago una tabla con filas de cabecera, celdas combinadas, anchos de columna y alineación por celda?
  • ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
  • ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
  • ¿Cómo añado imágenes y tablas desde el código (recursos) en lugar de ![]() de Markdown?

La respuesta corta

script.js · líneas 28–42en el código completo
// 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

Ingredientes

Tipografía
Limelight, Noticia Text, Josefin Sans (SIL OFL 1.1)
Recursos
  • El toldo y el estante de botellas, dibujados en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)

Elaboración

#1 · Una tabulación donde va el precio

El código está en la respuesta corta, más arriba. Cada apartado es un grupo :::paragraphs{style="dish"}, un párrafo por plato (estilos de párrafo). El estilo del plato tiene una sola tabulación, en 'end', el final de la medida, con align: 'end': el texto que sigue a un tabulador termina en ella. Así, :tab **7** tras la guarnición y los distintivos lleva el precio al margen derecho, sea cual sea la longitud del plato (tabuladores y tabulaciones). :tab absorbe los espacios que lo rodean, y la barra invertida al final de la línea es un salto de línea forzado, de modo que la traducción en cursiva empieza una segunda línea del mismo párrafo y el precio se queda en la primera. spaceBetween deja media línea entre dos platos, así que cada plato ocupa dos líneas y media del interlineado de 14,5 pt. indent y endIndent de un cuarto de línea alinean los platos con el texto de las celdas de la carta de vinos del dorso. Un párrafo con tabuladores se compone línea a línea; aquí todas las líneas van en bandera de todos modos.

#2 · Un solo tipo de recurso, en su sitio y sin número

script.js · líneas 46–53en el código completo
// 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 });

Los tipos de figura y tabla que trae el motor imprimen una línea de pie y hacen flotar cada recurso al primer hueco libre después de su primera referencia. El tipo menu no tiene prefijo de pie y sus piezas no llevan pie, así que bajo los dibujos y la carta de vinos no se imprime nada. Con captionPrefix: 'Menu', cada pieza lleva debajo una línea numerada, empezando por «Menu 1.» bajo el toldo, y la carta pasa a cuatro páginas. defaultPlacement coloca la carta de vinos y cada dibujo en su línea ::resource (inserción en bloque). Sin él, la carta de vinos flota al pie del dorso, bajo Le Comptoir y el colofón. El toldo y las botellas son recursos SVG del mismo tipo, dibujados en código y registrados con la función loadSvg del kit.

#3 · Combina las filas de región

script.js · líneas 57–70en el código completo
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 vinos sigue siendo una tabla: sus dos precios van en columnas bajo sus cabeceras, 12 cl y 75 cl, que una fila de tabulaciones dejaría sin cabecera. parseTSV(tsv, { headerRows: 1 }) lee la primera línea como fila de cabecera, así que Appellation · cépage, 12 cl y 75 cl salen sobre sus columnas en Josefin Sans, la letra de las celdas de cabecera. Una línea con un solo campo da nombre a una región. Su celda pasa a ser de cabecera, centrada, y mergeCells la extiende por las tres columnas y marca con hiddenBy las dos que cubre (construir modelos de tabla). Centrado solo en la primera columna, BLANCS quedaría 22,6 mm a la izquierda del eje de la carta, sobre el que van La Cave y Le Comptoir. Una línea en blanco del TSV se convierte en una fila de celdas vacías, de línea y media de alto, que deja aire sobre Blancs y Rouges.

#4 · Cuelga un filete a cada lado del título de apartado

script.js · líneas 74–88en el código completo
// 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ítulo de apartado es un diseño dentro de la columna. El elemento {titleText} no tiene ancho, así que su caja mide lo que sus mayúsculas, y el ancla 'top' lo centra en la columna. Cada filete cuelga de un borde del título con 'left-of' o 'right-of' y se estira hasta el borde de la columna (colocación de elementos), de modo que los filetes junto a PLATS miden 66,7 mm y los de LE COMPTOIR 56,2 mm, siempre a 4 mm de las letras. El lineHeight del título es un múltiplo, 0,96, que deja su caja en 14,4 pt, dentro de una línea de 14,5 pt de la rejilla. Con 1, la caja mide 15 pt, cada título ocupa dos líneas y la carta pasa a cuatro páginas.

#5 · Distintivos en chips, letra pequeña en estilos de párrafo

script.js · líneas 92–110en el código completo
// 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 chip dibuja una caja alrededor de un trozo de texto dentro de la línea (estilos de chip), así que :chip[V]{style="veg"}, escrito tras la guarnición, pone el disco en la línea francesa del plato, antes del tabulador. Los estilos de chip llevan bold: true porque un chip toma el peso del texto que lo rodea, y tras la guarnición ese texto es de peso 400, que FONTS no carga para Josefin Sans. Las notas bajo los postres y el colofón del dorso son bloques :::paragraphs de 9 y 7,5 pt, y los dos estilos llevan un marginTop de una línea (estilos de párrafo). Sin ese margen, las notas empiezan en la línea que sigue a la traducción de los quesos, como si fueran parte del plato.

#6 · Centra la carta sobre un eje

script.js · líneas 114–126en el código completo
// 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 y bodyText.textAlign llevan al eje de la carta todo menos los platos y la carta de vinos. lineHeight: pt(3 * LEAD) da al nombre de 48 pt tres líneas de la rejilla. Sin él, el nombre toma el interlineado por defecto y ocupa cuatro líneas; la segunda línea de notas pasa entonces a una página propia y la carta llega a cuatro páginas. El nivel 1 desactiva el salto del H1, breakBefore: { enabled: false }, porque el nombre y La Cave van en la página del dibujo que tienen encima. Si dejas el valor por defecto, { enabled: true, parity: 'always-odd' }, cada dibujo se queda solo en su página y la carta llega a siete. La configuración no fija ningún locale: en esta carta no hay nada justificado, y el texto en bandera solo se divide en sílabas con bodyText.hyphenation.ragged activado.

La receta completa

Sandbox
// ═══ 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.

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Fija la longitud de los filetes

Un ancho fijo en lugar de 'fill' deja cada filete en 20 mm, a 4 mm del título, así que junto a PLATS la pareja queda más cerca del centro que junto a LE COMPTOIR.

-    size: { width: 'fill' }, // to the column's edge
+    size: { width: mm(20) }, // 20 mm, wherever the title ends

#Lleva puntos hasta el precio

Un relleno ocupa el hueco anterior a la tabulación. '. ' repite un punto y un espacio, desde medio em después del último distintivo o la última palabra del plato hasta medio em antes de su precio.

-  tabStops: [{ position: 'end', align: 'end' }],
+  tabStops: [{ position: 'end', align: 'end', leader: '. ' }],

#Raya la carta de vinos como un libro de cuentas

rules: 'horizontal' traza un filete de latón de 0,5 pt encima y debajo de cada fila de la carta de vinos. Los filetes no ocupan sitio, así que las dos caras conservan su composición, y las filas en blanco sobre Blancs y Rouges llevan también su par de filetes.

-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),

Errores frecuentes

Error frecuente

Las celdas combinadas necesitan hiddenBy: usa mergeCells

Las celdas se colocan según su posición en la fila, así que una celda combinada necesita celdas de relleno marcadas con hiddenBy donde se extiende; omitirlas, como en HTML, desplaza todas las columnas siguientes. Combina celdas con mergeCells. Desde postext 1.5 una tabla con una rejilla irregular se anota en doc.contentWarnings como raggedTableGrid, y parseTSV(texto, { headerRows }) marca las filas de cabecera. Tablas a partir de datos →

Deja sitio para el precio en la primera línea del plato. Cuando el plato y la guarnición pasan del lugar que necesita el precio, la tabulación baja la última palabra del plato a la línea siguiente junto con el precio, y la traducción viene detrás: el plato ocupa entonces tres líneas y el apartado acaba una línea más abajo.

Créditos

Texto
Texto original, CC BY 4.0
Imágenes
  • El toldo y el estante de botellas, dibujados en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
Fuentes
Limelight (SIL OFL 1.1) · Noticia Text (SIL OFL 1.1) · Josefin Sans (SIL OFL 1.1)
Sandbox