En poques paraules
Un currículum d'una pàgina per a una dissenyadora de llibres, amb una franja de color a l'esquerra per a les dades de contacte i les habilitats. Les dates de cada lloc de feina s'alineen a la dreta.
Què compondràs
El currículum d'Irene Salcedo, dissenyadora editorial fictícia establerta a Madrid, en un sol full A4. Una banda pruna de 66 mm d'amplada recorre la vora esquerra de dalt a baix. A dalt de tot, una pila de llibres enquadernats en tela, dibuixada en codi, queda a l'altura de la línia de base del nom. A sota hi ha el contacte, les habilitats i eines en píndoles, les llengües, la formació, la docència i les seves aficions. El nom, en Hedvig Letters Serif de 46 pt, encapçala una columna de text de 118 mm amb un perfil de cinc línies, tres llocs de feina i els llibres que ha dissenyat. Cada lloc de feina porta el càrrec a l'esquerra i les dates a la dreta a la mateixa línia de base, amb l'empresa en cursiva a sota. El primer títol de la barra comparteix línia de base amb la professió, sota el nom.
Aquesta recepta respon a
- Com compono en columna i mitja, amb una columna de text ampla i una de lateral estreta?
- Com afegeixo una marca d'aigua, un fons de color o una imatge decorativa a totes les pàgines?
- Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
La resposta curta
const layout = {
layoutType: 'oneAndHalf',
sideColumnPercent: (SIDE / CONTENT) * 100, // 57 of the 185 mm between the margins
sideColumnSide: 'left',
sideColumnRole: 'floats', // no body text: only boxes fenced with span="side"
gutterWidth: mm(GUTTER), // the text column keeps 185 − 57 − 10 = 118 mm
};
// A side box stands where the text has reached at its fence, so the Markdown opens with it,
// before the name, and it starts at the head of the column (gotcha: side-box-starts-at-fence):
// :::callout{type="sidebar" span="side"}
// :::callout{type="section" title="Contact"} … ::: ← the sections nest inside it
// …
// :::space{lines=2.76} ← last: runs the band to the column's foot; a fifth of a line
// ::: more and the whole box moves to page 2
// # Irene Salcedo {role="Book designer and art director"}
const sidebar = { id: 'sidebar', background: col('band'),
// The first title stands on the role's line. The text starts 10 mm from the trim, the
// left margin plus 1 mm, and stops 10 mm short of the band's right edge.
padding: { top: mm(ROLE_Y), right: mm(10), bottom: pt(0), left: mm(1) },
body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(12.4), color: col('paper'),
boldColor: col('paper'), paragraphSpacing: false } };
Ingredients
- Funcions
- Columna al marge per a flotantsColumna i mitjaNotes al margeRequadres niatsRequadresEspai vertical explícitChips en líniaTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaAncoratge d'elements de dissenyNivells de títolAtributs de títolLlistes de pics i de comprovacióEstils de paràgrafPaleta de color semànticaPàgines en un canvas
- També fa servir
- Obertures dissenyadesFigures i taules com a recursos
- Tipografia
- Hedvig Letters Serif, Hanken Grotesk (SIL OFL 1.1)
- Recursos
- The stack of books at the head of the sidebar, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Elaboració
#1 · Niua les seccions en un sol requadre lateral
// The sections nest in one side box. As separate side boxes they would stand at least a line
// of paper apart (gotcha: side-boxes-line-apart). A nested box ignores span and flows inside
// its parent (gotcha: nested-callout-limits).
const section = (id, lineHeight) => ({ id, backgroundEnabled: false, // the band shows through
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
marginTop: mm(10),
titleStyle: { ...caps('glow'), gap: mm(2.4) },
body: { ...sidebar.body, lineHeight: pt(lineHeight) } });
const chipStyles = [{ id: 'skill', fontFamily: SANS, fontSize: pt(7.6), bold: true,
background: col('chip'), color: col('paper'), borderWidth: pt(0),
borderRadius: em(1), // past half the chip's height: a pill
paddingX: em(0.6), paddingY: em(0.22), gap: em(0.3) }];
Dins de la columna, la banda és el requadre de la resposta curta. S'obre abans del nom, i per això span="side" el col·loca al capdamunt de la columna només per a flotants. Les seccions hi van niuades com a requadres sense fons propi, de manera que el pruna corre sense talls de Contacte a Fora de la feina. Compostes com a requadres laterals solts, queden separades per franges de paper de 4,7 a 9,1 mm, fins i tot amb marginBottom a 0. Les píndoles fan uns 3,9 mm d'alçada. Habilitats i Eines fan servir un estil propi, chips, amb un interlineat de 16 pt que deixa 1,8 mm entre files; amb els 12,4 pt de les altres seccions, quedarien a mig mil·límetre les unes de les altres (estils de xip).
#2 · Pinta els marges al voltant de la columna
// Header elements are painted after the text, over it, so these stay in the margins, where
// no text runs (gotcha: header-paints-over-text). They repeat on every page.
const BAND_W = LEFT + SIDE; // mm from the trim edge to the band's right edge
const SEAM = 0.5; // mm of overlap with the box, so no hairline of paper shows between them
const REACH = 1; // mm the foot box climbs above the column's foot, over the end of the box
const bandBox = (id, x, y, w, h) => ({ kind: 'box', id, style: { backgroundColor: col('band') },
placement: { ...at('page', 'top-left', x, y), size: { width: mm(w), height: mm(h) } } });
const header = { elements: [
bandBox('head', 0, 0, BAND_W, TOP + SEAM), // above the column: the top margin
bandBox('edge', 0, 0, LEFT + SEAM, TRIM_H), // beside it: the left margin, top to bottom
bandBox('foot', 0, TRIM_H - BOTTOM - REACH, BAND_W, BOTTOM + REACH), // below it
// Painted last, over the box's top padding, where no text runs. The bottom of the stack
// sits on the name's baseline.
{ kind: 'image', id: 'books', resourceId: 'books', placement: {
...at('page', 'top-left', LEFT + 1, TOP + BASELINE - BOOKS.h),
size: { width: mm(BOOKS.w), height: mm(BOOKS.h) } } },
] };
Com que la columna lateral queda dins dels marges, el requadre s'atura a 9 mm de la vora esquerra i a 18 mm de la superior. Tres caixes de la capçalera omplen el marge superior damunt la columna, l'esquerre de dalt a baix i l'inferior sota la columna. Els elements de la capçalera es pinten després del text i a sobre; per això la recepta els deixa als marges, on no hi ha text. A més, es repeteixen a totes les pàgines, i una segona pàgina també portaria la banda (capçaleres i peus). Les caixes de dalt i de l'esquerra munten 0,5 mm sobre el requadre, i la del peu puja 1 mm per damunt del peu de la columna, sobre el final del requadre, perquè no s'hi vegi un fil de paper a les juntes. El :::space que tanca el requadre l'allarga fins a 278,0 mm, 0,8 mm per damunt del peu de la columna, amb 2,76 línies en anglès i 1,76 en castellà.
#3 · Compon el nom al capdamunt de la columna de text
const nameplate = { enabled: true, slot: { elements: [
{ kind: 'text', id: 'name', content: '{titleText}', fontFamily: SERIF,
fontSize: pt(NAME.size), lineHeight: 1, color: col('ink'),
placement: at('container', 'top-left') },
{ kind: 'text', id: 'role', content: '{attr.role}', ...caps('accent'),
placement: at('#name', 'below', 0, NAME.gap) },
] } };
const nameLevel = { level: 1, // span stays 'column': the name heads the text column only
// No break before the name: the sidebar box is already on the page, and a break would
// move the name and the whole text column to page 2.
breakBefore: { enabled: false },
marginBottom: pt(LEAD), // one grid line of air under the role
advancedDesign: nameplate };
L'H1 conserva el span: 'column' per defecte. Amb 'page' es compon com a obertura sobre les dues columnes; com que va darrere del requadre lateral, passa a la pàgina 2, i allà la columna lateral comença sota el nom, a 45,9 mm. breakBefore està desactivat perquè el requadre lateral ja és a la pàgina: amb salt, el nom i tota la columna de text passen a la pàgina 2. El marginBottom del nivell, una línia de la retícula, baixa el perfil de 41,3 a 45,9 mm. El farciment superior del requadre lateral és ROLE_Y, l'alçada del nom més l'aire que el separa de la professió, de manera que el primer títol de la barra i la professió comparteixen línia de base, a 39,3 mm de la vora superior.
#4 · Posa les dates a la línia del càrrec
const JOB = 9.8; // pt: the job title, the dates and the employer share the size and leading
const jobText = (id, content, look) => ({ kind: 'text', id, content, fontFamily: SANS,
fontSize: pt(JOB), lineHeight: LEAD / JOB, // the body's leading, as a multiple of the size
align: 'left', ...look }); // without align, design text is centred in its box
const job = { enabled: true, slot: { elements: [
jobText('title', '{titleText}', { fontWeight: 700, color: col('ink'), overflow: 'wrap',
placement: { ...at('container', 'top-left'), size: { width: mm(84) } } }), // clear of dates
jobText('dates', '{attr.dates}', { color: col('muted'),
placement: at('container', 'top-right') }), // the title's top and size, so its baseline
jobText('org', '{attr.org}', { italic: true, color: col('muted'),
placement: at('#title', 'below') }),
] } };
const jobLevel = { level: 3, fontSize: pt(JOB), lineHeight: pt(LEAD), marginTop: pt(9),
marginBottom: pt(0), advancedDesign: job };
// The section head takes 20 pt under 19.6 pt of space, three grid lines, so a job head
// starts the same 9 pt under a grid line after a section head as after a list. The 9 pt
// below it merge with a job head's 9 pt above. Under Selected books they push the list to
// the next grid line, as the default 7 pt would; with 0 it would start one line higher.
const sectionLevel = { level: 2, fontSize: pt(14), lineHeight: pt(20),
marginTop: pt(3 * LEAD - 20), marginBottom: pt(9), advancedDesign: sectionHead };
Cada lloc de feina és un H3 amb els atributs que porten l'empresa i les dates: ### Directora de arte {org="Ediciones del Albardín, Madrid" dates="2021 – actualidad"} (atributs d'encapçalament). El càrrec i les dates s'ancoren al capdamunt del mateix contenidor, cadascun en una cantonada, amb el mateix cos i interlineat, i per això comparteixen línia de base. El càrrec té una amplada màxima de 84 mm i admet diverses línies: un de llarg salta a la segona abans d'arribar a les dates, i l'empresa baixa amb ell. Cada títol de secció ocupa, amb l'espai de damunt, tres línies justes de la retícula, i així tots els llocs de feina comencen 9 pt per sota d'una línia, tant si vénen d'un títol de secció com d'una llista.
La recepta completa
// ═══ Postext Cookbook · Nº 057 · One-page CV with a sidebar ═══════════════════════
// https://postext.dev/en/cookbook/cv-with-sidebar
// Code: MIT · Text: original (CC BY 4.0) · Drawing: made in code (CC BY 4.0)
// Fonts: Hedvig Letters Serif, Hanken Grotesk (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'cv-with-sidebar';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#231b22', // text: a plum-tinted near-black
band: '#3a2235', // the sidebar
accent: '#8f3b62', // on paper: the role and the section heads (7.1:1)
glow: '#f1b98f', // on the band: the sidebar titles (8.3:1)
chip: '#744d6c', // on the band: the skill chips
rule: '#d9cdd5', // the hairlines after the section heads
muted: '#6c5f69', // dates, employers, the colophon (6.0:1)
paper: '#ffffff', // the page, and the text on the band (14.4:1)
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [SERIF, SANS] = ['Hedvig Letters Serif', 'Hanken Grotesk'];
const PT = 25.4 / 72; // mm in a point
const [TRIM_W, TRIM_H] = [210, 297]; // mm: A4, printed on one side, so nothing is mirrored
const [TOP, LEFT, RIGHT] = [18, 9, 16]; // mm
const LEAD = 13.2; // pt: the body leading
const BOTTOM = TRIM_H - TOP - 56 * LEAD * PT; // mm: the text block holds 56 lines
const CONTENT = TRIM_W - LEFT - RIGHT; // 185 mm between the margins
const [SIDE, GUTTER] = [57, 10]; // mm: the sidebar column, and the white after it
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const LABEL = 7.8; // pt: the role and the sidebar titles, tracked capitals
const caps = (colour) => ({ fontFamily: SANS, fontSize: pt(LABEL), fontWeight: 700,
textTransform: 'uppercase', letterSpacing: pt(LABEL * 0.18), color: col(colour) });
const NAME = { size: 46, gap: 2.6 }; // pt and mm: the name, and the room under it
const ROLE_Y = NAME.size * PT + NAME.gap; // mm under the top margin: the role's line
// mm under the top margin: the name's baseline. Hedvig Letters Serif, set solid, puts it 0.795
// of the size down the line (measured on the page); another face needs its own ratio.
const BASELINE = 0.795 * NAME.size * PT;
const BOOKS = { w: 46, h: 18 }; // mm: the drawing at the head of the band
// #region answer: a float-only column on the left, filled by one box
const layout = {
layoutType: 'oneAndHalf',
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
#Canvia el color de la banda
Cada color s'escriu una sola vegada, a palette, i d'allà el prenen les caixes de la banda, el requadre lateral, els xips, la professió, els títols i el dibuix. Amb aquestes tres línies, la banda, l'accent i els xips passen a verd blavós.
- band: '#3a2235', // the sidebar
+ band: '#1d3b3a', // the sidebar
- accent: '#8f3b62', // on paper: the role and the section heads (7.1:1)
+ accent: '#2b5f5b', // on paper: the role and the section heads (7.3:1)
- chip: '#744d6c', // on the band: the skill chips
+ chip: '#456d69', // on the band: the skill chips#Porta figures a la mateixa columna
El llibre de text amb columna al marge posa figures, peus laterals i glosses en una columna només per a flotants a la vora exterior de cada pàgina.
Errors freqüents
Error freqüent
Un requadre lateral comença a l'altura del bloc que segueix la seva tanca
A postext 1.4.1, un requadre amb span: 'side' es col·loca a la columna lateral a l'altura on ha arribat el text a la seva tanca, a la línia següent de la retícula i sota els requadres que ja hi hagi. Posa la tanca d'una glossa just abans del paràgraf que explica: si va després, la glossa comença al costat del paràgraf següent. Un requadre que passaria del peu de la columna puja fins que el seu peu coincideix amb el de la columna, si el requadre de sobre li deixa lloc; si tot i així no hi cap, espera la columna lateral de la pàgina següent. Notes al marge →
Error freqüent
Els requadres laterals apilats al canal deixen una línia de paper entre ells
A postext 1.4.1, un requadre amb span: 'side' deixa a sota almenys una línia de text abans del que vingui després al canal, arrodonida a la retícula de base, digui el que digui el seu marginBottom. Per això els requadres amb el mateix fons no es toquen mai: apilats, es llegeixen com a targetes soltes. Per a un tauler continu, obre un sol requadre lateral i niua-hi les seccions. Notes al marge →
Error freqüent
:::space es descarta al principi d'un requadre o columna
:::space es descarta al principi d'una columna, d'un grup :::columns, d'un requadre sense títol que té més contingut i de la continuació d'un requadre partit. Des de postext 1.5 un requadre fet només de :::space fa l'alçada que demana l'espai (una caixa de resposta, lloc per escriure), i l'espai que va just sota el títol d'un requadre fa baixar el cos aquesta mateixa alçada. Per obrir amb espai un requadre sense títol, dona-li un títol o una primera línia i afegeix-hi després l'espai. Espai vertical explícit →
Error freqüent
Els elements de capçalera i peu es pinten damunt del text
Els elements de capçalera i peu es pinten sobre la pàgina i l'àrea de text no els deixa lloc. Mantén-los dins dels marges, que són els que els reserven l'espai. Capçaleres i folis →
Error freqüent
Un requadre imbricat ignora span, placement i snapToGrid
Un requadre imbricat en un altre ignora el seu span, placement, snapToGrid i floatBarrier: sempre es compon dins del requadre que el conté, amb l'amplada interior d'aquest. Requadres niats →
- Ajusta el
:::spacea la pàgina. A l'edició castellana, 1,76 línies acaben el requadre 0,8 mm per damunt del peu de la columna. Amb 1,96 línies passa del peu en 0,1 mm i tota la barra se'n va a la pàgina 2; amb 1,66 s'obre una franja de paper entre el requadre i la caixa del peu. - Una caixa del disseny del nom no serveix per pintar la banda. El títol reserva l'alçada de la caixa, així que una de tan alta com la banda li fa reservar més que els 260,8 mm de la columna, i el text passa a la pàgina 2. Amb
reserve: falsela caixa no reserva res, però un disseny que es queda a la columna es talla al peu d'aquesta, i el marge inferior quedaria en blanc.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- The stack of books at the head of the sidebar, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fonts
- Hedvig Letters Serif (SIL OFL 1.1) · Hanken Grotesk (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)


