En poques paraules
Un llibret amb tres cartes entre el rei de Prússia i Voltaire. Ensenya a compondre la data, la salutació i la signatura de cada carta, amb les cartes seguides sense començar pàgina nova.
Què compondràs
Cinc pàgines de Mon sort est changé, una edició de 14 × 21 cm amb tres cartes en francès: les dues que Frederic II va escriure a Voltaire sis i dotze dies després de pujar al tron de Prússia, el juny del 1740, i la que Voltaire li va enviar l'1 d'abril del 1778, dos mesos abans de morir. A la coberta, una fotografia generada amb models de difusió mostra dues cartes plegades i un segell de lacre vermell sobre un marroquí verd dibuixat amb codi, amb doble filet daurat. A dins, les cartes van seguides, sense salt de pàgina. L'encapçalament de cadascuna porta el número en versaletes vermelles i els noms dels corresponsals en cursiva Fell, amb el lloc i la data a sota, a la dreta. La salutació va en una línia a part, i la signatura, en versaletes, tanca la carta contra el marge dret; la postdata de Frederic segueix la signatura en un cos més petit. A les pàgines senars, la capçalera dona la data de la carta.
Aquesta recepta respon a
- Com componc un epígraf, una dedicatòria, una signatura o una cita destacada amb una cometa gran?
- Com aconsegueixo una bona justificació i partició de mots en textos en castellà, francès o alemany?
- Com poso capçaleres: el títol del llibre a la pàgina esquerra, el del capítol a la dreta i el foli per fora?
La resposta curta
// 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.
Ingredients
- Funcions
- Atributs de títolAncoratge d'elements de dissenyEstils de paràgrafObertures dissenyadesTítols numeratsCapítols que obren en pàgina senarEstils de títolCobertes, portades i colofonsImatges als dissenys de pàginaSalts de línia als títolsCapçaleres i folisVers línia a líniaMarges simètricsColor del paperPartició de mots i llengua del documentSuperíndexs i subíndexsMetadades del documentPaleta de color semànticaPàgines en un canvas
- També fa servir
- Capçaleres segons el tipus de pàginaFigures i taules com a recursosCapítols sense número
- Tipografia
- Crimson Pro, IM Fell French Canon, IM Fell DW Pica SC (SIL OFL 1.1)
- Recursos
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)
Elaboració
#1 · La data surt del títol
El codi és la resposta curta de més amunt. Cada carta és un títol de nivell 1 amb atributs que guarden el lloc i la data, i l'encapçalament els imprimeix com a {attr.place}, le {attr.date}. (atributs d'encapçalament). La caixa de la data arriba fins al límit dret de la columna (width: 'fill') i align: 'right' alinea el text amb aquest límit; sense aquest paràmetre, el text d'un disseny surt centrat. La salutació, la signatura i la postdata són estils de paràgraf que s'apliquen amb :::paragraphs{style="…"}. La signatura fa servir IM Fell DW Pica SC, una família amb les minúscules dibuixades com a versaletes. Amb inlineMarks: true, la data llegeix les marques del seu atribut, així que date="1^er^ avril 1778" apuja la terminació de l'ordinal.
#2 · Cartes seguides
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 };
Amb breakBefore desactivat, cada carta comença dues línies de la retícula (marginTop) per sota d'aquella en què acaba l'anterior. A la pàgina 4, la postdata, amb 12,6 pt d'interlineat, acaba entre dues línies de la retícula, i sobre la carta III queden unes tres línies en blanc. A la pàgina 2, la carta I arriba fins al peu i la II obre la pàgina 3. Amb el valor per defecte del nivell 1, cada carta començaria en pàgina senar (salt de pàgina previ). numberingTemplate: '{1:I}' numera les cartes de la I a la III, i l'encapçalament imprimeix el numeral amb {number}.
#3 · La data de la carta a la capçalera senar
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),
] };
En una capçalera, {attr.date} pren l'atribut de l'últim títol de nivell 1 que comença en aquella pàgina o abans. La pàgina 3 porta 12 juin 1740, i la 5, on continua la carta de Voltaire començada a la 4, porta 1er avril 1778 amb la terminació volada (elements de text). Les capçaleres van 12 mm per sota del límit superior de la pàgina, amb el foli al marge exterior i el text 8 mm més endins. pages: 'body' les treu de la coberta, que compta com a pàgina d'obertura perquè el seu títol abasta l'amplada de la pàgina. La data va en la mateixa cursiva de Crimson Pro que la de la carta, i els noms de la pàgina parella, en les versaletes dels números de carta.
#4 · Fes de la coberta un títol
// 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) },
] } } };
La coberta és el primer títol, amb l'estil d'encapçalament cover: un element d'imatge ancorat a la sang porta l'enquadernació dibuixada, un altre col·loca la fotografia a 72 mm del límit superior, i el títol, els noms i el subtítol surten del mateix títol i del frontmatter. numbered: false la deixa fora del compte, de manera que la primera carta de Frederic és la I. La imatge de l'enquadernació omple la pàgina, i una obertura reserva lloc fins al seu element més baix, així que la coberta ocupa tota la pàgina 1 i la nota inicial comença a la 2 sense cap :::pagebreak.
#5 · Partició de mots en francès sense estrènyer els espais
// 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' parteix amb els patrons francesos (ou-vrage a la pàgina 2, représen-tation a la 4). La justificació, el tall de línies per paràgraf complet i les regles contra vídues, òrfenes i línies curtes vénen activats per defecte. minWordSpacing: 0.75 impedeix que un espai entre paraules baixi de tres quarts del de Crimson Pro; amb el 0,6 per defecte, la línia justificada més atapeïda de la pàgina 5 deixaria els espais en 0,70 d'aquesta amplada. Amb 14,4 pt d'interlineat hi caben 33 línies per pàgina, i el marge inferior és el que queda a sota: 20,4 mm.
#6 · Cada color, enllaçat a la paleta
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() enllaça cada color amb la seva entrada de la paleta, i l'enllaç val tant als estils de text com als elements de disseny: els encapçalaments de les cartes, les capçaleres i la coberta. La cursiva de la nota inicial i la del colofó fan servir el color de cursiva per defecte, enllaçat a main-color; com que aquesta entrada porta el color de la tinta, s'imprimeixen en tinta i no en el blau del motor, #295AA3.
La recepta completa
// ═══ 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 = 'es'; // @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),
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Posa també el lloc a la capçalera
Amb els mateixos atributs, la capçalera senar pot portar el lloc i la data, À 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),Errors freqüents
Error freqüent
Valors d'atribut: sense { ni }; cometes simples si porten "
Un valor d'atribut acaba a la clau de tancament, així que no pot contenir { ni }. Un valor que porti cometes dobles va entre cometes simples; el signe de dòlar no dona problemes. Atributs de títol →
- La pàgina senar pren la data de l'última carta que comença en ella o abans. Una pàgina que acaba una carta i obre la següent porta la data de la nova, igual que la capçalera d'un diccionari dona l'última entrada de la pàgina.
- Si a un títol li falta un atribut, no s'imprimeix res i no hi ha avís: una carta sense
place="…"té una data que comença per una coma. Revisa el títol de cada carta. - Les cartes conserven els ; : ? i ! de la transcripció, sense espai al davant. La tipografia francesa hi posa un espai fi irrompible (U+202F); si l'escrius, el signe es queda a la línia de la seva paraula.
- Crimson Pro no porta les lletres modificadores ᵉ (U+1D49) i ʳ (U+02B3), així que 1ᵉʳ escrit en Unicode sortiria en una altra font. Escriu
1^er^: la nota inicial, que és text de paràgraf, el compon en superíndex, i també la data i la capçalera senar, perquè els seus elements de text porteninlineMarks: true.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 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 · domini públic
- The headnote and the colophon · Ignacio Ferro · CC BY 4.0
- Imatges
- 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
- Fonts
- Crimson Pro (SIL OFL 1.1) · IM Fell French Canon (SIL OFL 1.1) · IM Fell DW Pica SC (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


