Em poucas palavras
Uma novela inteira em catalão, composta como um livrinho de bolso. As palavras se dividem no fim da linha como pedem as normas catalãs, inclusive o l duplo com ponto.
O que você vai compor
El transplantat, de Narcís Oller, completo, com o texto das Obres completes (Barcelona, 1928), num livro de bolso de 12 × 18,5 cm e 32 páginas. Antes dos quatro capítulos vêm uma falsa folha de rosto, um frontispício com o padeiro diante do forno, a folha de rosto em Cormorant Garamond itálico vermelho e uma nota sobre a edição. Cada capítulo abre sob uma gravura de doze linhas de altura, com o número romano em vermelho. O texto, em Gentium Book Plus de 9,85 pt, se divide pelas sílabas catalãs como pede o Institut d’Estudis Catalans: no mínimo duas letras de cada lado, nenhuma quebra entre vogais em hiato nem logo depois de um apóstrofo, e titil·laven quebra como titil- | laven, com o hífen no lugar do ponto alto. Os diálogos levam travessão, e as citações, «cometes baixes».
Esta receita responde a
- Como consigo boa justificação e hifenização em textos em espanhol, francês ou alemão?
- Como dou a cada capítulo sua própria foto, cor ou variante de abertura?
- Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?
- 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?
A resposta curta
const LOCALE = 'ca'; // the exact bundled code: 'ca-ES' resolves to it too (postext ≥ 1.14)
const bodyText = { // config().bodyText
fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
firstLineIndent: mm(4.5), indentAfterHeading: false,
// The defaults justify, hyphenate in config().locale and break by Knuth–Plass. With 'ca'
// the dictionary follows the IEC: two letters on each side (ter-ra, cai-xa), no split in
// a hiatus (cièn-cia) or after an apostrophe (s’ha-via), l·l broken with the hyphen for the
// dot. From 1.30 the face is asked for its Catalan forms too: this one has a single dot.
// compounds: false divides arrossegar-se only at its own hyphen (Llibre d’estil, VI 2.5).
hyphenation: { compounds: false },
// Spaces from 0.7× to 1.6×, then up to 10‰ of tracking; a last line under 22 characters is
// a runt. A line that must keep d’inaugurar-se whole still opens to 1.94× on page 7.
maxWordSpacing: 1.6, minWordSpacing: 0.7, maxJustifyTracking: 10, runtMinCharacters: 22,
hyphenateAcrossColumns: false, // no page ends on a divided word
};
Ingredientes
- Funcionalidades
- Hifenização e idioma do documentoQuebra de linha ótima (Knuth–Plass)Capas, folhas de rosto e colofõesAberturas desenhadasImagens nos designs de páginaEstilos de títuloAtributos de títuloTextos, fios e caixas nos designs de páginaCapítulos que abrem em página ímparCabeços e fóliosCabeços por tipo de páginaMargens espelhadasCor do papelEstilos de parágrafoTipos de recurso personalizadosViúvas, órfãs e linhas curtasMetadados do documentoPaleta de cores semânticaExportação para PDFFontes incorporadas ao PDF
- Tipografia
- Gentium Book Plus, Cormorant Garamond, Cormorant SC (SIL OFL 1.1)
- Materiais
cap1-1200.jpgcap2-1200.jpgcap3-1200.jpgcap4-1200.jpgfrontis-1000.jpg- Engraving, frontispiece: the baker at his oven's door (Generated With Diffusion Models, original)
- Engraving, chapter I: the night train into Barcelona (Generated With Diffusion Models, original)
- Engraving, chapter II: the village street in autumn (Generated With Diffusion Models, original)
- Engraving, chapter III: the Rambla at dawn (Generated With Diffusion Models, original)
- Engraving, chapter IV: the old man by the railway (Generated With Diffusion Models, original)
Preparo
#1 · O catalão pelo seu código
O código é a resposta curta lá em cima. locale: 'ca' escolhe os padrões catalães, que desde o postext 1.14 seguem o Llibre d’estil do IEC (idiomas suportados). São os padrões que o TeX usa, com no mínimo duas letras de cada lado da quebra em vez das três que o pacote do npm traz, de modo que ter-ra, cai-xa e plu-ja podem quebrar. Vogais em hiato ficam juntas (cièn-cia, ca-mions), mas um i entre vogais abre a sílaba (fe-ia). A ela geminada quebra entre os dois l: a linha termina em titil- e a seguinte começa com laven, sem ponto alto em nenhuma das duas, e o Knuth–Plass mede a linha sem o ponto.

compounds: false mantém o verbo e o pronome inteiros, a não ser pelo hífen que já os une (arrossegar- | se), a quebra que o IEC prefere (hifenização). Custa uma linha frouxa: na página 7, a linha anterior a d’inaugurar-se abre os espaços até 1,88 vez, mesmo com maxJustifyTracking: 10 absorvendo o excesso nas outras linhas.
#2 · Uma página de bolso feita de linhas inteiras
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
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 * LINE),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};
A margem inferior sai do formato de refile, da margem superior e de LINES, de modo que a mancha comporta 29 linhas de 14 pt e toda página cheia termina na mesma linha de base. A medida de 89 mm dá cerca de 63 caracteres de Gentium Book Plus. mirror: true mantém a margem de 16 mm no lado da lombada nas duas páginas da página dupla (margens espelhadas).
#3 · Uma abertura para os quatro capítulos
// # II {style="capitol" art="cap2"}: the art attribute names the picture's resource.
const PICTURE = { width: MEASURE, height: 12 * LINE }; // 89 × 59.3 mm: twelve lines, 3:2
const chapter = { id: 'capitol',
breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
marginBottom: pt(0), // the opener's own height already ends on a line
advancedDesign: { enabled: true, minHeight: pt(16 * LEAD), slot: { elements: [
{ kind: 'image', id: 'art', resourceId: '{attr.art}',
placement: at('container', 'top', 0, 0,
{ width: mm(PICTURE.width), height: mm(PICTURE.height) }) },
// The numeral and its rule hang from the container's top, a fixed drop under the picture.
text('numeral', '{titleText}', DISPLAY, 21, at('container', 'top', 0, PICTURE.height + 4),
{ fontWeight: 600, color: col('vermell'), lineHeight: 1 }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
placement: { ...at('container', 'top', 0, PICTURE.height + 13), size: { width: mm(8) } } },
] } },
};
resourceId: '{attr.art}' desenha a imagem que o título indica, de modo que # II {style="capitol" art="cap2"} abre o capítulo II sob a própria gravura, com o mesmo estilo dos outros (atributos de título). minHeight guarda dezesseis linhas, doze para a gravura e quatro para o número e o fio, de modo que o texto começa na décima sétima linha da página, igual em todos os capítulos.
#4 · Quatro páginas antes do capítulo I
const front = (id, elements, { minHeight, ...extra } = {}) => ({ id,
breakBefore: { enabled: true, parity: 'any' }, marginBottom: pt(0),
header: { elements: [] }, footer: { elements: [] }, ...extra,
advancedDesign: { enabled: true, ...(minHeight && { minHeight }), slot: { elements } } });
const FRONTIS = { width: MEASURE, height: MEASURE * 1.5 }; // mm: the engraving is 2:3
const headingStyles = [
front('avantportada', [text('title', '{titleText}', DISPLAY, 19,
at('container', 'top', 0, 9 * LINE), { italic: true, fontWeight: 500, lineHeight: 1 })]),
front('frontis', [
{ kind: 'image', id: 'art', resourceId: '{attr.art}',
placement: at('container', 'top', 0, 0,
{ width: mm(FRONTIS.width), height: mm(FRONTIS.height) }) },
text('legend', '{titleText}', LABEL, 8.5, at('container', 'top', 0, FRONTIS.height + 5),
{ ...caps(8.5, 1.4, 'muted') }),
]),
front('portada', [
text('author', '{author}', LABEL, 10, at('container', 'top', 0, 5 * LINE),
caps(10, 2.2, 'ink')),
text('title', '{titleText}', DISPLAY, 34, at('container', 'top', 0, 8 * LINE),
{ italic: true, fontWeight: 500, color: col('vermell'), lineHeight: 1 }),
text('subtitle', '{subtitle}', DISPLAY, 13, at('container', 'top', 0, 8 * LINE + 17),
{ italic: true, fontWeight: 500 }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('vermell'),
placement: { ...at('container', 'top', 0, 8 * LINE + 29), size: { width: mm(14) } } },
]),
// The note sits low on the verso behind the title, its label a line above it.
front('nota', [text('label', '{titleText}', LABEL, 8.5, at('container', 'top', 0, 13 * LINE),
caps(8.5, 1.4))], { minHeight: pt(15 * LEAD) }),
chapter,
];
Cada peça dos elementos pré-textuais é um título de nível 1 com estilo próprio: # El transplantat {style="portada"} imprime o autor e o subtítulo do front matter e o próprio título como título. Cada estilo repete a quebra de página, já que um estilo herda a do nível, e esvazia o cabeçalho e o rodapé, de modo que essas páginas não levam cabeços nem fólios. O frontispício cai na página 2, um verso, e fica de frente para a folha de rosto na página dupla.
#5 · O autor no verso, o título no recto
const SHIFT = (INNER - OUTER) / 2; // mm: the text block's centre is off the page's centre
const head = (id, content, parity, edge, x, y = 10, pages = 'body') => ({
kind: 'text', id, content, parity, pages, ...caps(8, 1.3, 'muted'),
placement: at('page', edge, x, y),
});
const folio = { fontFamily: TEXT, fontWeight: 400, 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,
-11, 'opener'), ...folio });
const footer = { elements: [drop('odd', SHIFT), drop('even', -SHIFT)] };
parity põe o autor nas páginas pares e o título nas ímpares; pages: 'body' tira os dois das aberturas, onde entra um fólio no pé com pages: 'opener'. SHIFT centra cada cabeço sobre a mancha, que fica meio milímetro deslocada do centro da página porque as duas margens não medem o mesmo.
#6 · Cinco gravuras, sem legenda
const resourceTypes = [{ id: 'gravat', name: 'Gravat', namePlural: 'Gravats', shortLabel: 'Gravat',
captionPrefix: '', numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }];
const PICTURES = { // id: [file, width, height, alt text in the book's language]
frontis: ['frontis-1000.jpg', 1000, 1500, 'Un carrer de poble al capvespre. A la porta del forn, '
+ 'on cremen les flames, el forner, gras i somrient, amb davantal blanc i els braços creuats.'],
cap1: ['cap1-1200.jpg', 1200, 800, 'De nit, el tren baixa cap a Barcelona: rengleres de fanals, '
+ 'la muntanya de Montjuïc i la lluna sobre el mar. Un pagès treu el cap per la finestreta.'],
cap2: ['cap2-1200.jpg', 1200, 800, 'Un carrer de poble buit en una nit de tardor. Per la porta '
+ 'baixa de la ferreria, el manyà pica l’enclusa enmig d’una estrella d’espurnes.'],
cap3: ['cap3-1200.jpg', 1200, 800, 'La Rambla a trenc d’alba des d’un balcó. Un fanaler apaga '
+ 'el gas amb la perxa; al fons, els pals dels vaixells del port.'],
cap4: ['cap4-1200.jpg', 1200, 800, 'Capvespre als afores. Un vell de cabells blancs, assegut '
+ 'al caire del desmunt, mira la via del tren, que es perd recta fins a l’horitzó.'],
};
const resources = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
id, typeId: 'gravat', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
bitmap: { fileId, format: 'jpeg', width: w, height: h } }));
As imagens pertencem a um tipo de recurso com captionPrefix vazio, por isso nada as numera nem as rotula. Cada uma é declarada com o tamanho em pixels e carregada com o identificador de arquivo antes da composição. Antes de salvá-las, o branco foi levado ao creme da página e o preto à tinta do texto, e por isso elas se imprimem como parte da página, não como fotos coladas por cima.
A receita completa
// ═══ Postext Cookbook · Nº 104 · A Catalan novella, hyphenated by the IEC rules ═══════
// https://postext.dev/en/cookbook/catalan-pocket-novella
// Code: MIT · Text: N. Oller, El transplantat, 1928 (PD, Viquitexts) · Pictures: diffusion models
// Fonts: Gentium Book Plus, Cormorant Garamond, Cormorant SC (OFL) · Needs postext ≥ 1.57.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document (the sample is Catalan in both)
const RECIPE = 'catalan-pocket-novella';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#2a2320', // text: a warm near-black, the pictures' ink too
vermell: '#953222', // the one accent: chapter numerals, rules, the title page's title
muted: '#6e6359', // running heads, the edition's note, the colophon
paper: '#f5efe1', // a cream book paper, the pictures' white
};
// Each colour names its palette entry and carries its hex.
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: 'vermell (defaults)', value: { hex: palette.vermell, model: 'hex' } },
];
const [TEXT, DISPLAY, LABEL] = ['Gentium Book Plus', 'Cormorant Garamond', 'Cormorant SC'];
const [BODY, LEAD] = [9.85, 14]; // pt: body and leading, the pitch of every vertical measure
const LINE = (LEAD * 25.4) / 72; // mm: one line, 4.94
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, fontFamily, size, placement, extra = {}) => ({ kind: 'text', id,
content, fontFamily, fontSize: pt(size), color: col('ink'), align: 'center',
overflow: 'wrap', placement, ...extra }); // a long title takes a second line
const caps = (size, tracking, color = 'vermell') => ({ fontFamily: LABEL, fontSize: pt(size),
fontWeight: 600, letterSpacing: pt(tracking), color: col(color) });
// #region page: a 12 × 18.5 cm pocket book; the text block holds 29 whole lines
const TRIM = { width: 120, height: 185 }; // mm
const [TOP, INNER, OUTER, LINES] = [18, 16, 15, 29];
const MEASURE = TRIM.width - INNER - OUTER; // 89 mm: about 63 characters of Gentium Book Plus
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 * LINE),
left: mm(INNER), right: mm(OUTER), mirror: true }, // left is the inner margin on a recto
};
// #endregion
// #region answer: Catalan by its own code: l·l breaks as il- | lusió, no word splits its hiatus
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
#Deixar que os pronomes também se dividam
Com o padrão compounds: true, d’inaugurar-se quebra dentro do verbo, d’i- | naugurar-se, e a página 7 perde a linha frouxa: nenhuma linha do livro passa de 1,6 vez. A quebra titil- | laven continua na página 27. O preço é um i sozinho depois do apóstrofo no fim da linha.
- hyphenation: { compounds: false },
+ hyphenation: { compounds: true },#Abrir cada capítulo numa página ímpar
parity: 'odd' acrescenta uma página em branco antes de um capítulo que começaria numa página par, como numa edição mais folgada. O capítulo IV, que abre na página 26, passa para a 27, depois de uma página em branco.
- breakBefore: { enabled: true, parity: 'any' }, // a chapter opens on the next page, either side
+ breakBefore: { enabled: true, parity: 'odd' },Erros comuns
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 →
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 →
- Veja como uma fonte de texto compõe l·l antes de ficar com ela. Desde o postext 1.30 o
localedo documento é também o idioma em que o texto é composto (até a 1.29 era o da página que mostrava o livro), e cada fonte responde ao catalão do próprio jeito. A Gentium Book Plus tem um único ponto alto para todos os idiomas, com 0,17 em entre os dois l. A Crimson Pro, que compôs este livro até a 1.29, alarga o ponto para 0,59 em em catalão e deixa um buraco em intel·ligent. A Alegreya e a Literata desenham um ponto mais fechado só onde os dois l chegam a elas numa mesma peça, de modo que il·lustrats sai de um jeito num parágrafo com itálicos e de outro num parágrafo sem eles. - Copie o texto do Viquitexts com os itálicos: Oller marca tentu, Ensanxe e palacio como coloquiais ou castelhanas, e uma exportação em texto simples perde essas marcas. Confira as palavras duvidosas com o fac-símile do volume de 1928: seis vezes a transcrição traz tom- onde o verbo é tornar (tomà, tomaré, tomar), e uma vez jom em vez de jorn.
- Com 6.800 palavras, os cinco arquivos de conteúdo e o kit deixam o script composto com cerca de 69 KB. Um livro inteiro é a maior amostra que um pen comporta; uma obra mais longa vai num pacote
.postext.
Créditos
- Receita
- Ignacio Ferro
- Texto
- El transplantat, complete, from the Obres completes, vol. VI (Barcelona, 1928), with misprints corrected, no opening ¿ ¡ and today’s dialogue dashes · Narcís Oller · domínio público
- The note to the edition · Postext Cookbook · original
- Imagens
- Engraving, frontispiece: the baker at his oven's door · Generated With Diffusion Models · original
- Engraving, chapter I: the night train into Barcelona · Generated With Diffusion Models · original
- Engraving, chapter II: the village street in autumn · Generated With Diffusion Models · original
- Engraving, chapter III: the Rambla at dawn · Generated With Diffusion Models · original
- Engraving, chapter IV: the old man by the railway · Generated With Diffusion Models · original
- Fontes
- Gentium Book Plus (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Cormorant 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)


