Saltar al contingut principal
Recepta número 27

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

Portada de diari

Portada i pàgina 2 d'un setmanari local a dues columnes amb filet, titulars a tota l'amplada en requadres i una franja de breus a quatre columnes al peu.

  • Mostra en anglès: encara no hi ha edició en català
  • Format 246 × 328 mm
  • 2 columnes, espai entre columnes de 6 mm
  • PT Serif 9,4/12,6
  • Grenze Gotisch
  • Libre Franklin
  • 2 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 89 ms
  • 232 línies de codi

En poques paraules

La portada i la pàgina 2 d'un setmanari local. Ensenya a posar grans titulars a l'amplada de la pàgina i una franja de notícies breus al peu.

Què compondràs

Portada i pàgina 2 de The Elverdale Courier, un setmanari comarcal inventat, en pàgines de 246 × 328 mm. La capçalera gòtica va entre dues orelles, el temps i el preu, sobre dos filets i la línia de data. La notícia principal arrenca amb un titular a dues línies en Libre Franklin Black de 56 pt sobre les dues columnes, un subtítol en cursiva i una foto en banda de 222 mm, i continua en dues columnes justificades amb filet. Al peu, quatre breus comparteixen una franja de fons beix, un per columna, cadascun encapçalat per un xip vermell. La pàgina 2 obre amb un rètol de secció vermell i porta la notícia del pont amb un dibuix fet amb codi, el temps al capdamunt de la columna dreta, un segon titular a tota l'amplada, les cartes i una taula de vots amb una barra a cada fila.

Aquesta recepta respon a

  • Pot Postext compondre tres o més columnes de text, o fer que el text envolti una imatge?
  • Com poso un requadre que travessi les dues columnes a mitja pàgina, com un tauler de xifres en tres blocs?
  • Com decideixo on va una figura: al capdamunt de la pàgina, a l'amplada de les dues columnes, just aquí o al marge?
  • Com poso el títol de capítol a tota l'amplada mentre el text continua a dues columnes a sota?

La resposta curta

script.js · línies 82–99al codi complet
const layout = { layoutType: 'double', gutterWidth: mm(GUTTER), // the body of every page
  columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.5) } };
// The strip is a tinted, titled box, so its four columns are a :::columns group in a :::callout.
// The fence spans the page and floats the box to the foot, so the story fills the columns above:
//   :::callout{type="briefs" span="page" placement="bottom" title="In brief"}
//   :::columns{count=4 breaks="2,3,4"}   ← each brief opens a column (child 2, 3 and 4)
//   …four paragraphs…
//   :::
//   :::
// The style could carry span and placement too; on the fence they stay in sight in the text.
// hook-up: config() takes layout as it is and lists briefs in calloutStyles.
const briefs = { id: 'briefs',
  background: col('tint'), // one device: a tint, no stripe or border
  padding: { top: mm(3), right: mm(4), bottom: mm(4), left: mm(4) },
  columnGap: mm(GUTTER), // the inner columns keep the page's gutter
  titleStyle: { ...caps(9, 800, 'flag'), gap: mm(2) },
  body: { fontFamily: 'PT Serif', fontSize: pt(8.6), lineHeight: pt(11.4), textAlign: 'left',
    firstLineIndent: pt(0) } }; // ragged and unindented, unlike the columns

Ingredients

Tipografia
Grenze Gotisch, PT Serif, Libre Franklin (SIL OFL 1.1)
Recursos
  • ridge-2400.jpg
  • Wind turbines on a snowy ridge (the front-page photograph, cropped to a band) (Jason Blackeye, CC0 1.0)
  • The bridge drawing and the bars in the ward table, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)

Elaboració

#1 · Paper de diari, tinta i un vermell

script.js · línies 14–27al codi complet
const palette = {
  ink: '#111315', // text and the heavy rules: a cold near-black
  paper: '#f8f5ee', // newsprint, and type reversed out of ink or red
  flag: '#a6192e', // the one accent: section flags, kickers, the Yes bars
  tint: '#ebe6db', // the In brief strip
  rule: '#9a978f', // hairlines: the column rule, table rules
  muted: '#5d5a55', // bylines, the folio line's title and date, credit notes, the imprint
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [ // defaults link to 'main-color': point it at the ink, never blue
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];

El paper és un blanc trencat càlid (#f8f5ee) i la lletra, un negre fred (#111315). L'únic vermell, #a6192e, va als rètols de secció, els avanttítols, els xips i les barres del sí. Cada color va enllaçat a la seva entrada de la paleta amb paletteId. main-color apunta a la tinta, de manera que la negreta, les cursives, les dues remissions de la pàgina 2 i tot el que la configuració deixa per defecte surten en negre; amb el seu valor d'origen sortirien en el blau per defecte, #295AA3.

#2 · La capçalera és l'H1 de la portada

script.js · línies 50–78al codi complet
const NAME = 52; // pt: the blackletter nameplate
const EAR = 31; // mm: each ear, in the room the nameplate leaves at either side
const EAR_DROP = 1.8; // mm: measured so the ears' big figures sit on the nameplate's baseline
const AIR = 2; // mm between the lower rule and the masthead's foot, where the banner box starts
const ear = (side, lines) => lines.map(([id, content, look], i) => text(id, content,
  { ...look, align: side }, { ...(i === 0 ? at('container', `top-${side}`, 0, EAR_DROP)
    : at(`#${lines[i - 1][0]}`, 'below', 0, 1)), size: { width: mm(EAR) } }));
const serif = { fontFamily: 'PT Serif', fontSize: pt(9), italic: true, color: col('ink'),
  lineHeight: 1.25 };
const nameplate = { enabled: true, slot: { elements: [
  depth(7), // the masthead is seven grid lines deep; the rules and dateline hang from its foot
  { kind: 'rule', id: 'foot', thickness: pt(0.5), color: col('ink'),
    placement: { ...at('#depth', 'align-bottom', 0, -AIR), size: { width: 'fill' } } },
  ...[['left', '{attr.issue}'], ['center', '{publishDate}'], ['right', '{attr.area}']].map(
    ([align, content]) => text(`date-${align}`, content, { ...caps(7.5, 600), align },
      { ...at('#foot', 'above', 0, -1.4), size: { width: 'fill' } })),
  rule('thin', '#date-left', 0.5, 1.6), rule('heavy', '#thin', 2.5, 0.6), // the Oxford rule
  text('name', '{titleText}', { fontFamily: 'Grenze Gotisch', fontSize: pt(NAME),
    fontWeight: 700, lineHeight: 1, align: 'center' },
  { ...at('#heavy', 'above', 0, -1.2), size: { width: 'fill' } }), // centred between the ears
  ...ear('left', [['w-kicker', 'Weather', caps(7, 700, 'flag')],
    ['w-outlook', '{attr.outlook}', serif], ['w-temps', '{attr.temps}', franklin(15, 800)]]),
  ...ear('right', [['p-kicker', '{attr.since}', caps(7, 700, 'flag')],
    ['p-day', '{attr.day}', serif], ['p-price', '{attr.price}', franklin(15, 800)]]),
] } };
// hook-up: headingStyles gets { id: 'front', advancedDesign: nameplate, header: { elements:
// [] } }, H1 already spans the page, and the Markdown opens with
// # The Elverdale Courier {style="front" issue="…" area="…" outlook="…" temps="…" since="…"
//   day="…" price="…"}

# The Elverdale Courier porta l'estil d'encapçalament front, que compon la capçalera amb el text del títol i set dels seus atributs (issue, area, outlook, temps, since, day i price); la data surt del publishDate del frontmatter. Una caixa buida de set línies exactes de la retícula (31,1 mm) fixa l'alçada de l'obertura. Els filets, la línia de data i el nom pengen del seu peu, i així l'obertura acaba just en una línia de la retícula.

#3 · Un titular sobre les dues columnes és un requadre

script.js · línies 103–116al codi complet
// :::callout{type="banner" span="page" title="Transport"} ← an optional kicker, then the H2
const banner = { id: 'banner', backgroundEnabled: false,
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  titleStyle: { ...caps(8, 800, 'flag'), gap: mm(1.2) }, // a kicker, when the fence has a title
  marginTop: pt(0), // flush under the nameplate or the section flag
  marginBottom: pt(LEAD / 2), // half a line, then the columns start on the next grid line
  body: { fontFamily: 'PT Serif', fontSize: pt(13), lineHeight: pt(16.5), textAlign: 'left' } };
// A story that starts mid-page: the same box under a rule. The columns above it are cut level.
const story = { ...banner, id: 'story', marginTop: pt(LEAD),
  stripe: { enabled: true, side: 'top', width: pt(1), color: col('ink') }, // its one device
  padding: { top: mm(2.5), right: pt(0), bottom: pt(0), left: pt(0) } };
// Inside the box the headline is an H2 in a heading style: one size for each rank of story.
const headline = (id, size, look = {}) => ({ id, fontSize: pt(size), lineHeight: pt(size * 1.02),
  marginBottom: pt(size * 0.2), ...look }); // tight leading, a fifth of it below

Un títol només ocupa les dues columnes com a obertura, i una obertura comença pàgina. Si poses span: 'page' a l'H2 de la notícia dels barris en lloc de posar-lo al seu requadre, aquesta notícia se'n va a una tercera pàgina. Un requadre sense marc amb span="page", en canvi, pot començar a mitja pàgina. A la pàgina 2, les columnes queden igualades per sobre i continuen per sota. A dins hi van l'H2, amb un de tres estils d'encapçalament (56, 30 o 22 pt), el subtítol en cursiva i, a la portada, la foto. El seu marginBottom de mitja línia fa que les columnes comencin a la línia següent de la retícula, 3,4 mm per sota del subtítol a la pàgina 2. Amb el marge per defecte en queden 7,8 mm i les cartes passen a una tercera pàgina.

#4 · La franja de quatre columnes és un requadre

El codi d'aquest pas és la resposta curta de més amunt. El text de les dues pàgines va a dues columnes (Tipus de disposició). Els breus només en demanen quatre al peu de la pàgina 1, amb títol i sobre un fons, així que van en un requadre, aquí un a tota l'amplada amb un grup :::columns a dins. breaks compta els blocs del grup, un per breu, així que els breus 2, 3 i 4 obren les columnes 2, 3 i 4. Cada columna fa 49 mm, amb l'espai entre columnes de 6 mm de la pàgina entre una i l'altra.

:::callout{type="briefs" span="page" placement="bottom" title="In brief"}
:::columns{count=4 breaks="2,3,4"}
:chip[TRANSPORT]{style="flag"} **Bus 44 back on Sundays.** The Elverdale to Kirkby bus …
 
:chip[SCHOOLS]{style="flag"} **An orchard for Brook Lane.** Pupils at Brook Lane …
…
:::
:::

placement="bottom" porta el requadre al peu de la pàgina 1, on ocupa 36,9 mm, i la notícia omple els 83 mm de columna que queden a sobre. La foto principal continua sent una banda sobre les dues columnes dins del requadre del titular: el text es compon al costat d'una imatge més estreta que la columna, a un costat, mai al voltant d'una imatge que ocupa dues columnes. El dibuix del pont de la pàgina 2 porta el text al costat (pas 5).

#5 · Imatges en línia, taules flotants

script.js · línies 339–375al codi complet
// A caption label prints only when captionPrefix has text: '' leaves no "Figure 1".
const unnumbered = (id, name, captionStyle) => ({ id, name, shortLabel: name, captionPrefix: '',
  numberingTemplate: '', resetOn: 'never', counterFormat: 'decimal', captionStyle });
const resourceTypes = [unnumbered('picture', 'Picture'), // captions under the picture
  unnumbered('panel', 'Panel', { position: 'above', fontSize: pt(9.5) })]; // tables: titled above
const resource = (id, typeId, kind, body, extra) => ({ id, typeId, kind, [kind]: body,
  createdAt: 0, updatedAt: 0, ...extra });
const resources = [
  // Set inline in the page-span banner box: a 'top' float never lands above the line that
  // cites it (gotcha: top-float-next-page). It keeps the float gap above it, inside the box too.
  // 2400 px at 150 dpi is 406 mm: the photo shrinks to the box (gotcha: bitmap-print-size).
  resource('ridge', 'picture', 'bitmap', { fileId: 'ridge-2400.jpg', format: 'jpeg', width: 2400,
    height: 800 }, { placement: { position: 'here' },
    altText: 'Wind turbines on a snow-covered ridge under a bright, cloudy sky.',
    caption: '**File picture:** turbines on an upland ridge. Each of the three planned for '
      + 'Harrow Ridge would generate 2.3 megawatts.',
    note: 'Photograph: Jason Blackeye, CC0, via Wikimedia Commons' }),
  // Drawn in code (the art region) and set inline, where ::resource puts it in column 1,
  // at the column's right with the next paragraph running beside it (text wrap).
  resource('bridge', 'picture', 'svg', { fileId: 'bridge.svg', width: 1190, height: 460 },
    { placement: { position: 'here', wrap: 'right', width: 0.47 },
      altText: 'Drawing of a two-arch stone bridge between sloping river banks; under its '
        + 'central pier, a red concrete footing.',
      caption: '**The rebuilt pier.** Its new concrete footing (red) goes six metres below the '
        + 'riverbed. Both arches were relaid with their own stones.',
      note: 'Drawing: The Courier' }),
  // A page-span 'bottom' float sits under both columns of the page that cites it. On the last
  // page it follows the balanced columns, so the copy there is fitted to bring it to the foot.
  resource('wards', 'panel', 'table', { styleId: 'results', model: resultsTable() },
    { placement: { position: 'bottom', span: 'page' }, caption: '**How the wards voted**',
      note: 'Red: yes. Grey: no. The black line marks half the vote. '
        + 'Source: Elverdale Town Council.' }),
  // A column 'top' float waits for the head of the next column with room.
  resource('forecast', 'panel', 'table', { styleId: 'forecast', model: forecastTable() },
    { placement: { position: 'top', span: 'column' }, caption: '**The next five days**',
      note: 'Sunrise 6.57, sunset 19.03 on Thursday. Forecast: Wend Valley Weather Station.' }),
];

La foto va en línia dins del requadre del titular perquè un flotant top a tota l'amplada mai no cau per sobre de la línia que el cita; com a flotant, obriria la pàgina 2 (vegeu Errors freqüents). El dibuix del pont també va en línia, després del paràgraf sobre la pila, i wrap: 'right' amb width: 0.47 el col·loca a la dreta de la columna 1, amb el 47 % de la seva amplada, i els paràgrafs següents es componen al costat i després a sota a la mesura completa (ajust del text). Amb aquesta amplada cap línia del costat no queda fluixa; el text de la notícia es va reajustar al dibuix més baix. La previsió flota al capdamunt d'una columna i cau a la de la dreta. La taula de barris flota sota les dues columnes, on s'atura el filet de columna. A l'última pàgina es col·loca just sota les columnes igualades, i per això el text de sobre està ajustat perquè la taula arribi al peu. Els dos tipus de recurs fixen captionPrefix: '', i l'etiqueta del peu només s'imprimeix quan el prefix té text, així que cap peu no comença per «Figure 1».

#6 · Una pàgina interior obre amb un rètol de secció

script.js · línies 120–138al codi complet
const section = { enabled: true, slot: { elements: [
  depth(2), // two grid lines: the flag sits on a 3 pt bar, 1.6 mm above the foot
  { kind: 'rule', id: 'bar', thickness: pt(3), color: col('ink'),
    placement: { ...at('#depth', 'align-bottom', 0, -1.6), size: { width: 'fill' } } },
  text('flag', '{titleText}', { ...caps(11, 800, 'paper'), box: { backgroundColor: col('flag'),
    padding: { top: mm(1.3), right: mm(3), bottom: mm(1.1), left: mm(3) } } },
  at('#bar', 'above')),
] } };
const FOLIO = 6; // mm from the top edge to the folio line; its rule 4 mm lower
const folio = (parity, side, s) => [ // s: +1 on a verso (folio on the left), −1 on a recto
  text(`n-${parity}`, '{pageNumber}', { ...franklin(9, 800), align: side },
    at('page', `top-${side}`, s * MARGIN.side, FOLIO)),
  text(`t-${parity}`, '{title} · {publishDate}', { ...caps(7, 600, 'muted'), align: side },
    at(`#n-${parity}`, s > 0 ? 'right-of' : 'left-of', s * 3, 0.9)),
].map((element) => ({ ...element, parity }));
const header = { elements: [...folio('even', 'left', 1), ...folio('odd', 'right', -1),
  { kind: 'rule', id: 'folio-rule', thickness: pt(0.5), color: col('ink'),
    placement: { ...at('page', 'top-left', MARGIN.side, FOLIO + 4), size: { width: mm(TRIM.width
      - 2 * MARGIN.side) } } }] };

# Town & Valley és un H1 amb un breakBefore de paritat 'any', així que la secció obre la pàgina 2 sense una pàgina en blanc al davant. El seu disseny és un rètol vermell sobre una barra de 3 pt, penjat d'una caixa buida de dues línies de la retícula. La línia de foli és una capçalera ancorada a 6 mm de la vora superior de la pàgina, amb una versió per a les parelles i una altra per a les senars. L'estil de la portada deixa buida la capçalera de pàgina, de manera que sobre la capçalera del diari no s'imprimeix cap línia de foli.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 027 · Newspaper front page ═══════════════════════════
// https://postext.dev/en/cookbook/newspaper-front-page
// Code: MIT · Text: original (CC BY 4.0) · Photo: Jason Blackeye (CC0)
// Fonts: Grenze Gotisch, PT Serif, Libre Franklin (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'newspaper-front-page';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: newsprint, ink and one red for the section flags
const palette = {
  ink: '#111315', // text and the heavy rules: a cold near-black
  paper: '#f8f5ee', // newsprint, and type reversed out of ink or red
  flag: '#a6192e', // the one accent: section flags, kickers, the Yes bars
  tint: '#ebe6db', // the In brief strip
  rule: '#9a978f', // hairlines: the column rule, table rules
  muted: '#5d5a55', // bylines, the folio line's title and date, credit notes, the imprint
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [ // defaults link to 'main-color': point it at the ink, never blue
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const TRIM = { width: 246, height: 328 }; // mm: a 3 : 4 compact, smaller than a tabloid
const MARGIN = { top: 14, bottom: 15, side: 12 }; // newspaper margins: narrow, not mirrored
const GUTTER = 6; // mm between the two body columns, and between the In brief columns
const LEAD = 12.6; // body leading in pt: the baseline grid
const franklin = (size, weight, look = {}) => ({ fontFamily: 'Libre Franklin',
  fontSize: pt(size), fontWeight: weight, color: col('ink'), ...look });
const caps = (size, weight, colour = 'ink') => franklin(size, weight, { color: col(colour),
  textTransform: 'uppercase', letterSpacing: pt(size * 0.16) }); // capitals tracked 0.16 em
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, align: 'left',
  overflow: 'wrap', color: col('ink'), ...look, placement }); // design text defaults to centred
// and black, and a header's text to an ellipsis
// A rule across the slot whose bottom sits `gap` mm above the element it names.
const rule = (id, under, weight, gap = 0) => ({ kind: 'rule', id, thickness: pt(weight),
  color: col('ink'), placement: { ...at(under, 'above', 0, -gap), size: { width: 'fill' } } });
// An empty box exactly `lines` grid lines deep sets an opener's depth, and the rest hangs from
// its foot: the opener ends on a grid line, where the columns and their rule begin.
const depth = (lines) => ({ kind: 'box', id: 'depth', style: {}, placement: {
  ...at('container', 'top-left'), size: { width: 'fill', height: pt(lines * LEAD) } } });

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

#Deixa els breus sota la foto

Sense placement="bottom" a content.en.md, la franja es queda al seu lloc del text, just sota la foto, i la notícia principal continua per sota fins al peu de la pàgina.

-:::callout{type="briefs" span="page" placement="bottom" title="In brief"}
+:::callout{type="briefs" span="page" title="In brief"}

Errors freqüents

Error freqüent

Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita

Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →

Error freqüent

Els mapes de bits prenen la mida d'impressió d'una resolució: declara-la, no calculis píxels d'impressió

Un mapa de bits sense resolució es col·loca a un píxel per píxel de maquetació a la resolució del document, així que una foto de 2400 px fa 406 mm d'amplada en una pàgina de 150 ppp. Declara els píxels reals del fitxer i dona a la imatge la seva resolució (bitmap.resolution: 300), o fixa layout.bitmapResolution per a tots els mapes de bits: uns ppp, o 'file' per llegir la que indica el fitxer. La columna continua limitant la imatge. Figures i taules com a recursos →

  • Si dones a la foto placement: { position: 'top', span: 'page' }, surt de la pàgina 1 i queda sola a la pàgina 2. La notícia de la portada acaba llavors 92 mm per sobre de la franja de breus, i la secció passa a la pàgina 3.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • Wind turbines on a snowy ridge (the front-page photograph, cropped to a band) · Jason Blackeye · CC0 1.0
  • The bridge drawing and the bars in the ward table, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
Fonts
Grenze Gotisch (SIL OFL 1.1) · PT Serif (SIL OFL 1.1) · Libre Franklin (SIL OFL 1.1)
Sandbox