Capitolo 3 · Parte II · Il mestiere

Configurazione di Postext

Che cos’è una configurazione di Postext e in quale delle nove pagine del riferimento è spiegato ogni gruppo di impostazioni

Aggiornato 2026-10-102 minenescadefritptzhjaar

In breve

Questa pagina apre il riferimento di tutte le impostazioni che decidono l’aspetto delle tue pagine. Un solo gruppo di impostazioni raccoglie tutte le scelte: formato della pagina, numero di colonne, font, corpo del testo, titoli, riquadri, colori e altro ancora. Scrivi solo le impostazioni che vuoi cambiare, perché ognuna parte da un valore ragionevole. Il riferimento è diviso in nove pagine. L’elenco di questa pagina rimanda a ogni sezione: vai direttamente alla parte che ti serve.

In Postext ogni decisione di impaginazione dipende da un unico oggetto di configurazione.

PostextConfig regola le dimensioni della pagina, la disposizione delle colonne, la tipografia del testo corrente, gli stili dei titoli, la lingua del documento (locale) e altro ancora. Ogni proprietà è facoltativa: Postext parte da valori predefiniti ragionevoli, ispirati alla tipografia tradizionale del libro. Devi indicare soltanto ciò che vuoi cambiare.

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt overrides the 8 pt default
  headings: { fontFamily: 'Open Sans' },
});

Per una panoramica di come il motore elabora questa configurazione, consulta la pagina Architettura.

#Indice

Il riferimento è diviso in nove pagine. Ogni gruppo qui sotto è una pagina, seguita dalle sezioni che contiene.

Pagina e impaginazione

Testo e titoli

Note e rimandi

  • Note a piè di pagina — footnotes: dove vanno le note citate con [^id], come sono numerate e che aspetto hanno.
  • Numeri di riga — lineNumbers: il numero di ogni quinta riga dei versi, o del testo, nel margine; che cosa si conta, dove il conteggio ricomincia, su quale lato stanno i numeri.
  • Rimandi — crossRefs: le parole stampate attorno al numero o alla pagina di un :ref, e il suo stile predefinito.
  • Citazioni — citations: lo stile citazionale e l’aspetto delle citazioni e della bibliografia.
  • Sommario — che cosa stampa :::toc: tipografia delle voci, linee guida, numeri di pagina, righe degli autori, righe delle parti.
  • Indice analitico — che cosa stampa :::index: tipografia delle voci, rientri, separatori e intervalli dei numeri di pagina, gruppi per lettera, lingua di ordinamento.

Tipografia dell’Asia orientale

  • Tipografia dell’Asia orientale — cjk: le convenzioni regionali e la divisione in righe del testo cinese, giapponese e coreano, come si distribuiscono le loro righe giustificate, larghezze e sporgenza della punteggiatura, lo spazio tra caratteri han e latini, la griglia dei caratteri, i numeri diritti nel testo verticale, e i segni, il ruby, le note warichu e i segni kanbun. Le guide a tutto questo sono Impaginazione cinese e Impaginazione giapponese.

Risorse e tabelle

Stili e parti

  • Stili di paragrafo — stili con nome per i contenitori :::paragraphs: bibliografie, glossari, note.
  • Stili dei chip — chipStyles: stili con nome per il :chip[…] in linea: la casella di una banca di parole, un tasto della tastiera, un’etichetta.
  • Listati di codice — codeStyle: il carattere, il riquadro, la larghezza della tabulazione, le righe lunghe, i numeri di riga e i colori dei token dei listati ```, la colorazione della sintassi e il suo hook per l’evidenziatore, e il codice in linea in un carattere monospaziato.
  • Stili dei riquadri — note, suggerimenti e obiettivi incorniciati per i contenitori :::callout.
  • Parti — pagine di parte per i contenitori :::part: parità, area del testo, progetto dell’apertura, tipografia del testo.
  • Stili dei titoli — stili con nome per i titoli {style="…"}: capitoli non numerati, pagine preliminari con le proprie testatine, geometria e tavolozza.

Impostazioni dei fumetti

  • Fumetti — comics: la cornice e gli spazi tra vignette delle pagine a fumetti, gli stili delle vignette, il lettering, gli stili delle nuvolette e il cast. La guida è Fumetti.

Font, colori e output

Uso programmatico