Em poucas palavras
As primeiras páginas de um romance espanhol de 1878 num livro de bolso. Mostra como manter iguais os espaços entre as palavras, dividindo as palavras nas sílabas certas do espanhol.
O que você vai compor
O início de Marianela (1878), de Galdós, numa edição de bolso de 11,5 × 18 cm, com um mapa conjectural das minas de Socartes de frente para o capítulo I. Acima do título do capítulo, em Libre Bodoni itálico, capítulo primero vem por extenso em versaletes; o texto, em Gentium Book Plus, começa a um quarto da altura da página com uma capitular elevada cor de sangue de boi. As palavras quebram nas sílabas do espanhol (hie-rro, esta-blecimiento) e os espaços entre palavras ficam abaixo de 1,7 vez a largura normal; nenhum parágrafo termina com o resto de uma palavra hifenizada. O diálogo é composto com rayas, os travessões que também abrem e fecham os incisos (apartes) do narrador. A senha do viajante vem entre «comillas latinas», e entre aspas duplas inglesas onde a nota da edição a cita dentro de outra citação. O mapa é a Figura 1, citada no texto como [fig. 1]. Cabeços em Marcellus SC dão o autor nas páginas pares e o título nas ímpares.
Esta receita responde a
- Como consigo boa justificação e hifenização em textos em espanhol, francês ou alemão?
- Como evito viúvas, órfãs e últimas linhas de uma só palavra, e mantenho cada título junto do seu texto?
- Como escrevo travessões de diálogo, anos no início do parágrafo, preços e símbolos literais sem que o Markdown os interprete errado?
- Como faço os rótulos “Figura” e “Tabela” saírem no idioma do meu documento?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
A resposta curta
const LOCALE = 'es'; // config().locale: Spanish hyphenation, and Spanish caption labels
const bodyText = { // config().bodyText
fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
referenceBold: false, // '[fig. 1]' reads in roman, like the words around it
firstLineIndent: mm(4), indentAfterHeading: false, // a paragraph after a heading starts flush
// The defaults justify, hyphenate, break by Knuth–Plass and keep widows and orphans out.
// Long Spanish words on an 86 mm measure need two more settings. Spaces under 1.7×: at
// the default 2×, eight lines here open past 1.6×; at 1.7 it hyphenates hie-rro, ca-lles.
// A last line under 26 space widths is a runt; at 20, 'siem- / pre adelante.' got through.
maxWordSpacing: 1.7, runtMinCharacters: 26,
};
// config().resourceTypes: the built-in types, 'Figura' and 'Fig.' in Spanish, renumbered
// through the book (Figura 1) where the default counts by chapter (Figura 1.1).
const resourceTypes = defaultResourceTypes(LOCALE)
.map((type) => ({ ...type, numberingTemplate: '{n}', resetOn: 'never' }));
Ingredientes
- Funcionalidades
- Hifenização e idioma do documentoQuebra de linha ótima (Knuth–Plass)Capitulares em parágrafos do textoAberturas desenhadasAtributos de títuloTextos, fios e caixas nos designs de páginaViúvas, órfãs e linhas curtasMargens espelhadasCapítulos que abrem em página ímparCabeços por tipo de páginaCabeços e fóliosCitações que posicionam as figurasLegendas numeradasFigura e Tabela no seu idiomaFiguras exatamente aquiEstilos de títuloEspaço vertical explícitoEstilos de parágrafoEscapes e caracteres literaisCor do papel
- Tipografia
- Gentium Book Plus, Libre Bodoni, Marcellus SC (SIL OFL 1.1)
- Materiais
- The conjectural map of the Socartes mines, drawn in code in the page’s palette (Ignacio Ferro, MIT)
Preparo
#1 · Sílabas espanholas, espaços contidos
O código é a resposta curta lá em cima. locale: 'es' escolhe os padrões de hifenização do espanhol, como faz uma etiqueta regional como 'es-ES' ou 'es-MX'; as regras americanas do locale padrão quebrariam cabal-los, hi-erro e establec-imiento (idiomas suportados). A justificação, o Knuth–Plass e as regras de viúvas e órfãs vêm ativados por padrão. A medida de 86 mm também precisa conter os espaços: com o maxWordSpacing: 2 padrão, oito linhas passam de 1,6× e a mais aberta chega a 1,89×; com 1,7, a mais aberta fica em 1,65×, porque o quebrador hifeniza hie-rro e ca-lles em vez disso (limites de espaçamento entre palavras). Acima do limite, uma linha custa muito mais, mas continua sendo permitida, por isso numa medida mais estreita e sem quebra melhor ela ainda pode passar. runtMinCharacters: 26 pega os restos hifenizados que o padrão de 20 larguras de espaço deixa passar: siem- / pre adelante. vira Adelante, / siempre adelante., e So- / cartes [fig. 1]. vira de / Socartes [fig. 1]. (linhas curtas).
#2 · Uma página de bolso feita de linhas inteiras
const TRIM = { width: 115, height: 180 }; // mm: 11.5 × 18 cm
const [TOP, INNER, OUTER] = [16, 15, 14]; // mm: a pocket page keeps its margins tight
const LINES = 30; // lines of LEAD per page, so every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 86 mm: about 57 characters of Gentium at 10 pt
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - (LINES * LEAD * 25.4) / 72),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is inner on a recto
};
A margem inferior é calculada a partir do refile, da margem superior e de LINES, de modo que a mancha comporta exatamente 30 linhas de 13,8 pt e toda página cheia termina na mesma linha de base, como as páginas 10 e 11. Com mirror: true, a margem interna de 15 mm fica junto à lombada e a externa de 14 mm junto ao corte da frente nas duas páginas da página dupla (margens espelhadas), e a medida de 86 mm comporta cerca de 57 caracteres de Gentium Book Plus em 10 pt.
#3 · O capítulo por extenso e uma capitular elevada
const [LABEL_Y, RULE_Y, TITLE_Y] = [4, 10.5, 13.5]; // mm below the top of the text block
const SINK = 8; // lines of LEAD above the text: the chapter drops a quarter of the page
const INITIAL = 3 * LEAD; // pt: the initial's size, three leads
const RISE = 2; // lines of LEAD the raised initial keeps clear above the first line
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
const opener = {
enabled: true,
slot: { elements: [
// The ordinal is written in the heading, # Perdido {ordinal="primero"}: the plate before
// the chapter is a level-1 heading too, so the level carries no counter.
{ kind: 'text', id: 'chapter', content: 'capítulo {attr.ordinal}', ...smallCaps,
placement: centred(LABEL_Y) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
color: col('oxblood'), placement: { ...centred(RULE_Y), size: { width: mm(9) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, italic: true,
fontSize: pt(26), lineHeight: 1.1, color: col('ink'), align: 'center',
overflow: 'wrap', // a longer title takes a second line
placement: centred(TITLE_Y) },
] },
// The text starts SINK lines down; the initial's rise takes the last RISE of them.
minHeight: pt((SINK - RISE) * LEAD),
};
// parity 'any': each chapter opens on the next page, as pocket books do.
// marginBottom replaces the level's default, a blank line of its own. The first paragraph
// of the chapter opens with a raised initial: lines: 1 stands it on the first baseline,
// three leads tall, and the paragraph keeps its rise clear above it.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
marginBottom: pt(0), advancedDesign: opener,
dropCap: { lines: 1, fontFamily: DISPLAY, fontWeight: 700, fontSize: pt(INITIAL),
color: col('oxblood') } };
capítulo primero vem do atributo ordinal do próprio título (atributos de título). Um nível numerado com '{1:ordinal}' escreveria a palavra sozinho, mas a lâmina antes do capítulo também é um título de nível 1, por isso este nível não leva contador. A capitular vem do nível dos capítulos: o dropCap abre o primeiro parágrafo depois de cada título de nível 1, e o parágrafo se escreve no Markdown tal como se lê (capitulares). lines: 1 com um fontSize de três entrelinhas faz dela uma capitular elevada, apoiada na primeira linha de base; a primeira linha é encurtada pela largura dela e pelo espaçamento padrão, e justificada com o resto do parágrafo. A letra sobe acima da primeira linha, e o parágrafo mantém essa subida livre acima dele em linhas inteiras: duas aqui (RISE), por isso minHeight termina a abertura em SINK - RISE linhas e a primeira linha do texto continua caindo na linha SINK, a um quarto da altura da página. O marginBottom: 0 do nível de capítulo substitui a margem padrão, que acrescentaria uma linha em branco. Um parágrafo com capitular perde o recuo da primeira linha.

#4 · O mapa fica de frente para o capítulo como Figura 1
const MAP_H = 112; // mm: a frontispiece map, the measure wide
const resources = [{
id: 'plano', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
svg: { fileId: 'plano.svg', width: MEASURE, height: MAP_H }, // the ratio: set column-wide
placement: { position: 'here' }, // where ::resource{id="plano"} stands, not a float
caption: 'El camino de Golfín: de Villafangosa, por la pasadera y el cerro, al talud de '
+ 'las minas de Socartes.',
note: 'Plano conjetural dibujado para esta edición a partir del capítulo primero.',
altText: 'Plano: abajo, la villa, el río y la pasadera; en medio, un cerro arbolado; arriba, '
+ 'las minas en gradas. Un punteado lleva de la villa al talud de las minas.',
}];
// The plate's heading, # Las minas de Socartes {style="lamina"}, opens a page the heads skip.
const frontispiece = {
id: 'lamina', // its own break, or it takes the chapter's (gotcha: style-inherits-break)
breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(0),
footer: { elements: [] }, // no drop folio
advancedDesign: { enabled: true, slot: { elements: [{ kind: 'text', id: 'name',
content: '{titleText}', ...smallCaps, // a line down: the plate centres on the page
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: pt(LEAD) } } }] } },
};
const captionStyle = { fontFamily: TEXT, fontSize: pt(8.3), gap: mm(2),
labelColor: col('oxblood'), descriptionItalic: true, note: { color: col('muted') } };
position: 'here' põe o mapa onde está ::resource{id="plano"}, sob um título próprio. Esse título faz da página 8 do livro uma abertura, e os cabeços pulam as aberturas. O estilo dele esvazia o rodapé e define a própria quebra, o que mantém a prancha de frente para o capítulo I, sem cabeço nem fólio, mesmo quando os capítulos abrem em páginas ímpares (estilos de título). Os tipos espanhóis da resposta curta imprimem Figura 1. sob o mapa (sem resourceTypes, sai Figura 1.1, numerada por capítulo) e Fig. 1 no texto, que o case="lower" do :ref no Markdown transforma em fig. 1. A referência fica entre colchetes, que as edições espanholas usam para marcar o que o editor acrescenta ao texto do autor.
#5 · O autor na página par, o título na ímpar
const [HEAD_Y, DROP_Y] = [9, -10]; // mm: heads from the top edge, drop folio from the foot
const head = (id, content, parity, edge, x, y = HEAD_Y, pages = 'body') => ({
kind: 'text', id, content, parity, pages, // running heads skip the openers
fontFamily: LABEL, fontSize: pt(8), letterSpacing: pt(1.2), color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } },
});
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
// Folios in the text face (Marcellus SC's 1 and 0 read as I and O), on the heads' baseline.
const folio = { fontFamily: TEXT, letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
{ ...head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER), ...folio },
head('verso-author', '{author}', 'even', 'top', -SHIFT),
head('recto-title', '{title}', 'odd', 'top', SHIFT),
{ ...head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER), ...folio },
] };
const drop = (parity, x) => ({ ...head(`drop-${parity}`, '{pageNumber}', parity, 'bottom', x,
DROP_Y, 'opener'), ...folio }); // a chapter can open on either side of the spread
const footer = { elements: [drop('odd', SHIFT), drop('even', -SHIFT)] };
parity: 'even' põe o autor nas páginas pares e 'odd', o título nas ímpares, e pages: 'body' mantém os dois fora da abertura, onde o único elemento é o fólio ao pé, composto com pages: 'opener'. Cada cabeço é ancorado na página e levado por SHIFT para o centro da mancha, que fica meio milímetro fora do centro da página porque as margens interna e externa são diferentes. O fólio ao pé vem em duas paridades pelo mesmo motivo. Os fólios são compostos em Gentium, porque a Marcellus SC desenha 1 e 0 como I e O.
#6 · Pontuação espanhola no Markdown
const paragraphStyles = [
{ id: 'asterismo', fontFamily: DISPLAY, fontSize: pt(11), color: col('oxblood'),
textAlign: 'center' },
// In ink: a muted note would need italicColor too, for its italic Marianela.
{ id: 'nota', fontSize: pt(8.3), lineHeight: pt(LEAD * 0.8), firstLineIndent: pt(0),
marginTop: pt(LEAD) },
{ id: 'colofon', fontSize: pt(7.5), color: col('muted'), textAlign: 'center',
firstLineIndent: pt(0), marginTop: pt(LEAD / 2) },
];
A página 12, a última, termina com três estilos de parágrafo. Os asteriscos, em Bodoni cor de sangue de boi, ficam centralizados depois de um :::space{lines=2}, já que linhas em branco não acrescentam espaço. A nota da edição tem 8,3 pt sobre 11 pt de entrelinha, e o colofão tem 7,5 pt no cinza dos cabeços. A nota fica na cor da tinta; em cinza, o estilo precisaria também de um italicColor, ou o Marianela em itálico sai mais escuro que as palavras em volta. No Markdown, o diálogo abre com uma raya (—), nunca com um hífen, porque um hífen e um espaço no início de uma linha abrem uma lista. 1878. no início da nota abriria uma lista numerada, de modo que um word joiner (U+2060) vai antes do ano. Os asteriscos são escapados (\*); sem o escape, o primeiro abriria uma lista com marcadores e os outros dois, um trecho em itálico, e a linha desapareceria.
A receita completa
// ═══ Postext Cookbook · Nº 016 · Justified Spanish in a pocket novel ═════════════════
// https://postext.dev/en/cookbook/spanish-pocket-novel
// Code: MIT · Text: B. Pérez Galdós, Marianela, 1878 (PD, Gutenberg #17340) · Map: drawn in code
// Fonts: Gentium Book Plus, Libre Bodoni, Marcellus SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, defaultResourceTypes, registerResourceImage,
inlineSvgFonts,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document (this recipe is Spanish only)
const RECIPE = 'spanish-pocket-novel';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#1e1b18', // text: a warm near-black
oxblood: '#8b2e2a', // the one accent: chapter label, rule, initial, asterisks, route
muted: '#6d645a', // running heads, the map's paths, the caption's credit
paper: '#f7f2e8', // an ivory book paper
slag: '#c8553d', moss: '#6f7a4f', water: '#58707f', // the map: mined earth, woods, river
};
// col(id): a colour linked to its palette entry, in text styles and design slots alike.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'oxblood (defaults)', value: { hex: palette.oxblood, model: 'hex' } },
];
const TEXT = 'Gentium Book Plus'; // the text face
const DISPLAY = 'Libre Bodoni'; // the chapter's title and the initial
const LABEL = 'Marcellus SC'; // small capitals: chapter label, running heads, map names
const [BODY, LEAD] = [10, 13.8]; // pt: the body size, and its leading: the grid's pitch
const smallCaps = { fontFamily: LABEL, fontSize: pt(9), letterSpacing: pt(1.6), // 2 labels
color: col('oxblood'), align: 'center' };
// #region page: a pocket paperback; the text block holds 30 whole lines
const TRIM = { width: 115, height: 180 }; // mm: 11.5 × 18 cm
const [TOP, INNER, OUTER] = [16, 15, 14]; // mm: a pocket page keeps its margins tight
const LINES = 30; // lines of LEAD per page, so every full page ends on the same line
const MEASURE = TRIM.width - INNER - OUTER; // 86 mm: about 57 characters of Gentium at 10 pt
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
margins: { top: mm(TOP), bottom: mm(TRIM.height - TOP - (LINES * LEAD * 25.4) / 72),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is inner on a recto
};
// #endregion
// #region answer: Spanish syllables, word spaces under 1.7×, captions that say Figura
const LOCALE = 'es'; // config().locale: Spanish hyphenation, and Spanish caption labels
const bodyText = { // config().bodyText
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
#Abra cada capítulo numa página ímpar
Com 'odd', um capítulo que começaria numa página par recebe uma página em branco antes, como numa edição mais folgada. O capítulo I já abre numa ímpar, e a prancha mantém a página porque o estilo dela define a própria quebra.
-const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
+const chapter = { level: 1, breakBefore: { enabled: true, parity: 'odd' },#Numere as figuras por capítulo
Sem ajustes, os tipos espanhóis padrão numeram as figuras dentro de cada título de nível 1: o mapa vira Figura 1.1 e a referência, fig. 1.1.
-const resourceTypes = defaultResourceTypes(LOCALE)
- .map((type) => ({ ...type, numberingTemplate: '{n}', resetOn: 'never' }));
+const resourceTypes = defaultResourceTypes(LOCALE);Erros comuns
Erro comum
'1998. ' ou '- ' no início de um parágrafo abre uma lista
Um parágrafo que começa com um número, um ponto e um espaço, ou com um hífen e um espaço, vira item de lista. Coloque um word joiner (U+2060) antes do número e escreva os diálogos com travessão. Escapes e caracteres literais →
Erro comum
Valores de atributo: sem { ou }; aspas simples se tiver "
Um valor de atributo termina na chave de fechamento, por isso não pode conter { nem }. Um valor que contém aspas duplas vai entre aspas simples; o cifrão não causa problema. Atributos de título →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
- Um rebaixo de nove linhas em vez de oito deixou a página 11 com uma linha a menos, porque
avoidWidowsnão deixaria um parágrafo começar na última linha da página. Depois de qualquer mudança nos ajustes ou no texto, confira o pé de cada página. RISEé o número de linhas que a capitular elevada mantém livres acima do texto. Outra fonte ou outro corpo mudam essa subida: uma inicial menor pode precisar de uma linha só, e o texto então começa uma linha mais acima, a menos queminHeightmude junto.- Nenhuma destas fontes tem o asterismo ⁂ (U+2042) no arquivo latin do Fontsource, por isso o navegador o tiraria de uma fonte do sistema. De todo modo, os livros espanhóis marcam a pausa com três asteriscos espaçados.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Marianela (1878), the opening of chapter I, “Perdido”, with today’s spelling and punctuation · Benito Pérez Galdós · domínio público
- The edition’s note and the map’s caption · Postext Cookbook · original
- Imagens
- The conjectural map of the Socartes mines, drawn in code in the page’s palette · Ignacio Ferro · MIT
- Fontes
- Gentium Book Plus (SIL OFL 1.1) · Libre Bodoni (SIL OFL 1.1) · Marcellus 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)


