Pular para o conteúdo principal
Receita número 64

Receitas · Capítulo 3 · Títulos e aberturas

Edição de cartas: local, data e assinatura

Cartas seguidas, sem quebra de página: local e data de cada uma vêm dos atributos do título, e saudação, assinatura e pós-escrito são estilos de parágrafo.

Nesta página
Saída
Canvas
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 140 × 210 mm
  • 1 coluna
  • Crimson Pro 10/14,4
  • IM Fell DW Pica SC
  • IM Fell French Canon
  • 5 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 52 ms
  • 161 linhas de código

Em poucas palavras

Um livrinho com três cartas entre o rei da Prússia e Voltaire. Mostra como compor a data, a saudação e a assinatura de cada carta, com as cartas seguidas sem começar uma página nova.

O que você vai compor

Cinco páginas de Mon sort est changé, uma edição de 14 × 21 cm com três cartas em francês: as duas que Frederico II escreveu a Voltaire seis e doze dias depois de se tornar rei da Prússia, em junho de 1740, e a carta de Voltaire de 1º de abril de 1778, dois meses antes da morte dele. Na capa, uma fotografia de duas cartas dobradas e um selo de lacre vermelho, gerada com modelos de difusão, repousa sobre um marroquim verde desenhado em código dentro de um filete duplo dourado. Por dentro, as cartas vêm seguidas, sem quebras de página. O título de cada uma traz o número em versaletes vermelhos e os dois correspondentes em itálico Fell, com o local e a data alinhados à direita logo abaixo. A saudação tem uma linha própria, e a assinatura, em versaletes, fecha a carta na margem direita; o pós-escrito de Frederico vem depois da assinatura, um corpo menor. O cabeço de cada página ímpar dá a data da carta.

Esta receita responde a

  • Como componho uma epígrafe, uma dedicatória, uma assinatura ou um olho com aspas grandes?
  • Como consigo boa justificação e hifenização em textos em espanhol, francês ou alemão?
  • Como configuro os cabeços: título do livro na página esquerda, título do capítulo na direita e fólio do lado de fora?

A resposta curta

script.js · linhas 43–68no código completo
// Each letter is a level-1 heading that carries its place and date as attributes:
//   # Frédéric à Voltaire {place="À Charlottembourg" date="6 juin 1740"}
// (a value holds no { or }, and one with " goes in single quotes: gotcha attr-values)
const letterHead = { enabled: true, slot: { elements: [
  // {number} prints the count as numberingTemplate '{1:I}' writes it.
  { kind: 'text', id: 'number', content: 'Lettre {number}', ...sc, fontSize: pt(9),
    letterSpacing: pt(1.8), color: col('seal'), placement: at('container', 'top-left') },
  { kind: 'text', id: 'title', content: '{titleText}', ...fell, fontSize: pt(15),
    color: col('ink'),
    placement: at('#number', 'below', 0, 1) },
  // The dateline spans the measure under the title and sets its words flush right;
  // inlineMarks reads the attribute's marks, so date="1^er^ avril 1778" raises its ordinal.
  { kind: 'text', id: 'dateline', content: '{attr.place}, le {attr.date}.', ...crimson,
    italic: true, fontSize: pt(10.4), color: col('ink'), align: 'right', inlineMarks: true,
    placement: { ...at('#title', 'below', 0, 1.5), size: { width: 'fill' } } },
] } };
// The salutation, the signature and the postscript, each a :::paragraphs{style="…"} container:
//   :::paragraphs{style="signature"}
//   Fédéric.
//   :::
const letterParts = [
  { id: 'vedette', firstLineIndent: pt(0) }, // 'Sire,' on a line of its own, flush left
  { id: 'signature', ...sc, fontSize: pt(10.5), textAlign: 'right', marginTop: pt(LEAD / 2) },
  { id: 'postscript', fontSize: pt(9), lineHeight: pt(12.6), marginTop: pt(LEAD / 2) },
];
// Hooked up below: letterHead designs the level-1 heading, letterParts joins paragraphStyles.

Ingredientes

Tipografia
Crimson Pro, IM Fell French Canon, IM Fell DW Pica SC (SIL OFL 1.1)
Materiais
  • letters-1160.jpg
  • The cover: two folded letters and a wax seal, a photograph (Generated With Diffusion Models, original)
  • The cover’s green morocco and gilt fillet, drawn in code (Ignacio Ferro, CC BY 4.0)

Preparo

#1 · Leia o local e a data do título

O código é a resposta curta logo acima. Cada carta é um título de nível 1 cujos atributos guardam o local e a data, e o título os imprime como {attr.place}, le {attr.date}. (atributos do título). A caixa da data vai até a borda direita da coluna (width: 'fill'), e align: 'right' encosta o texto nessa borda; sem isso, o texto de design sai centralizado. A saudação, a assinatura e o pós-escrito são estilos de parágrafo aplicados com :::paragraphs{style="…"}. A assinatura usa a IM Fell DW Pica SC, uma família cujas minúsculas são desenhadas como versaletes. Com inlineMarks: true, a linha de local e data lê as marcas do atributo, por isso date="1^er^ avril 1778" eleva a terminação do ordinal.

#2 · Componha as cartas em sequência

script.js · linhas 72–78no código completo
const letters = { level: 1, numberingTemplate: '{1:I}', advancedDesign: letterHead,
  // No break: left at the level's default, each letter would open on a recto.
  breakBefore: { enabled: false }, marginTop: pt(2 * LEAD),
  // The hidden heading line is measured in the heading face: italic keeps it the IM Fell cut
  // that FONTS loads. Upright, it would need the roman, which FONTS
  // leaves out; the layout would change only for a title long enough to wrap.
  italic: true };

Com breakBefore desativado, uma carta começa duas linhas da grade (marginTop) abaixo da linha da grade em que a anterior termina. Na página 4, o pós-escrito, com entrelinha de 12,6 pt, termina entre duas linhas da grade, e por isso ficam cerca de três linhas em branco acima da carta III. Na página 2, a carta I vai até o pé da página e a carta II abre a página 3. Com o padrão do nível 1, cada carta abriria numa página ímpar (quebra antes). numberingTemplate: '{1:I}' numera as cartas de I a III, e o título imprime o numeral por {number}.

#3 · Ponha a data da carta na página ímpar

script.js · linhas 82–95no código completo
const HEAD_Y = 12; // mm from the top edge
const head = (id, content, parity, placement, look = {}) => ({ kind: 'text', id, content,
  parity, pages: 'body', ...sc, fontSize: pt(8.5), letterSpacing: pt(0.9), color: col('muted'),
  placement, ...look });
const folio = { ...crimson, fontSize: pt(9), letterSpacing: pt(0), color: col('ink') };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', at('page', 'top-left', MARGIN.outer, HEAD_Y), folio),
  head('verso-names', '{author}', 'even', at('page', 'top-left', MARGIN.outer + 8, HEAD_Y)),
  // {attr.date} reads the last letter that starts on or before the page.
  head('recto-date', '{attr.date}', 'odd', at('page', 'top-right', -(MARGIN.outer + 8), HEAD_Y),
    { ...crimson, italic: true, fontSize: pt(9.5), letterSpacing: pt(0), inlineMarks: true }),
  head('recto-folio', '{pageNumber}', 'odd', at('page', 'top-right', -MARGIN.outer, HEAD_Y),
    folio),
] };

Num cabeçalho de página, {attr.date} pega o atributo do último título de nível 1 que começa naquela página ou antes dela. A página 3 imprime 12 juin 1740, e a página 5, onde continua a carta de Voltaire iniciada na 4, imprime 1er avril 1778 com a terminação elevada (elementos de texto). Os cabeços ficam 12 mm abaixo da borda superior da página, o fólio na margem externa e o texto 8 mm mais para dentro. pages: 'body' os mantém fora da capa, que conta como abertura porque o título ocupa a largura da página. A data é composta no itálico da Crimson Pro, o mesmo do local e data que ela repete, e os nomes na página par, nos versaletes dos números das cartas.

#4 · Faça da capa um título

script.js · linhas 99–121no código completo
// The Markdown: # Mon sort \\ est changé {style="cover"}. The binding fills the page, so the
// design reserves all of it and the headnote starts on page 2.
const onCover = (y) => at('page', 'top', 0, y); // centred, y mm below the top edge
const LETTERS = { x: 12, y: 72, w: 116, h: 120 }; // mm: the photograph, inside the fillet
// numbered: false keeps the cover out of the count, so the first letter is I.
const cover = { id: 'cover', numbered: false,
  // span: 'page' although the book has one column. Kept in the column, the design stops at
  // the column's foot (a band of paper under the leather), and page 1 counts as a 'body' page
  // and prints the running heads.
  span: 'page', advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'image', id: 'binding', resourceId: 'binding',
      placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: 'fill' } } },
    { kind: 'image', id: 'letters', resourceId: 'letters', placement: { ...at('page', 'top-left',
      LETTERS.x, LETTERS.y), size: { width: mm(LETTERS.w), height: mm(LETTERS.h) } } },
    { kind: 'text', id: 'names', content: '{author}', ...sc, fontSize: pt(9.5),
      letterSpacing: pt(2), color: col('gilt'), placement: onCover(18) },
    // \\ in the heading breaks the title here.
    { kind: 'text', id: 'title', content: '{titleText}', ...fell, fontSize: pt(50),
      lineHeight: 1, color: col('paper'), align: 'center', overflow: 'wrap',
      placement: onCover(24) },
    { kind: 'text', id: 'subtitle', content: '{subtitle}', ...crimson, italic: true,
      fontSize: pt(12), color: col('paper'), placement: onCover(62) },
  ] } } };

A capa é o primeiro título, no estilo de título cover: um elemento de imagem ancorado à sangria leva a encadernação desenhada, um segundo põe a fotografia 72 mm abaixo do alto, e o título, os nomes e o subtítulo vêm do título e do front matter. numbered: false a deixa fora da contagem, e assim a primeira carta de Frederico é a I. A imagem da encadernação enche a página, e uma abertura reserva espaço até o elemento mais baixo, de modo que a capa ocupa toda a página 1 e a nota introdutória começa na 2 sem nenhum :::pagebreak.

#5 · Hifenize o francês e mantenha os espaços abertos

script.js · linhas 125–135no código completo
// Justification, hyphenation, whole-paragraph line breaking and the widow, orphan and runt
// rules are defaults; locale 'fr' (in the config) picks the French patterns.
// The letters keep the transcription's unspaced ; : ? and !; a narrow no-break space
// (U+202F) typed before each would give French spacing and never end a line.
const bodyText = { fontFamily: 'Crimson Pro', fontSize: pt(10), lineHeight: pt(LEAD),
  color: col('ink'), firstLineIndent: mm(5),
  // No :ref here: written out with the other colours, for the default-skin check.
  referenceColor: col('ink'),
  // A word space never shrinks below 75 % of the font's. At the default 60 %, the tightest
  // line on page 5 sets its spaces at 0.70 (each VDT line carries its justifiedSpaceRatio).
  minWordSpacing: 0.75 };

locale: 'fr' hifeniza com os padrões franceses (ou-vrage na página 2, représen-tation na página 4). A justificação, a quebra de linhas pelo parágrafo inteiro e as regras de viúvas, órfãs e linhas curtas vêm ativadas por padrão. minWordSpacing: 0.75 impede que um espaço entre palavras encolha abaixo de três quartos do espaço da Crimson Pro; com o padrão 0,6, a linha justificada mais apertada da página 5 comporia os espaços a 0,70 dessa largura. Com entrelinha de 14,4 pt, a página comporta 33 linhas, e a margem inferior é o que sobra abaixo delas, 20,4 mm.

#6 · Ligue cada cor à paleta

script.js · linhas 14–29no código completo
const palette = {
  ink: '#2a2320', // the text: a warm near-black
  paper: '#f6efe2', // the page, and the lettering on the cover
  seal: '#9c2b24', // the letter numbers
  leather: '#2a4536', // the cover: a green morocco binding
  gilt: '#d0b67c', // its tooled border and the names on it
  muted: '#75695d', // the running heads
};
// col(id): a colour linked to its palette entry, in text styles and design elements 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' } })),
  // The engine's default colours, the italic of the headnote among them, link to 'main-color';
  // here it is the ink, not the default blue.
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];

col() liga cada cor à entrada na paleta, e a ligação vale tanto nos estilos de texto quanto nos elementos de design: os títulos das cartas, os cabeços e a capa. O itálico da nota introdutória e do colofão usa a cor de itálico padrão, que está ligada a main-color; com essa entrada na cor da tinta, ele sai na tinta e não no azul do motor, #295AA3.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 064 · Letters edition: datelines and signatures ════════════
// https://postext.dev/en/cookbook/letters-edition
// Code: MIT · Text: Frederick II and Voltaire, 1740 and 1778 (PD) · Cover photo: diffusion models
// Fonts: Crimson Pro, IM Fell French Canon, IM Fell DW Pica SC (SIL OFL) · 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 = 'letters-edition';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: iron-gall ink on cream paper, wax red, green morocco and gilt
const palette = {
  ink: '#2a2320', // the text: a warm near-black
  paper: '#f6efe2', // the page, and the lettering on the cover
  seal: '#9c2b24', // the letter numbers
  leather: '#2a4536', // the cover: a green morocco binding
  gilt: '#d0b67c', // its tooled border and the names on it
  muted: '#75695d', // the running heads
};
// col(id): a colour linked to its palette entry, in text styles and design elements 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' } })),
  // The engine's default colours, the italic of the headnote among them, link to 'main-color';
  // here it is the ink, not the default blue.
  { id: 'main-color', name: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const TRIM = { width: 140, height: 210 }; // the French 14 × 21 format
const LEAD = 14.4; // pt: the body's leading, the grid every letter starts on
const LINES = 33; // lines of text on a full page
const TOP = 22; // mm: the top margin
const MARGIN = { top: TOP, inner: 17.5, outer: 14.5, // mm, mirrored
  bottom: TRIM.height - TOP - (LINES * LEAD * 25.4) / 72 }; // ends the page on line 33
const sc = { fontFamily: 'IM Fell DW Pica SC' }; // its lower case is cut as small capitals
const fell = { fontFamily: 'IM Fell French Canon', italic: true }; // the display italic
const crimson = { fontFamily: 'Crimson Pro' }; // the text face
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });

// #region answer: a letter head read from the heading, and styles for the letter's parts
// Each letter is a level-1 heading that carries its place and date as attributes:
//   # Frédéric à Voltaire {place="À Charlottembourg" date="6 juin 1740"}
// (a value holds no { or }, and one with " goes in single quotes: gotcha attr-values)
const letterHead = { enabled: true, slot: { elements: [
  // {number} prints the count as numberingTemplate '{1:I}' writes it.
  { kind: 'text', id: 'number', content: 'Lettre {number}', ...sc, fontSize: pt(9),

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

#Ponha o local no cabeço

Os mesmos atributos podem dar à página ímpar o local e a data completos, À Charlottembourg, le 12 juin 1740.

-  head('recto-date', '{attr.date}', 'odd', at('page', 'top-right', -(MARGIN.outer + 8), HEAD_Y),
+  head('recto-date', '{attr.place}, le {attr.date}', 'odd',
+    at('page', 'top-right', -(MARGIN.outer + 8), HEAD_Y),

Erros comuns

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 →

  • A página ímpar pega a data da última carta que começa nela ou antes. Uma página que termina uma carta e abre a seguinte traz a data da carta nova, do mesmo modo que o cabeço de um dicionário dá a última entrada da página.
  • Um título sem o atributo imprime um texto vazio, sem aviso: uma carta sem place="…" ganha uma linha de local e data que começa com vírgula. Confira o título de cada carta.
  • As cartas mantêm os ; : ? e ! da transcrição sem espaço antes. A tradição francesa põe ali um espaço fino inseparável (U+202F); digitado ali, ele mantém o sinal na linha da palavra.
  • A Crimson Pro não tem as letras modificadoras ᵉ (U+1D49) e ʳ (U+02B3), por isso 1ᵉʳ escrito em Unicode sairia numa fonte substituta. Escreva 1^er^: a nota introdutória, que é texto corrido, o compõe como sobrescrito, e o mesmo fazem a linha de local e data e o cabeço da página ímpar, cujos elementos de texto levam inlineMarks: true.

Créditos

Texto
  • Frederick II’s letters to Voltaire of 6 and 12 June 1740 and Voltaire’s letter to him of 1 April 1778, in Correspondance de Voltaire avec le roi de Prusse (Paris, Librairie de la Bibliothèque nationale, 1889), one misprint corrected (ouvragés), the salutations and signatures set apart · Frédéric II · Voltaire · domínio público
  • The headnote and the colophon · Ignacio Ferro · CC BY 4.0
Imagens
  • The cover: two folded letters and a wax seal, a photograph · Generated With Diffusion Models · original
  • The cover’s green morocco and gilt fillet, drawn in code · Ignacio Ferro · CC BY 4.0
Fontes
Crimson Pro (SIL OFL 1.1) · IM Fell French Canon (SIL OFL 1.1) · IM Fell DW Pica SC (SIL OFL 1.1)
Sandbox