En poques paraules
Un butlletí de dues pàgines d'una associació d'horts. La notícia principal ocupa una columna ampla i continua a la pàgina 2, i les notícies breus van en una columna estreta al costat.
Què compondràs
El número de primavera de La Gaceta del Huerto, butlletí d'una associació d'horts inventada, imprès per les dues cares d'un full A4. Una franja color palla porta el nom en Titan One, en dues línies, una filera de planters al peu i una pestanya color tomàquet amb número i temporada. A sota, la pàgina es divideix en una columna de 113 mm i una altra de 57 mm. La notícia principal, sobre tres calaixos de compost, omple la columna ampla sota un plànol dibuixat amb codi i s'interromp amb una etiqueta «Sigue en la página 2». La columna estreta aplega cinc breus amb etiquetes en forma de píndola. La pàgina 2 reprèn la notícia sota un títol de continuació i centra un gràfic de temperatures. Més avall, el paràgraf sobre un bancal es compon al costat del seu dibuix, col·locat a la dreta de la columna. Vuit avisos omplen la columna estreta.
Aquesta recepta respon a
- Com compono en columna i mitja, amb una columna de text ampla i una de lateral estreta?
- Pot Postext compondre tres o més columnes de text, o fer que el text envolti una imatge?
- Com poso dues columnes dins d'un requadre (una de text al costat d'una altra amb una figura)?
- Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
La resposta curta
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
Ingredients
- Funcions
- Columna i mitjaSalts de pàgina i de columnaChips en líniaText al voltant d'imatges i caixesEstils de títolCol·locació de figuresRequadresFigures just aquíFilet de columnaMetadades del documentObertures dissenyadesAtributs de títolCapçaleres i folisCapçaleres segons el tipus de pàginaEstils de paràgrafTipus de recurs propisLínies de font i crèditPaleta de color semànticaPàgines en un canvasFigures i taules com a recursos
- També fa servir
- Banda de capítol d'amplada completaColor del paper
- Tipografia
- Work Sans, Titan One, Courier Prime (SIL OFL 1.1)
- Recursos
- The site plan, the temperature chart, the square-metre bed and the row of seedlings under the nameplate, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Elaboració
#1 · Deixa que el Markdown ompli cada columna
La configuració de la disposició és a la resposta curta, més amunt. En una disposició oneAndHalf la columna estreta porta text per defecte, i el text baixa per la columna ampla, continua per l'estreta i passa a la columna ampla de la pàgina següent (tipus de disposició). Un :::columnbreak acaba la columna on és (directives): després de l'etiqueta «Sigue en la página 2» obre la columna estreta per als breus, i després de l'últim breu, a l'última columna de la pàgina, obre la pàgina 2. En aquest número les dues columnes de la pàgina 1 estan ajustades per acabar a la mateixa línia de la retícula de base, a 275 mm de la vora superior, així que treure qualsevol dels dos salts deixa les pàgines igual. Els salts calen quan canvia el text. Treu el segon paràgraf de la notícia i, sense el primer salt, «En breve» queda a 247 mm, a la columna ampla, sota l'etiqueta, i el primer breu comença a l'ampla i acaba a l'estreta, on la seva segona meitat es torna a partir per a la mesura de 57 mm d'aquesta columna.
#2 · Munta la capçalera amb 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) },
] } };
L'H1 porta un estil d'encapçalament amb un disseny que dibuixa la capçalera, i span: 'page' posa aquest disseny sobre les dues columnes. {titleText}, a 60 pt, es parteix en dues línies a la seva caixa de 178 mm. La pestanya uneix {attr.issue}, escrit a la línia de l'H1, i {publishDate}, del frontmatter (elements de text). Sense minHeight, la capçalera reservaria espai fins al peu de la franja, a 62 mm de la vora superior, i el text començaria a la línia següent de la retícula de base, a 62,5 mm, enganxat a la franja. Amb un minHeight de deu línies de la retícula, comença a 67 mm.
#3 · Etiqueta els breus amb xips
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 substitueix el xip blau pàl·lid de sèrie, i un xip sense style fa servir el primer (estils de xip). Un radi més gran que la meitat de l'alçada de la caixa dibuixa una píndola. Un xip no es parteix mai per dins, així que la línia només es talla a l'espai d'abans o de després d'un xip, i una data com «Sáb. 11 de abril» queda en una sola línia. Els estils de xip no poden posar el text en majúscules; per això les etiquetes s'escriuen així al Markdown. L'emplenament vertical es pinta fora de la línia, així que la retícula de base de 13,4 pt es manté.
#4 · Compon el text al costat del dibuix
// 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' col·loca el dibuix del bancal a la vora dreta de la columna de 113 mm, amb el 45 % de la seva amplada (51 mm), i el paràgraf que segueix la línia ::resource es compon al costat en els 57 mm que queden, a una línia del cos del dibuix i el seu peu (ajust del text). La part superior del dibuix queda a l'altura de la primera línia del paràgraf, i totes les línies continuen a la retícula de base de 13,4 pt. Un paràgraf més llarg continuaria a sota del dibuix als 113 mm sencers, com un sol paràgraf; un títol o una altra figura que arribés amb el dibuix encara al costat del text passaria a sota. El títol de nivell 4 que l'encapçala porta un estil d'encapçalament que només canvia el color al verd fulla.
#5 · Centra un gràfic estret a la seva 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 dona al gràfic 70,1 mm dels 113 mm de la columna, i align: 'center' el centra amb 21,5 mm de paper a cada costat (col·locació). El text de damunt i de sota conserva la mesura sencera i no entra mai en aquest blanc. Els dibuixos són d'un tipus de recurs amb captionPrefix buit, així que cada peu comença amb les seves pròpies paraules en negreta, sense «Figura 1» al davant.
La recepta 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
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
#Posa els breus a l'esquerra
La columna ampla es continua llegint primer, així que el mateix Markdown posa la notícia a la dreta i els breus a l'esquerra.
layoutType: 'oneAndHalf',
+ sideColumnSide: 'left',#Posa els breus a tota l'amplada de la pàgina
El cos té com a màxim dues columnes de text. La portada de diari reparteix quatre breus a tota l'amplada del peu de la pàgina en un requadre amb :::columns{count=4}.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- The site plan, the temperature chart, the square-metre bed and the row of seedlings under the nameplate, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fonts
- Work Sans (SIL OFL 1.1) · Titan One (SIL OFL 1.1) · Courier Prime (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)


