Em poucas palavras
Quatro páginas de um atlas de ilhas inventadas. Mostra como dar aos mapas uma numeração própria e como girar um mapa grande de lado para ele ocupar uma página inteira.
O que você vai compor
A primeira folha de um atlas das Ilhas Solan, um arquipélago inventado para esta receita e desenhado em código a partir de um único campo de alturas. A página 1 abre numa faixa azul de alto-mar com o nome do atlas em 56 pt e uma rosa dos ventos, e o mapa 1, o relevo de todo o arquipélago, ocupa o pé da página. A ponta norte da ilha principal e a planta do porto encabeçam as duas colunas da página 2. Na página 3, a carta das ilhas está girada um quarto de volta para que a quadrícula de quadrados de 8 km preencha a página. A página 4 traz o índice toponímico, dezessete lugares em discos vermelhos com o quadrado da carta de cada um, e uma linha de créditos no pé. Cada mapa tem a legenda acima do desenho, numa barra azul, e a legenda de cores do mapa 1 é uma linha de amostras nas cores do mapa.
Esta receita responde a
- Como acrescento uma figura com legenda numerada e a cito no texto (“ver fig. 3.2”)?
- Como decido onde vai uma figura: no alto da página, sobre as duas colunas, exatamente aqui ou na margem?
- Como acrescento amostras de cor, como chave de cores, ao texto, às legendas ou às notas de tabela?
A resposta curta
// Every caption stands above its drawing or table, in the label face. Maps count 1, 2, 3…
// through the atlas as a type of their own and set their caption on a bar in the band colour.
const captionStyle = { fontFamily: LABEL, fontSize: pt(9), labelColor: col('band'),
position: 'above', gap: mm(1.6), note: { fontSize: pt(7.8), color: col('muted') } };
const MAP_WORD = t({ en: 'Map', es: 'Mapa' });
const mapType = { id: 'map', name: MAP_WORD, shortLabel: MAP_WORD, captionPrefix: MAP_WORD,
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
captionStyle: { backgroundEnabled: true, background: col('band'), color: col('paper'),
labelColor: col('paper'), padding: mm(1.4) } }; // the bar only; the rest is captionStyle's
// Each map floats from its first :ref to the first slot its placement allows.
const PLACEMENT = {
relief: { position: 'bottom', span: 'page' }, // the foot of the page that cites it
north: { position: 'top' }, // the head of the next free column
harbour: { position: 'top' },
chart: { rotate: 'ccw' }, // turned a quarter, top to the left, on a page of its own
};
// Drawing sizes in mm. Turned, the chart is laid out along 247.6 mm, the text area's 53 grid
// lines less one for the float gap; the bar and the note leave 182.2 mm of the 196 mm measure.
const MAP = { relief: [196, 136], north: [95, 88], harbour: [95, 88], chart: [247.6, 182.2] };
Ingredientes
- Funcionalidades
- Tabelas e figuras em paisagemAmostras de corEstilo de legendaTipos de recurso personalizadosLegendas numeradasCitações que posicionam as figurasPosicionamento de figurasLinhas de fonte e créditoPaleta de cores semânticaAberturas desenhadasFaixa de capítulo em largura totalAtributos de títuloMargens espelhadasTabelas a partir de dadosEstilo de tabelaChips no textoCabeços e fóliosFiguras e tabelas como recursosPáginas em um canvas
- Também usa
- Estilos de títuloFigura e Tabela no seu idiomaCor do papelCabeços por tipo de páginaEstilos de parágrafoCabeços por seção
- Tipografia
- Marcellus, Alegreya Sans, Alegreya Sans SC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Uma paleta para a página e para os mapas
const palette = {
ink: '#23282b', paper: '#fbfaf6', // a blue-black on a warm white
band: '#1f4a5c', // the accent: opener band, caption bars, table head, references
road: '#b2432f', // the second colour: roads, lights and the place numbers
muted: '#626a6d', rule: '#c8c2b4', // running heads and notes; hairlines
deep: '#8fb9c6', sea: '#cfe3e8', // the maps' water: over and under 20 m
land: '#efe6cf', hill1: '#d9c9a3', hill2: '#bfa97a', forest: '#7f9b6a', // and their land
};
// col(id) links a colour to its palette entry; the drawings read the same hex from `palette`.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band }) // the defaults' id
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
Os seis tons dos mapas são chaves do mesmo objeto que as cores da página, por isso colorPalette os lista como entradas da paleta e os desenhos tiram os preenchimentos do SVG de palette[id]. A letra branco-papel sobre band, o azul da abertura, das barras de legenda e da linha de cabeçalho da tabela, tem contraste de 9,2:1; road, o único vermelho, fica reservado para estradas, faróis e números de lugares e tem 5,4:1 contra o papel. main-color recebe o hex de band, e os valores padrão ligam títulos, barras de legenda e marcadores de lista a esse id, de modo que qualquer um deles que a configuração deixe sem definir sai no azul do atlas.
#2 · Para onde vai cada mapa
O código é a resposta curta logo acima. O mapa 1 é um flutuante bottom porque um flutuante top na largura da página nunca cai na página que o cita. Os mapas 2 e 3 são flutuantes de coluna top citados na página 1, por isso ocupam o alto das duas colunas da página 2 (Posicionamento). rotate: 'ccw' põe o alto da carta na borda esquerda e lhe dá a página 3 só para ela. Girado, o desenho mede 247,6 mm ao longo da página, as 53 linhas da grade da mancha menos uma para o espaço do flutuante, e 182,2 mm na largura, o que sobra da medida de 196 mm depois da barra de legenda e da nota. Um desenho mais alto seria reduzido e deixaria papel em branco no alto da página.
#3 · Uma legenda desenhada com os mesmos ids
// The bands the maps are filled with, lowest first. Art and key share each palette id, so one hex
// changes both; the unit is spelled out once, since the small caps print an m as an M.
const RELIEF = [
{ id: 'deep', en: 'sea over 20', es: 'mar de más de 20' },
{ id: 'sea', from: -20, en: 'sea under 20', es: 'de menos de 20' },
{ id: 'land', from: 0, en: 'land to 50', es: 'tierra hasta 50' },
{ id: 'hill1', from: 50, en: '50–120', es: '50–120' },
{ id: 'hill2', from: 120, en: 'over 120', es: 'más de 120' },
{ id: 'forest', en: 'woodland', es: 'bosque' },
];
const legend = t({ en: 'In metres: ', es: 'En metros: ' }) // a thin space more after each swatch
+ RELIEF.map((band) => `:swatch{color="${band.id}"} \u2009${t(band)}`).join(' · ');
RELIEF lista as faixas com os ids de paleta e as alturas em que cada uma começa. O desenho preenche cada faixa com palette[id] e a legenda sob o mapa 1 escreve um :swatch com o mesmo id, por isso um hex novo na paleta muda o desenho e a legenda ao mesmo tempo. A legenda dá a unidade uma única vez, por extenso, porque a nota está composta em Alegreya Sans SC, que imprime um m minúsculo como um M em versalete. Na página 2, o texto põe as mesmas amostras de cor ao lado das duas profundidades da água.
#4 · Mapas são recursos, numerados e posicionados pelas citações
// A plan's key: a bare chip keeps each number on the line of its name, and the dot after it.
const key = (names) => names.map((name, i) => `:chip[${i + 1} ${name}${names[i + 1] ? ' ·' : ''}]`
+ '{style="key"}').join(' ');
const TEXTS = t({ // caption, the key under the drawing, and the alt text of each map
en: {
relief: ['The islands: relief and roads', `${legend} · roads in red, ferries dashed`,
'Relief map of Brannay, Orrin, Kellay and Skarra in sand and ochre on blue water, with '
+ 'red roads.'],
north: ['The north end of Brannay', 'Contour interval 25 metres; heights in metres above the '
+ 'sea. The red discs number the places of the gazetteer.', 'The Ward of Brannay, 234 m, in '
+ 'contours, with the Hool Stacks off its north-west point and the road round it to Tofts.'],
harbour: ['Kirkwick harbour', 'Soundings in metres at the lowest tide. '
+ key(['ferry pier and light', 'lifeboat station', 'harbour office', 'fish store', 'kirk']),
'Plan of Kirkwick: one street of houses on a narrow inlet, a pier into its mouth, depths '
+ 'from 2 to 15 m.'],
chart: ['The islands and their approaches, with the gazetteer’s grid', 'Squares of 8 '
+ 'kilometres, lettered west to east and numbered north to south.', 'Chart of the group '
+ 'and the mainland coast on a lettered grid, with the seventeen places in red discs.'],
table: ['Gazetteer of the numbered places', 'Squares are those of :ref{id="chart"}.'],
},
es: {
relief: ['Las islas: relieve y carreteras', `${legend} · carreteras en rojo, `
+ 'transbordadores a trazos', 'Relieve de Brannay, Orrin, Kellay y Skarra en tintas de '
+ 'arena y ocre sobre agua azul, con las carreteras en rojo.'],
north: ['El extremo norte de Brannay', 'Equidistancia de las curvas: 25 metros; alturas en '
+ 'metros sobre el mar. Los discos rojos numeran los lugares del nomenclátor.', 'El Ward '
+ 'of Brannay, de 234 m, en curvas de nivel, con los Hool Stacks frente a su punta noroeste '
+ 'y la carretera de Tofts.'],
harbour: ['El puerto de Kirkwick', 'Sondas en metros con la marea más baja. '
+ key(['muelle y luz', 'estación de salvamento', 'oficina del puerto', 'almacén de pescado',
'iglesia']), 'Plano de Kirkwick: una calle de casas junto a una ensenada estrecha, un '
+ 'muelle en su boca y fondos de 2 a 15 m.'],
chart: ['Las islas y sus accesos, con la cuadrícula del nomenclátor', 'Cuadros de 8 '
+ 'kilómetros, con letras de oeste a este y números de norte a sur.', 'Carta del grupo y de '
+ 'la costa de tierra firme en cuadros, con los diecisiete lugares en discos rojos.'],
table: ['Nomenclátor de los lugares numerados',
'Los cuadros son los del :ref{id="chart" case="lower"}.'],
},
});
const svgResource = (id, [w, h], more) => ({ id, typeId: 'map', kind: 'svg', createdAt: 0,
updatedAt: 0, svg: { fileId: `${id}.svg`, width: w * 10, height: h * 10 }, ...more });
const resources = [
...Object.keys(MAP).map((id) => svgResource(id, MAP[id], { placement: PLACEMENT[id],
caption: TEXTS[id][0], note: TEXTS[id][1], altText: TEXTS[id][2] })),
svgResource('rose', [ROSE, ROSE], { altText: t({ en: 'Compass rose',
es: 'Rosa de los vientos' }) }),
{ id: 'gazetteer', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
caption: TEXTS.table[0], note: TEXTS.table[1], placement: { position: 'top', span: 'page' },
table: { model: gazetteer() } },
];
const drawings = { relief: reliefMap, north: northMap, harbour: harbourMap, chart: chartMap };
for (const [id, draw] of Object.entries(drawings)) await loadSvg(`${id}.svg`, draw(MAP[id]));
await loadSvg('rose.svg', rose(ROSE)); // drawn by the opener, never cited, so never numbered
Um recurso recebe o número da primeira citação dele no texto, e :ref{id="north"} imprime o rótulo curto do tipo e esse número, Map 2, no texto corrido ou numa nota de legenda. A carta e o índice toponímico são citados pela primeira vez na página 2, nessa ordem, de modo que a carta fica com a página 3 e o índice com o alto da página 4. A rosa dos ventos é um recurso do mesmo tipo, mas só a abertura a desenha e o texto nunca a cita, por isso os mapas continuam contando de 1 a 4. Cada entrada da chave do porto é um único chip sem preenchimento, borda nem espaçamento interno, de modo que o número, o nome e o ponto depois dele ficam na mesma linha.
#5 · Números que os mapas e o índice toponímico compartilham
const CHART = { y0: -5, square: 8 }; // Map 4's grid: 8 km squares from its top-left corner
const PLACES = [ // name, what it is (en, es), island, x and y in km on the sheet, map mark
['Skarra', ['lighthouse', 'faro'], 'Skarra', 34.4, 5.4, 'light'],
['Hool Stacks', ['sea stacks', 'farallones'], 'Brannay', 22.8, 9],
['Kellay', ['gannet colony', 'colonia de alcatraces'], 'Kellay', 5.4, 10.6],
['Ward of Brannay', ['summit, 234 m', 'cumbre, 234 m'], 'Brannay', 26.38, 12.04, 'summit'],
['Hesta Ness', ['headland', 'cabo'], 'Brannay', 30.1, 15.9],
['Tofts', ['hamlet', 'aldea'], 'Brannay', 22.7, 14.9, 'village'],
['Kirkwick', ['village and ferry pier', 'pueblo y muelle'], 'Brannay', 28.3, 15, 'village'],
['St Brendan’s', ['ruined chapel', 'capilla en ruinas'], 'Brannay', 23.8, 21.6, 'chapel'],
['Brannay Sound', ['strait', 'estrecho'], '—', 25.6, 22.7],
['Scarfa Ness', ['headland', 'cabo'], 'Orrin', 36.3, 22.3],
['Carrick', ['mainland port', 'puerto de tierra firme'], '—', 59.4, 21.2, 'village'],
['Orrinsetter', ['hamlet', 'aldea'], 'Orrin', 31.7, 24.8, 'village'],
['Housa Stone', ['standing stone', 'menhir'], 'Orrin', 29.4, 25.6, 'stone'],
['Leury Sands', ['beach', 'playa'], 'Brannay', 10.9, 25.6],
['Holm of Orrin', ['islet', 'islote'], 'Orrin', 37.74, 28.4],
['Pollwick', ['bay', 'bahía'], 'Orrin', 32.4, 28.3],
['Tang Skerry', ['rock and beacon', 'roca y baliza'], '—', 25.08, 28.88, 'light'],
].map(([name, [en, es], island, x, y, mark]) => ({ name, kind: t({ en, es }), island, x, y, mark }))
.sort((a, b) => a.y - b.y).map((place, i) => ({ ...place, no: i + 1 }));
const square = ({ x, y }) => 'ABCDEFGH'[Math.floor(x / CHART.square)]
+ (Math.floor((y - CHART.y0) / CHART.square) + 1); // the square the place falls in
function gazetteer() {
const heads = t({ en: ['No.', 'Place', 'What it is', 'Island', 'Square'],
es: ['N.º', 'Lugar', 'Qué es', 'Isla', 'Cuadro'] });
const cells = (row, isHeader = false) => row.map((content) => ({ content, isHeader }));
let m = { headerRowCount: 1, columnWidths: [8, 34, 42, 18, 12], rows: [cells(heads, true),
...PLACES.map((p) => cells([`:chip[${p.no}]{style="no"}`, `**${p.name}**`, p.kind, p.island,
square(p)]))] };
for (let row = 0; row < m.rows.length; row++) {
for (const c of [0, 4]) m = setAlignment(m, { row, col: c }, 'center');
}
return m; // the zebra rows are the table style's: tableStyle.bodyAlternateBackground
}
PLACES está ordenada de norte a sul e numerada nessa ordem, e os mapas imprimem os números em discos vermelhos e a tabela em chips vermelhos. square() calcula o quadrado da carta a partir das mesmas coordenadas em quilômetros que posicionam cada marca nos mapas, por isso Kirkwick, número 6, fica em D3 na carta e na tabela. O azul-claro de uma linha sim, outra não vem do estilo de tabela: bodyAlternateBackgroundEnabled, com bodyAlternateBackground vinculado a sea.
#6 · O nome do atlas numa faixa do seu próprio azul
const BAND = 80; // mm from the trim to the foot of the band
const AIR = 7; // mm at least between the band and the first line of text
const ROSE = 50; // mm across the compass rose
const pin = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(size && { size }) }); // to: 'page', 'bleed' or '#id' of an element listed before
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'left',
overflow: 'wrap', placement, ...extra }); // a long running head wraps too, never '…'
const opener = { enabled: true,
// The band reserves down to its foot; minHeight adds AIR, in whole grid lines.
minHeight: pt(LEAD * Math.ceil((BAND + AIR - PAGE.top) / (LEAD * PT))),
slot: { elements: [ // array order is paint order
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') },
placement: pin('bleed', 'top-left', 0, 0, { height: mm(BAND) }) }, // no width: edge to edge
{ kind: 'image', id: 'rose', resourceId: 'rose', // page 1 is a recto: the fore-edge is right
placement: pin('page', 'top-right', -PAGE.outer, (BAND - ROSE) / 2, { width: mm(ROSE),
height: mm(ROSE) }) },
text('kicker', '{attr.sheet} · {titleText}', LABEL, 9.5, 'sea', pin('page', 'top-left',
PAGE.inner, 23), { fontWeight: 500, letterSpacing: pt(1.4) }),
text('title', '{title}', DISPLAY, 56, 'paper', pin('#kicker', 'below', -1, 2),
{ lineHeight: 1 }),
text('lead', '{attr.lead}', TEXT, 10.5, 'sea', pin('#title', 'below', 1, 3,
{ width: mm(128) }), { italic: true, lineHeight: 1.35 }),
] } }; // hook-up: headings.levels[0] = { span: 'page', breakBefore, advancedDesign: opener }
A faixa é uma caixa ancorada em 'bleed' e sem largura definida, de modo que vai de uma borda à outra. O título grande é {title}, o nome do atlas no front matter, e o texto do próprio título vem depois do número da folha no antetítulo. Sozinha, a faixa reserva espaço até o pé, e o texto começaria 3,9 mm abaixo dela; minHeight aumenta a reserva para 14 linhas da grade abaixo da margem superior, o que faz o texto começar 8,7 mm abaixo da faixa.
A receita completa
// ═══ Postext Cookbook · Nº 067 · Atlas sheet: numbered maps and a rotated overview ═════
// https://postext.dev/en/cookbook/atlas-map-sheet
// Code: MIT · Text: original (CC BY 4.0) · Maps: generated in code from seed 1874 (CC BY 4.0)
// Fonts: Marcellus, Alegreya Sans, Alegreya Sans SC (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
setAlignment,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'atlas-map-sheet';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the page's colours and the maps' tints, one object for both
const palette = {
ink: '#23282b', paper: '#fbfaf6', // a blue-black on a warm white
band: '#1f4a5c', // the accent: opener band, caption bars, table head, references
road: '#b2432f', // the second colour: roads, lights and the place numbers
muted: '#626a6d', rule: '#c8c2b4', // running heads and notes; hairlines
deep: '#8fb9c6', sea: '#cfe3e8', // the maps' water: over and under 20 m
land: '#efe6cf', hill1: '#d9c9a3', hill2: '#bfa97a', forest: '#7f9b6a', // and their land
};
// col(id) links a colour to its palette entry; the drawings read the same hex from `palette`.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band }) // the defaults' id
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Alegreya Sans', 'Marcellus', 'Alegreya Sans SC'];
const PAGE = { w: 230, h: 300, top: 22, bottom: 22, inner: 18, outer: 16 }; // mm, mirrored
const LEAD = 13.5; // pt: the body's leading and baseline grid
const PT = 25.4 / 72; // mm in a point
// #region answer: a Map type captioned on a bar above the drawing, and where each map goes
// Every caption stands above its drawing or table, in the label face. Maps count 1, 2, 3…
// through the atlas as a type of their own and set their caption on a bar in the band colour.
const captionStyle = { fontFamily: LABEL, fontSize: pt(9), labelColor: col('band'),
position: 'above', gap: mm(1.6), note: { fontSize: pt(7.8), color: col('muted') } };
const MAP_WORD = t({ en: 'Map', es: 'Mapa' });
const mapType = { id: 'map', name: MAP_WORD, shortLabel: MAP_WORD, captionPrefix: MAP_WORD,
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
captionStyle: { backgroundEnabled: true, background: col('band'), color: col('paper'),
labelColor: col('paper'), padding: mm(1.4) } }; // the bar only; the rest is captionStyle's
// Each map floats from its first :ref to the first slot its placement allows.
const PLACEMENT = {
relief: { position: 'bottom', span: 'page' }, // the foot of the page that cites it
north: { position: 'top' }, // the head of the next free column
harbour: { position: 'top' },
chart: { rotate: 'ccw' }, // turned a quarter, top to the left, on a page of its own
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
#Gire a carta para o outro lado
Girada no sentido horário, a carta fica com o alto e a barra de legenda na borda externa da página 3, e o leitor gira o livro no sentido oposto ao da convenção usual, que é a que 'ccw' segue.
- chart: { rotate: 'ccw' }, // turned a quarter, top to the left, on a page of its own
+ chart: { rotate: 'cw' }, // turned a quarter, top to the right, on a page of its own#Gire uma tabela
Uma tabela gira com a mesma configuração e, quando é larga demais para uma página, continua girada na seguinte sob uma linha de cabeçalho repetida: veja o almanaque da horta.
#Ponha um mapa na margem
Num layout de coluna e meia, a coluna externa pode receber figuras e as legendas, sem texto: veja o livro didático com coluna na margem.
Erros comuns
Erro comum
Um flutuante 'top' vai para a página seguinte à sua citação, a menos que possa encabeçar a página que o cita
Por padrão um flutuante nunca fica acima da própria referência, então um flutuante 'top' na largura da página citado na página N abre a página N+1. Com placement.citingPage: true no recurso ou no defaultPlacement do seu tipo (ou layout.floatsAtCitingPage para o livro todo, desde o postext 1.25) ele encabeça a página N, e o texto acima da referência desce para baixo dele, quando cabe dentro de layout.maxTopFraction e a linha que o cita continua nessa página. Nunca encabeça a primeira página de um capítulo nem uma página depois de uma quebra forçada: ali continua abrindo a página seguinte, e 'auto' ou 'bottom' podem ocupar o pé da página que o cita. Posicionamento de figuras →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Marcellus (SIL OFL 1.1) · Alegreya Sans (SIL OFL 1.1) · Alegreya Sans SC (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)

