En poques paraules
Les últimes pàgines d'una tesi doctoral, del capítol final a l'índex. Postext crea l'índex a partir de paraules marcades en el text i hi posa els números de pàgina.
Què compondràs
Les set últimes pàgines d'una tesi doctoral sobre la lectura en pantalla i en paper, en format B5 i en blanc i negre. El capítol 6, l'apèndix A, el glossari, la bibliografia i l'índex analític obren sota la mateixa banda negra de 62 mm, amb el títol calat en blanc. El capítol porta el numeral a la banda; l'apèndix, la lletra; i les seccions finals, l'avanttítol BACK MATTER i una nota breu en cursiva. El capítol va a una columna justificada. El glossari i l'índex passen a dues columnes en bandera i la bibliografia torna a una, amb les línies de continuació de cada entrada sagnades. L'índex surt de marques en el text: el motor ordena els termes sota la seva lletra, cerca la pàgina de cada marca i agrupa les seguides en trams com 171–73. Els números en negreta remeten a les definicions del glossari.
Aquesta recepta respon a
- Com componc una bibliografia o un glossari (sagnat francès, cos més petit)?
- Com faig un índex analític els números de pàgina del qual canviïn sols quan el text es mou?
- Com evito que els títols, les negretes i les vinyetes surtin en blau?
- Com numero els títols (1, 1.1, 1.1.1) i dono a cada nivell un estil diferent?
- 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?
- Com forço un salt de pàgina o de columna, i faig que cada capítol comenci en pàgina senar?
La resposta curta
// '# Glossary {style="glossary"}' in the Markdown picks a style. Each style starts a page
// of either parity, the appendix a recto (a style that sets no break inherits its level's
// 'odd': gotcha style-inherits-break), stays out of the chapter count (numbered: false, so
// its band has no numeral) and brings its own running heads; the glossary and the index
// set their pages in two columns until the next '#'. The appendix counts, in letters: its
// template prints the level's counter as A, B… config() takes both lists below.
const twoColumns = { layoutType: 'double', gutterWidth: mm(6) };
const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
const headingStyles = () => [
backMatter('appendix', { numbered: true, numberingTemplate: '{1:A}', header: appendixHeads,
breakBefore: { enabled: true, parity: 'odd' }, advancedDesign: opener('Appendix') }),
backMatter('glossary', { layout: twoColumns }),
backMatter('references'),
backMatter('index', { layout: twoColumns }),
];
// One paragraph per entry, in :::paragraphs{style="…"}: the turnover lines hang, so the
// first word of every entry stands clear at the left. Ragged, as APA asks of references,
// with every word whole (hyphenation.ragged is off). The index has its own settings.
const entries = (id, size, lead, hang, extra) => ({ id, fontSize: pt(size),
lineHeight: pt(lead), textAlign: 'left', hangingIndent: em(hang), ...extra });
const paragraphStyles = () => [
entries('term', 9.3, 12.4, 1), // the glossary: a bold term, then its definition
entries('reference', 9.3, 12.4, 1.5, { spaceBetween: pt(2.4) }),
];
Ingredients
- Funcions
- Geometria per seccióBibliografies i glossarisCapítols sense númeroÍndex analíticCapçaleres per seccióEstils de títolTítols numeratsCapítols que obren en pàgina senarBanda de capítol d'amplada completaObertures dissenyadesAtributs de títolCapçaleres segons el tipus de pàginaEstils de paràgrafTipus de recurs propisCites que col·loquen les figuresTaules a partir de dadesEstil dels peusPaleta de color semànticaNegreta, cursiva i els seus colorsExportació a PDF
- També fa servir
- RequadresEquilibri de columnesFigura i Taula en la teva llenguaSortir de la retícula a propòsitFonts incrustades al PDF
- Tipografia
- Libertinus Serif, Libertinus Serif Display, Libertinus Sans (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un estil d'encapçalament per a cada part del final
El codi és la resposta curta de més amunt. # Glossary {style="glossary" note="…"} obre una secció que arriba fins al títol de nivell 1 següent, i les seves pàgines prenen la disposició, les capçaleres i l'obertura de l'estil (estils d'encapçalament), de manera que el glossari i l'índex passen a dues columnes i la bibliografia, amb un estil que no fixa disposició, torna a la columna única del document. numbered: false deixa aquests títols fora del recompte de capítols (sense aquesta opció, a la banda del glossari sortiria un 2), i cada estil declara el seu salt de pàgina, perquè el que no el declara hereta el 'odd' del capítol i deixa pàgines parelles en blanc. Les entrades del glossari i de la bibliografia són paràgrafs d'un bloc :::paragraphs{style="…"} en cos 9,3 sobre 12,4 pt, enfront de l'11 sobre 14,6 del text, amb les línies de continuació sagnades 1 em al glossari i 1,5 em a la bibliografia (estils de paràgraf).
#2 · Una sola banda per a totes les obertures
const SINK = 8; // lines reserved, 41.2 mm: 3.2 mm more than the band, and text on the grid
// Design text sets each baseline 0.8 of its line under the line's top, and a line is 1.2 × the
// size unless lineHeight says otherwise. In mm, a line's part above its baseline and below it:
const PT = 25.4 / 72;
const above = (size, lineHeight = 1.2) => 0.8 * size * lineHeight * PT;
const below = (size, lineHeight = 1.2) => 0.2 * size * lineHeight * PT;
const KICKER = 4.3, TITLE = BAND - TOP - 9.5; // mm under the text block's top: two baselines
// A bottom-aligned box that ends below() under a baseline sets its last line on it. The
// numeral's line is 0.72 of its size, so the line fits inside its box.
const text = (id, content, family, size, lineHeight, baseline, edge, w, extra) => ({
kind: 'text', id, content, fontFamily: family, fontSize: pt(size), lineHeight,
color: col('paper'), overflow: 'wrap', align: edge.endsWith('right') ? 'right' : 'left',
verticalAlign: 'bottom', ...extra, placement: { anchor: { to: 'container', edge },
size: { width: mm(w), height: mm(baseline + below(size, lineHeight)) } } });
// The mark is '{number}': the chapter's 6, the appendix's A, nothing on an unnumbered heading.
const opener = (label) => ({ enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') }, placement: {
anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(BAND) } } },
text('label', label, LABEL, 8, 1.2, KICKER, 'top-left', 80,
{ fontWeight: 700, letterSpacing: pt(1.6), textTransform: 'uppercase' }),
text('title', '{titleText}', DISPLAY, 34, 1.04, TITLE, 'top-left', 84),
text('mark', '{number}', DISPLAY, 118, 0.72, TITLE, 'top-right', 34),
text('note', '{attr.note}', TEXT, 8.6, 1.3, TITLE, 'top-right', 44, { italic: true }),
] } });
La marca és {number}: un 6 al capítol, una A a l'apèndix i res en un títol sense numerar. El mateix disseny serveix per a tots tres, i les seccions finals imprimeixen el seu {attr.note} on aniria el numeral. minHeight reserva vuit línies de 14,6 pt, 41,2 mm des del capdamunt de la caixa de text, que deixen 3,2 mm lliures sota la banda i mantenen el text a la seva retícula. En els textos de disseny, la línia de base cau a 0,8 de l'alçada de línia, de manera que una caixa alineada a baix, amb el peu a below() d'una línia de base, hi assenta la seva última línia. Així, el títol, el numeral de 118 pt i l'última línia de la nota es recolzen a la línia de base del títol, a 52,5 mm del tall. La línia del numeral fa 0,72 vegades el seu cos, i així cap a la seva caixa.
#3 · La lletra de l'apèndix surt del seu estil
// The style's '{1:A}' (see answer) prints the level's counter as a letter, and startAt=1 on the
// first appendix restarts it after chapter 6. The band and the running head read that letter.
// A resource template's {h1} is a number unless it names a style: '{h1:A}.{n}' counts the
// tables A.1, A.2… and B.1 in a second appendix, with one type for all of them.
const appendixHeads = heads('Appendix {chapterNumber}. {chapterTitle}');
const appendixTables = { ...defaultResourceTypes(LANG).find((type) => type.id === 'table'),
id: 'table-a', numberingTemplate: '{h1:A}.{n}', resetOn: 'h1' }; // a copy of 'table'
L'estil de l'apèndix porta numberingTemplate: '{1:A}', que imprimeix el comptador del nivell com a lletra, i # Interview guide {style="appendix" startAt=1} reinicia aquest comptador, així que el primer apèndix és l'A i no el G (estils d'encapçalament). La banda llegeix la lletra amb {number} i la capçalera amb {chapterNumber}. El {h1} d'un tipus de recurs imprimeix el comptador com a número llevat que indiqui un estil, i per això les taules de l'apèndix porten un tipus amb la plantilla '{h1:A}.{n}': A.1, A.2, etc., i B.1 en un segon apèndix; amb el tipus per defecte, la taula seria l'1.1. Els títols del capítol es numeren amb les plantilles de cada nivell: '{1}.{2}' imprimeix 6.1, i continuation.headings.h1: 5 fa d'aquest el sisè capítol.
#4 · Les capçaleres, cap al marge exterior
const HEAD = 17.5, GAP = 9; // mm: the heads' baseline under the trim; the folio to the words
// Each text is placed by its top, above() over HEAD: the folio and the capitals share a baseline.
const head = (id, content, parity, edge, x, size = 7.5, extra) => ({ kind: 'text', id, content,
parity, pages: 'body', fontFamily: LABEL, fontSize: pt(size), fontWeight: 700,
letterSpacing: pt(1.3), textTransform: 'uppercase', color: col('ink'), ...extra, placement: {
anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(HEAD - above(size)) } } });
const folio = { fontFamily: TEXT, fontWeight: 400, letterSpacing: pt(0) };
const heads = (recto) => ({ elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, 9.5, folio),
head('verso', '{title}', 'even', 'top-left', OUTER + GAP),
head('recto', recto, 'odd', 'top-right', -(OUTER + GAP)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, 9.5, folio),
// The header's container spans the text block, so one rule serves both pages.
{ kind: 'rule', id: 'hairline', pages: 'body', direction: 'horizontal', thickness: pt(0.5),
color: col('rule'), placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { y: mm(HEAD + 2) }, size: { width: 'fill' } } },
] });
const chapterHeads = heads('Chapter {chapterNumber}. {chapterTitle}');
const sectionHeads = heads('{chapterTitle}'); // 'Glossary', 'References', 'Index'
// Openers drop the folio to the foot, centred under the text block, its baseline 12 mm below.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
pages: 'opener', ...folio, fontSize: pt(9.5), color: col('ink'), align: 'center',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(12 - above(9.5)) } } }] };
Els quatre textos s'ancoren a la pàgina i es filtren per parity, cosa que manté el foli a la vora exterior de les dues pàgines; cadascun es col·loca per la vora superior, a above() per sobre d'una línia de base situada a 17,5 mm del tall, així que el foli de 9,5 pt i les majúscules de 7,5 pt queden a la mateixa línia. La parella porta el títol de la tesi ({title}, del frontmatter) i la senar el de la secció ({chapterTitle}), com INDEX a la pàgina 177. pages: 'body' les deixa fora de les obertures, on el foli passa al peu. La senar del capítol diria Chapter 6. Conclusion i la de l'apèndix Appendix A. Interview guide, però en aquesta mostra només l'índex continua en una pàgina senar després de la seva obertura.
#5 · Marca els termes on el text en parla
// Glossary definitions carry 'main' (bold numbers); runs of pages join as 171–72 (Chicago).
// The heads stand on the entries' 11.6 pt pitch, 7.5 pt of space above them: 19 pt from the
// last entry of a letter to the next letter's baseline, 11.6 pt from a letter to its first entry.
const index = { fontFamily: TEXT, fontSize: pt(9), lineHeight: pt(11.6), color: col('ink'),
indent: em(1), turnoverIndent: em(2), rangeFormat: 'chicago',
groups: { fontFamily: DISPLAY, fontSize: pt(13), fontWeight: 400, color: col('ink'),
marginTop: pt(7.5) } };
:index[tablet] imprimeix la paraula i la registra tal com és; Rayner:index{term="Rayner, Keith"} no imprimeix res i registra la pàgina de Rayner sota el nom complet; term="interviews!timing of" crea una subentrada. Els termes del glossari porten main, així que la seva pàgina surt en negreta, com avisa la nota de la banda de l'índex. :::index, sota # Index {style="index"}, imprimeix les entrades a les dues columnes de l'estil, i buildDocument torna a compondre el document fins que els números de pàgina deixen de moure's. Les entrades van en cos 9 sobre 11,6 pt, amb les línies de continuació sagnades 2 em i les subentrades 1 em; les lletres, en 13 pt amb la font dels titulars. Les marques no funcionen a les cel·les de taula, així que les files de la taula 6.1 no hi afegeixen pàgines: look-backs remet al paràgraf que les comenta, no a la taula.
#6 · Tots els valors per defecte, en negre
const palette = { ink: '#000000', band: '#000000', rule: '#000000', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Bold, italic and list markers default to 'main-color': pointed at the ink, they print black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
La negreta, la cursiva, els pics i els números de les llistes i les referències segueixen per defecte l'entrada main-color de la paleta, així que, si li dones el color de la tinta, surten en negre i no en blau (paleta de colors). referenceBold: false posa Table 6.1 en rodona, com les cites autor-any que l'envolten.
La recepta completa
// ═══ Postext Cookbook · Nº 031 · Thesis back matter: appendix, glossary and index ═══
// https://postext.dev/en/cookbook/thesis-back-matter
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Libertinus Serif, Serif Display and Sans (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import {
buildDocumentWithFonts, renderPageToCanvas, defaultResourceTypes,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en')
const RECIPE = 'thesis-back-matter';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one ink; every colour is black or white, each under its own name
const palette = { ink: '#000000', band: '#000000', rule: '#000000', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// Bold, italic and list markers default to 'main-color': pointed at the ink, they print black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Libertinus Serif', DISPLAY = 'Libertinus Serif Display', LABEL = 'Libertinus Sans';
const TOP = 24, INNER = 25, OUTER = 31; // mm: a 120 mm measure, about 70 characters at 11 pt
const LEAD = 14.6; // pt: the body's leading, the grid every page is set on
const BAND = 62; // mm from the trim's top: the black band at the head of every opener
// #region answer: back matter as unnumbered heading styles, entries in hanging indents
// '# Glossary {style="glossary"}' in the Markdown picks a style. Each style starts a page
// of either parity, the appendix a recto (a style that sets no break inherits its level's
// 'odd': gotcha style-inherits-break), stays out of the chapter count (numbered: false, so
// its band has no numeral) and brings its own running heads; the glossary and the index
// set their pages in two columns until the next '#'. The appendix counts, in letters: its
// template prints the level's counter as A, B… config() takes both lists below.
const twoColumns = { layoutType: 'double', gutterWidth: mm(6) };
const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
const headingStyles = () => [
backMatter('appendix', { numbered: true, numberingTemplate: '{1:A}', header: appendixHeads,
breakBefore: { enabled: true, parity: 'odd' }, advancedDesign: opener('Appendix') }),
backMatter('glossary', { layout: twoColumns }),
backMatter('references'),
backMatter('index', { layout: twoColumns }),
];
// One paragraph per entry, in :::paragraphs{style="…"}: the turnover lines hang, so the
// first word of every entry stands clear at the left. Ragged, as APA asks of references,
// with every word whole (hyphenation.ragged is off). The index has its own settings.
const entries = (id, size, lead, hang, extra) => ({ id, fontSize: pt(size),
lineHeight: pt(lead), textAlign: 'left', hangingIndent: em(hang), ...extra });
const paragraphStyles = () => [
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
#Obre cada secció en pàgina senar
Les tesis que s'enquadernen per a una biblioteca solen obrir cada secció en pàgina senar. El glossari, la bibliografia i l'índex passen llavors a les pàgines 175, 177 i 179, cadascuna després d'una parella en blanc, i els números en negreta de l'índex apunten a la 175.
-const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
- parity: 'any' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });
+const backMatter = (id, extra) => ({ id, numbered: false, breakBefore: { enabled: true,
+ parity: 'odd' }, advancedDesign: opener('Back matter'), header: sectionHeads, ...extra });#Compon també el principi de la tesi
Els preliminars, numerats en romans abans de la pàgina 1, són a Preliminars amb folis romans i després la pàgina 1.
Errors freqüents
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
Error freqüent
La pàgina 1 és senar: planifica amb números físics
La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Libertinus Serif (SIL OFL 1.1) · Libertinus Serif Display (SIL OFL 1.1) · Libertinus Sans (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)


