Em poucas palavras
Um currículo de uma página para uma designer de livros, com uma faixa colorida à esquerda para contato e habilidades. As datas de cada emprego ficam alinhadas à direita.
O que você vai compor
O currículo de Irene Salcedo, uma designer de livros fictícia de Madri, numa única folha A4. Uma faixa cor de ameixa de 66 mm de largura desce pela borda esquerda, do alto da folha até o pé. No alto, uma pilha de livros encadernados em tecido, desenhada em código, fica na altura da linha de base do nome. Abaixo vêm os contatos, as habilidades e ferramentas em pílulas, os idiomas, a formação e a docência, e o que ela faz fora do trabalho. O nome, em Hedvig Letters Serif de 46 pt, abre uma coluna de texto de 118 mm com um perfil de cinco linhas, três empregos e uma lista dos livros que ela projetou. Cada emprego põe o cargo à esquerda e as datas alinhadas à direita na mesma linha de base, com o empregador em itálico embaixo. O primeiro título da barra lateral divide a linha de base com a profissão, sob o nome.
Esta receita responde a
- Como monto uma diagramação em coluna e meia, com uma coluna de texto larga e uma coluna lateral estreita?
- Como acrescento uma marca-d'água, um fundo de cor ou uma imagem decorativa em todas as páginas?
- Como faço chips em linha: teclas, etiquetas, bancos de palavras para exercícios?
A 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 } };
Ingredientes
- Funcionalidades
- Coluna de margem para flutuantesColuna e meiaNotas na margemBoxes aninhadosBoxesEspaço vertical explícitoChips no textoTextos, fios e caixas nos designs de páginaImagens nos designs de páginaAncoragem de elementos de designNíveis de títuloAtributos de títuloListas com marcadores e de verificaçãoEstilos de parágrafoPaleta de cores semânticaPáginas em um canvas
- Tipografia
- Hedvig Letters Serif, Hanken Grotesk (SIL OFL 1.1)
- Materiais
- The stack of books at the head of the sidebar, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)
Preparo
#1 · Aninhe as seções num único boxe 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) }];
Dentro da coluna, a faixa é o boxe da resposta curta. Ele é aberto antes do nome, por isso span="side" o põe no alto da coluna só de flutuantes. As seções são boxes aninhados dentro dele, sem preenchimento próprio, e assim o ameixa corre sem interrupção de Contact a Outside work. Como boxes laterais separados, elas ficariam de 4,7 a 9,1 mm umas das outras, mesmo com marginBottom em 0. As pílulas têm uns 3,9 mm de altura. Skills e Tools usam um estilo de seção próprio, chips, cuja entrelinha de 16 pt deixa 1,8 mm entre as fileiras; os 12,4 pt das outras seções deixariam meio milímetro (estilos de chip).
#2 · Pinte as margens em volta da coluna
// 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) } } },
] };
A coluna lateral fica dentro das margens da página, de modo que o boxe da barra para a 9 mm da borda esquerda e a 18 mm da borda superior. Três caixas do cabeçalho preenchem a margem superior acima da coluna, a margem esquerda de cima a baixo e a margem inferior abaixo da coluna. Os elementos do cabeçalho são pintados depois do texto e por cima dele, por isso a receita os mantém nas margens, onde não corre texto. Eles também se repetem em todas as páginas, e uma segunda página levaria a faixa também (cabeçalhos e rodapés). As caixas de cima e da esquerda invadem o boxe da barra em 0,5 mm, e a caixa do pé sobe 1 mm acima do pé da coluna, por cima do fim do boxe, para que nenhum fio de papel apareça nas emendas. O :::space que fecha o boxe da barra o leva até 278,0 mm, 0,8 mm acima do pé da coluna, com 2,76 linhas em inglês e 1,76 em espanhol.
#3 · Componha o nome no alto da coluna de texto
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 };
O H1 mantém o span: 'column' padrão. Com 'page' ele vira uma abertura sobre as duas colunas; como vem depois do boxe da barra, passa para a página 2, e lá a coluna lateral começa embaixo do nome, a 45,9 mm. breakBefore está desativado porque o boxe da barra já está na página: com a quebra, o nome e a coluna de texto inteira vão para a página 2. O marginBottom do nível, de uma linha da grade, começa o perfil a 45,9 mm em vez de 41,3 mm. O espaçamento superior do boxe da barra é ROLE_Y, a altura do nome mais o vão embaixo dele, de modo que o primeiro título da barra e a profissão dividem a linha de base, a 39,3 mm da borda superior.
#4 · Ponha as datas na linha do cargo
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 emprego é um H3 cujos atributos trazem o empregador e as datas: ### Art director {org="Ediciones del Albardín, Madrid" dates="2021 – present"} (atributos de título). O cargo e as datas são ancorados ao alto do mesmo contêiner, um em cada canto, com o mesmo corpo e a mesma entrelinha, e por isso ficam numa só linha de base. O cargo tem no máximo 84 mm e pode quebrar: um cargo longo passa para uma segunda linha antes de chegar às datas, e o empregador desce junto. Com o espaço acima, cada título de seção ocupa exatamente três linhas da grade, o que põe todo emprego 9 pt abaixo de uma linha da grade, venha ele depois de um título de seção ou de uma lista.
A receita 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 = 'en'; // @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',
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Troque a cor da faixa
Cada cor é escrita uma vez, em palette, e as caixas da faixa, o boxe da barra, os chips, a profissão, os títulos e o desenho a tomam dali. Estas três linhas deixam a faixa, o destaque e os chips em verde-azulado.
- 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#Leve figuras para a mesma coluna
O livro didático com coluna na margem põe figuras, legendas laterais e glosas numa coluna só de flutuantes na borda externa de cada página.
Erros comuns
Erro comum
Um boxe lateral começa na altura do bloco que vem depois do seu delimitador
No postext 1.4.1, um boxe com span: 'side' fica na coluna lateral na altura a que o texto chegou no seu delimitador, na linha seguinte da grade e abaixo dos boxes que já estiverem ali. Abra o delimitador de uma glosa logo antes do parágrafo que ela explica: se vier depois, a glosa começa ao lado do parágrafo seguinte. Um boxe que passaria do pé da coluna sobe até seu pé coincidir com o da coluna, se o boxe de cima permitir; se mesmo assim não couber, espera pela coluna lateral da página seguinte. Notas na margem →
Erro comum
Boxes laterais empilhados no canal deixam uma linha de papel entre eles
No postext 1.4.1, um boxe com span: 'side' deixa embaixo de si pelo menos uma linha de texto antes do próximo elemento do canal, arredondada para a grade de linhas de base, seja qual for o seu marginBottom. Por isso, boxes com o mesmo fundo nunca se encostam: empilhados, parecem cartões separados. Para um painel contínuo, abra um único boxe lateral e aninhe as seções dentro dele. Notas na margem →
Erro comum
:::space é descartado no topo de um boxe ou de uma coluna
:::space é descartado no topo de uma coluna, de um grupo :::columns, de um boxe sem título que tenha outro conteúdo e da continuação de um boxe dividido. Desde o postext 1.5, um boxe feito só de :::space tem a altura que o espaço pede (um boxe de resposta, lugar para escrever), e o espaço logo abaixo do título de um boxe desce o corpo nessa mesma altura. Para abrir com espaço um boxe sem título, dê a ele um título ou uma primeira linha e acrescente o espaço depois. Espaço vertical explícito →
Erro comum
Os elementos de cabeçalho e rodapé são pintados sobre o texto
Os elementos de cabeçalho e rodapé são pintados por cima da página, e a área de texto não abre espaço para eles. Mantenha esses elementos dentro das margens, que são o que reserva o espaço deles. Cabeços e fólios →
Erro comum
Um boxe aninhado ignora span, placement e snapToGrid
Um boxe aninhado em outro ignora seus span, placement, snapToGrid e floatBarrier: ele sempre é composto dentro do boxe que o contém, com a largura interna deste. Boxes aninhados →
- Ajuste o
:::spaceà página. Na edição em inglês, 2,76 linhas terminam o boxe 0,8 mm acima do pé da coluna. Com 2,96 linhas ele passa 0,1 mm do pé e a barra inteira vai para a página 2; com 2,66 abre-se uma tira de papel entre o boxe e a caixa do pé. - Uma caixa no design do nome não serve para pintar a faixa. O título reserva a altura da caixa, por isso uma caixa tão alta quanto a faixa o faz reservar mais que os 260,8 mm da coluna, e o texto vai para a página 2. Com
reserve: falsea caixa não reserva nada, mas um design mantido na coluna é cortado no pé da coluna, e a margem inferior ficaria em branco.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- The stack of books at the head of the sidebar, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
- Fontes
- Hedvig Letters Serif (SIL OFL 1.1) · Hanken Grotesk (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


