# Configurazione di Postext

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

- Versione HTML: https://postext.dev/it/docs/configuration
- Ultimo aggiornamento: 2026-10-10
- Tempo di lettura: 2 min
- Altre lingue: [en](https://postext.dev/en/docs/configuration.md), [es](https://postext.dev/es/docs/configuration.md), [ca](https://postext.dev/ca/docs/configuration.md), [de](https://postext.dev/de/docs/configuration.md), [fr](https://postext.dev/fr/docs/configuration.md), [pt](https://postext.dev/pt/docs/configuration.md), [zh](https://postext.dev/zh/docs/configuration.md), [ja](https://postext.dev/ja/docs/configuration.md), [ar](https://postext.dev/ar/docs/configuration.md)

## 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.

```ts
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](https://postext.dev/it/docs/architecture.md).

## Indice

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

**[Pagina e impaginazione](https://postext.dev/it/docs/configuration-page-layout.md)**

- [Pagina](https://postext.dev/it/docs/configuration-page-layout.md#pagina) — formato, margini, griglia della linea di base, segni di taglio, [rilegatura](https://postext.dev/it/docs/configuration-page-layout.md#rilegatura).
- [Impaginazione](https://postext.dev/it/docs/configuration-page-layout.md#impaginazione) — numero di colonne, intercolonne, filetti, [scrittura verticale](https://postext.dev/it/docs/configuration-page-layout.md#scrittura-verticale).
- [Intestazioni e piè di pagina](https://postext.dev/it/docs/configuration-page-layout.md#intestazioni-e-piè-di-pagina) — elementi di testo e filetti per pagina, con segnaposto, parità e allineamento.

**[Testo e titoli](https://postext.dev/it/docs/configuration-text.md)**

- [Testo corrente](https://postext.dev/it/docs/configuration-text.md#testo-corrente) — tipografia, sillabazione, tabulazioni, orfane e vedove.
- [Lingua del documento](https://postext.dev/it/docs/configuration-text.md#lingua-del-documento) — il `locale` di primo livello: la sillabazione di ripiego, i tipi di risorsa predefiniti e le diciture di continuazione delle tabelle e dei riquadri divisi, la lingua marcata in un PDF accessibile; le [cifre](https://postext.dev/it/docs/configuration-text.md#cifre-del-documento) (`numerals`) e la [direzione del testo](https://postext.dev/it/docs/configuration-text.md#direzione-del-testo) (`direction`) che ne derivano; e le [lingue e scritture](https://postext.dev/it/docs/configuration-text.md#lingue-e-scritture) che Postext compone. La guida ai libri da destra a sinistra è [Impaginazione araba](https://postext.dev/it/docs/arabic-layout.md).
- [Titoli](https://postext.dev/it/docs/configuration-text.md#titoli) — valori predefiniti comuni e sostituzioni per H1–H6.
- [Elenchi puntati](https://postext.dev/it/docs/configuration-text.md#elenchi-puntati) ed [Elenchi numerati](https://postext.dev/it/docs/configuration-text.md#elenchi-numerati) — punti elenco, numerazione, annidamento.
- [Matematica](https://postext.dev/it/docs/configuration-text.md#matematica) — rendering LaTeX, scala, colore, margini.

**[Note e rimandi](https://postext.dev/it/docs/configuration-notes-references.md)**

- [Note a piè di pagina](https://postext.dev/it/docs/configuration-notes-references.md#note-a-piè-di-pagina) — `footnotes`: dove vanno le note citate con `[^id]`, come sono numerate e che aspetto hanno.
- [Numeri di riga](https://postext.dev/it/docs/configuration-notes-references.md#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](https://postext.dev/it/docs/configuration-notes-references.md#rimandi) — `crossRefs`: le parole stampate attorno al numero o alla pagina di un `:ref`, e il suo stile predefinito.
- [Citazioni](https://postext.dev/it/docs/configuration-notes-references.md#citazioni) — `citations`: lo stile citazionale e l’aspetto delle citazioni e della bibliografia.
- [Sommario](https://postext.dev/it/docs/configuration-notes-references.md#indice-dei-contenuti) — che cosa stampa `:::toc`: tipografia delle voci, linee guida, numeri di pagina, righe degli autori, righe delle parti.
- [Indice analitico](https://postext.dev/it/docs/configuration-notes-references.md#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](https://postext.dev/it/docs/configuration-east-asian.md)**

- [Tipografia dell’Asia orientale](https://postext.dev/it/docs/configuration-east-asian.md#tipografia-dellasia-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](https://postext.dev/it/docs/chinese-layout.md) e [Impaginazione giapponese](https://postext.dev/it/docs/japanese-layout.md).

**[Risorse e tabelle](https://postext.dev/it/docs/configuration-resources.md)**

- [Tipi di risorsa](https://postext.dev/it/docs/configuration-resources.md#tipi-di-risorsa) — numerazione per tipo di figure, tabelle e tipi personalizzati.
- [Stile delle tabelle](https://postext.dev/it/docs/configuration-resources.md#stile-delle-tabelle) (con gli [stili di tabella con nome](https://postext.dev/it/docs/configuration-resources.md#stili-di-tabella-con-nome)) e [Stile delle didascalie](https://postext.dev/it/docs/configuration-resources.md#stile-delle-didascalie) — tipografia e decorazione delle risorse tabella e delle loro didascalie.
- [Stile dei diagrammi](https://postext.dev/it/docs/configuration-resources.md#stile-dei-diagrammi) — ricolorazione a inchiostro unico dei diagrammi SVG incorporati, per la stampa a tinta piatta.
- [Stile dei video](https://postext.dev/it/docs/configuration-resources.md#stile-dei-video) — `videoStyle`: il segno di riproduzione e il codice QR stampati sopra il fotogramma di copertina di un video, e ciò che offrono i suoi lettori nel visualizzatore HTML e in EPUB.

**[Stili e parti](https://postext.dev/it/docs/configuration-styles.md)**

- [Stili di paragrafo](https://postext.dev/it/docs/configuration-styles.md#stili-di-paragrafo) — stili con nome per i contenitori `:::paragraphs`: bibliografie, glossari, note.
- [Stili dei chip](https://postext.dev/it/docs/configuration-styles.md#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](https://postext.dev/it/docs/configuration-styles.md#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](https://postext.dev/it/docs/configuration-styles.md#stili-dei-riquadri) — note, suggerimenti e obiettivi incorniciati per i contenitori `:::callout`.
- [Parti](https://postext.dev/it/docs/configuration-styles.md#parti) — pagine di parte per i contenitori `:::part`: parità, area del testo, progetto dell’apertura, tipografia del testo.
- [Stili dei titoli](https://postext.dev/it/docs/configuration-styles.md#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](https://postext.dev/it/docs/configuration-comics.md)**

- [Fumetti](https://postext.dev/it/docs/configuration-comics.md#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](https://postext.dev/it/docs/comics.md).

**[Font, colori e output](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md)**

- [Unità e colori](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#unità-e-colori) + [Tavolozza dei colori](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#tavolozza-dei-colori) — `Dimension`, `ColorValue`, colori con nome.
- [Font personalizzati](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#font-personalizzati) — dichiara famiglie di font caricate dall’utente accanto ai Google Fonts.
- [Visualizzatore HTML](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#visualizzatore-html) — larghezza di colonna di riferimento e divisione in righe per il backend HTML.
- [Generazione del PDF (configurazione)](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#generazione-del-pdf-configurazione) — segnalibri, output accessibile (marcato), spazio colore forzato per il backend PDF.
- [Produzione di stampa (configurazione)](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#produzione-di-stampa-configurazione) — `print`: PDF/X-1a e PDF/X-4, i profili ICC di output, il nero (grigi solo K, sovrastampa, nero ricco), i colori definiti in CMYK, il preflight e l’anteprima di stampa.
- [Verifica del contrasto (configurazione)](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#verifica-del-contrasto-configurazione) — `contrast`: il testo contro il suo fondo al livello WCAG AA o AAA, a schermo e sulla carta del profilo di output, e il testo in negativo troppo sottile per la macchina da stampa.
- [Visualizzatore Folio (configurazione)](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#visualizzatore-folio-configurazione) — carta, rilegatura, superficie e luce del visualizzatore 3D del libro.
- [Debug](https://postext.dev/it/docs/configuration-fonts-colors-viewers.md#debug) — sovrapposizioni visive e avvisi di composizione per l’editor.

**[Uso programmatico](https://postext.dev/it/docs/configuration-programmatic-usage.md)**

- [Uso programmatico](https://postext.dev/it/docs/configuration-programmatic-usage.md#uso-programmatico) — `buildDocument`, gli avvisi che riporta, i resolver, le cache.
- [Impaginare in un Web Worker](https://postext.dev/it/docs/configuration-programmatic-usage.md#eseguire-limpaginazione-in-un-web-worker) — composizioni fuori dal thread principale, con annullamento.
- [Integrare il visualizzatore HTML](https://postext.dev/it/docs/configuration-programmatic-usage.md#integrare-il-visualizzatore-html) e [Generare PDF](https://postext.dev/it/docs/configuration-programmatic-usage.md#generare-pdf) — procedure complete dall’inizio alla fine.
- [Un libro in 3D (`postext-folio`)](https://postext.dev/it/docs/configuration-programmatic-usage.md#un-libro-in-3d-postext-folio) — il documento impaginato come un libro stampato aperto su una scrivania, con fogli che il lettore sfoglia.
- [Libri EPUB](https://postext.dev/it/docs/configuration-programmatic-usage.md#libri-epub-postext-epub) — file EPUB 3 a layout fisso e a layout fluido dalla stessa impaginazione, e la loro verifica con EPUBCheck.
- [Pacchetti (file `.postext`)](https://postext.dev/it/docs/configuration-programmatic-usage.md#pacchetti-file-postext) — un libro intero in un solo file: creare, aprire e comporre archivi `.postext` dal codice.