En pocas palabras
Un boletín de dos páginas de una asociación de huertos. La noticia principal ocupa una columna ancha y sigue en la página 2, y las noticias breves van en una columna estrecha al lado.
Lo que vas a componer
El número de primavera de La Gaceta del Huerto, boletín de una asociación de huertos inventada, impreso por las dos caras de una hoja A4. Una franja color paja lleva el nombre en Titan One, en dos líneas, una hilera de plantones al pie y una pestaña color tomate con número y temporada. Debajo, la página se divide en una columna de 113 mm y otra de 57 mm. La noticia principal, sobre tres cajones de compost, llena la columna ancha bajo un plano dibujado con código y se interrumpe con una etiqueta «Sigue en la página 2». La columna estrecha reúne cinco breves con etiquetas en forma de píldora. La página 2 retoma la noticia bajo un título de continuación y centra un gráfico de temperaturas. Más abajo, el párrafo sobre un bancal se compone junto a su dibujo, colocado a la derecha de la columna. Ocho avisos llenan la columna estrecha.
Esta receta responde a
- ¿Cómo compongo en columna y media, con una columna de texto ancha y una lateral estrecha?
- ¿Puede Postext componer tres o más columnas de texto, o hacer que el texto rodee una imagen?
- ¿Cómo pongo dos columnas dentro de un recuadro (una de texto junto a otra con una figura)?
- ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
La respuesta corta
const layout = {
layoutType: 'oneAndHalf', // the narrow column sits on the right and takes text (the
// defaults of sideColumnSide and sideColumnRole; 'floats' would keep text out of it)
sideColumnPercent: 32, // 57 mm of the 178 mm measure
gutterWidth: mm(8), // the wide column keeps the other 113 mm
columnRule: { enabled: true, color: col('rule') }, // a 0.5 pt hairline in the gutter
};
// The text runs down the wide column, then the narrow one, then the next page's wide
// column. A :::columnbreak sends the next block on to the following column, so the
// Markdown decides what each column holds:
// ## Shared compost bays open by the top gate ← the lead, in the wide column
// … :chip[Continued on page 2]{style="jump"}
// :::columnbreak ← the briefs open the narrow column
// ## In brief {style="rail"}
// …
// :::columnbreak ← from the last column: next page
// :chip[Continued from page 1]{style="jump"} ← the lead goes on in the wide column
Ingredientes
- Funciones
- Columna y mediaSaltos de página y de columnaChips en líneaTexto alrededor de imágenes y cajasEstilos de títuloColocación de figurasRecuadrosFiguras justo aquíFilete de columnaMetadatos del documentoAperturas diseñadasAtributos de títuloCabeceras y foliosCabeceras según el tipo de páginaEstilos de párrafoTipos de recurso propiosLíneas de fuente y créditoPaleta de color semánticaPáginas en un canvasFiguras y tablas como recursos
- Tipografía
- Work Sans, Titan One, Courier Prime (SIL OFL 1.1)
- Recursos
- El plano de las parcelas, el gráfico de temperaturas, el bancal de un metro cuadrado y la hilera de plantones bajo la mancheta, dibujados con código en la paleta de la página (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Deja que el Markdown llene cada columna
Los ajustes de la disposición están en la respuesta corta, más arriba. En una disposición oneAndHalf la columna estrecha lleva texto por defecto, y el texto baja por la columna ancha, sigue por la estrecha y pasa a la columna ancha de la página siguiente (tipos de disposición). Un :::columnbreak termina la columna donde está (directivas): tras la etiqueta «Sigue en la página 2» abre la columna estrecha para los breves, y tras el último breve, en la última columna de la página, abre la página 2. En este número las dos columnas de la página 1 están ajustadas para terminar en la misma línea de la rejilla base, a 275 mm del borde superior, así que quitar cualquiera de los dos saltos deja las páginas igual. Los saltos hacen falta cuando cambia el texto. Quita el segundo párrafo de la noticia y, sin el primer salto, «En breve» queda a 247 mm, en la columna ancha, bajo la etiqueta, y el primer breve empieza en la ancha y termina en la estrecha, donde su segunda mitad se vuelve a partir para la medida de 57 mm de esa columna.
#2 · Monta la mancheta con el frontmatter
const BEARING = 0.6; // mm: Titan One's left side bearing at 60 pt (T 0.42, G 0.63, L/H 0.85)
const DRILL = { id: 'drill', typeId: 'drawing', kind: 'svg', createdAt: 0, updatedAt: 0,
svg: { fileId: 'drill.svg', width: 2100, height: 80 } }; // drawn by the design, not the text
const masthead = { enabled: true,
minHeight: pt(10 * LEAD), // ten grid lines: the text starts one line clear of the band
slot: { elements: [
// The band is 62 mm deep. The column rule starts under the masthead, where the text does.
{ kind: 'box', id: 'band', style: { backgroundColor: col('straw') },
placement: { ...at('page', 'top-left'), size: { width: mm(210), height: mm(62) } } },
{ kind: 'image', id: 'drill', resourceId: 'drill', // seedlings along the band's foot
placement: { ...at('page', 'top-left', 0, 54), size: { width: mm(210), height: mm(8) } } },
{ kind: 'text', id: 'society', content: '{subtitle}', ...caps(8, 'leaf'), align: 'left',
placement: { ...at('page', 'top-left', SIDE, 12), size: { width: mm(150) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(60),
lineHeight: 0.9, // 54 pt from line to line
color: col('leaf'), align: 'left', overflow: 'wrap', // two lines in 178 mm
placement: { ...at('page', 'top-left', SIDE - BEARING, 17), size: { width: mm(178) } } },
// {attr.issue} comes from the H1 line, {publishDate} from the frontmatter.
{ kind: 'text', id: 'tab', content: '{attr.issue} · {publishDate}', ...caps(9, 'paper'),
align: 'right', box: { backgroundColor: col('tomato'),
padding: { top: mm(1.8), right: mm(3.2), bottom: mm(1.6), left: mm(3.2) } },
placement: at('page', 'top-right', -SIDE, 44) },
] } };
El H1 lleva un estilo de encabezado cuyo diseño dibuja la mancheta, y span: 'page' pone ese diseño sobre las dos columnas. {titleText}, a 60 pt, se parte en dos líneas en su caja de 178 mm. La pestaña une {attr.issue}, escrito en la línea del H1, y {publishDate}, del frontmatter (elementos de texto). Sin minHeight, la mancheta reservaría espacio hasta el pie de la franja, a 62 mm del borde superior, y el texto empezaría en la línea siguiente de la rejilla base, a 62,5 mm, pegado a la franja. Con un minHeight de diez líneas de la rejilla, empieza a 67 mm.
#3 · Etiqueta los breves con chips
const chip = (id, look) => ({ id, fontFamily: LABEL, bold: true,
fontSize: pt(7.7), // in points: em(0.82) is 7.7 pt in the text, 6.6 pt on the 8 pt jump lines
borderWidth: pt(0), borderRadius: em(1), // a radius past half the height draws a pill
paddingX: em(0.5), paddingY: em(0.14), ...look }); // em: of the chip's own size
const chipStyles = [
chip('tag', { background: col('tomato'), color: col('paper') }), // the first is the default
chip('free', { background: col('marigold'), color: col('ink') }),
chip('when', { backgroundEnabled: false, borderWidth: pt(0.8), borderColor: col('leaf'),
color: col('leaf') }),
chip('jump', { background: col('straw'), color: col('ink') }),
];
Declarar chipStyles sustituye el chip azul pálido de serie, y un chip sin style toma el primero (estilos de chip). Un radio mayor que la mitad de la altura de la caja dibuja una píldora. Un chip nunca se parte por dentro, así que la línea solo se corta en el espacio de antes o de después de un chip, y una fecha como «Sáb. 11 de abril» queda en una sola línea. Los estilos de chip no pueden poner el texto en mayúsculas; por eso las etiquetas se escriben así en el Markdown. El relleno vertical se pinta fuera de la línea, así que la rejilla base de 13,4 pt se mantiene.
#4 · Compón el texto junto al dibujo
// wrap sets the drawing at that side of its column, width of it, and the text after the
// ::resource line runs beside it at the measure left over, then under it at full width:
// #### Sixteen squares by the gate {style="kicker"}
// ::resource{id="bed"} ← 51 mm at the right of the 113 mm column
// The demonstration bed by the gate is 1.2 metres square … ← beside it, then under it
const WRAP = { wrap: 'right', width: 0.45 }; // a body line of white between it and the text
wrap: 'right' coloca el dibujo del bancal en el borde derecho de la columna de 113 mm, con el 45 % de su ancho (51 mm), y el párrafo que sigue a la línea ::resource se compone a su lado en los 57 mm que quedan, a una línea del cuerpo del dibujo y su pie (ajuste del texto). La parte superior del dibujo queda a la altura de la primera línea del párrafo, y todas las líneas siguen en la rejilla base de 13,4 pt. Un párrafo más largo seguiría debajo del dibujo a los 113 mm completos, como un solo párrafo; un título u otra figura que llegara con el dibujo todavía al lado del texto pasaría debajo de él. El encabezado de nivel 4 que lo encabeza lleva un estilo de encabezado que solo cambia su color al verde hoja.
#5 · Centra un gráfico estrecho en su franja
const drawing = (id, w, h, placement = {}) => ({ id, typeId: 'drawing', kind: 'svg',
svg: { fileId: `${id}.svg`, width: w * 10, height: h * 10 }, // mm × 10: fitted to the column
placement: { position: 'here', ...placement }, // drawn where ::resource{id} stands
caption: CAPTIONS[id][0], note: CAPTIONS[id][1], altText: CAPTIONS[id][2],
createdAt: 0, updatedAt: 0 });
// width is a fraction of the column and align where the figure sits in it: the text above
// and below never moves into the white either side.
const HEAT = { width: 0.62, align: 'center' };
const resources = () => [drawing('plan', 114, 56.5), drawing('heat', 68, 40, HEAT),
drawing('bed', 50, 50, WRAP), DRILL];
// Newsletter drawings carry no "Figure 1": an empty prefix prints no label.
const resourceTypes = [{ id: 'drawing', name: 'Drawing', shortLabel: 'Drawing',
captionPrefix: '', numberingTemplate: '', resetOn: 'never', counterFormat: 'decimal' }];
width: 0.62 da al gráfico 70,1 mm de los 113 mm de la columna, y align: 'center' lo centra con 21,5 mm de papel a cada lado (colocación). El texto de encima y de debajo conserva la medida entera y nunca entra en ese blanco. Los dibujos son de un tipo de recurso con captionPrefix vacío, así que cada pie empieza con sus propias palabras en negrita, sin «Figura 1» delante.
La receta completa
// ═══ Postext Cookbook · Nº 042 · Community newsletter: lead story and briefs ═════
// https://postext.dev/en/cookbook/community-newsletter
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Work Sans, Titan One, Courier Prime (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, inlineSvgFonts,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'community-newsletter';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: garden colours, every one linked by id
// ink: text · leaf: nameplate and headlines · tomato, the accent: tags, tab, column heads ·
// straw: the band · marigold: second tag · tint: pale greens · rule: hairlines · muted: notes
const palette = { ink: '#1d211c', leaf: '#2f6b3a', tomato: '#c43f2a', straw: '#f2d492',
marigold: '#e2b33c', tint: '#eef4e8', rule: '#cfd3c6', muted: '#5f6659', paper: '#fbfaf5' };
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [ // defaults link to 'main-color': point it at the leaf, never blue
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'leaf (defaults)', value: { hex: palette.leaf, model: 'hex' } },
];
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Work Sans', 'Titan One', 'Courier Prime'];
const SIDE = 16; // mm: the side margins of one A4 sheet, printed on both sides
const LEAD = 13.4; // body leading in pt: the baseline grid
const caps = (size, colour) => ({ fontFamily: LABEL, fontSize: pt(size), fontWeight: 700,
textTransform: 'uppercase', letterSpacing: pt(size * 0.12), color: col(colour) });
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region answer: a wide column for the lead, a narrow one for the briefs, one flow
const layout = {
layoutType: 'oneAndHalf', // the narrow column sits on the right and takes text (the
// defaults of sideColumnSide and sideColumnRole; 'floats' would keep text out of it)
sideColumnPercent: 32, // 57 mm of the 178 mm measure
gutterWidth: mm(8), // the wide column keeps the other 113 mm
columnRule: { enabled: true, color: col('rule') }, // a 0.5 pt hairline in the gutter
};
// The text runs down the wide column, then the narrow one, then the next page's wide
// column. A :::columnbreak sends the next block on to the following column, so the
// Markdown decides what each column holds:
// ## Shared compost bays open by the top gate ← the lead, in the wide column
// … :chip[Continued on page 2]{style="jump"}
// :::columnbreak ← the briefs open the narrow column
// ## In brief {style="rail"}
// …
// :::columnbreak ← from the last column: next page
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
#Pon los breves a la izquierda
La columna ancha se sigue leyendo primero, así que el mismo Markdown pone la noticia a la derecha y los breves a la izquierda.
layoutType: 'oneAndHalf',
+ sideColumnSide: 'left',#Pon los breves a lo ancho de la página
El texto base tiene como mucho dos columnas de texto. La portada de periódico reparte cuatro breves a lo ancho del pie de la página en un recuadro con :::columns{count=4}.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- El plano de las parcelas, el gráfico de temperaturas, el bancal de un metro cuadrado y la hilera de plantones bajo la mancheta, dibujados con código en la paleta de la página · Ignacio Ferro · CC BY 4.0
- Fuentes
- Work Sans (SIL OFL 1.1) · Titan One (SIL OFL 1.1) · Courier Prime (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


