> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/it/domande-e-risposte/58-i-have-a-custom-font-i-d-like-to-load-to-my-document.-how-can-i-do-this.md).

# Ho un font personalizzato che vorrei caricare nel mio documento. Come posso farlo?

## Introduzione

Questo articolo mostra come installare font personalizzati per comporre il testo del tuo documento—non tratta i font per la composizione della matematica. Per “font personalizzato” intendiamo un font non disponibile sui server di Overleaf, inclusi i font commerciali che richiedono una licenza o i font gratuiti non distribuiti con TeX Live o inclusi nella nostra installazione Linux.

* **Nota**: Questo articolo tratta le tecnologie dei font più diffuse, ma non discute soluzioni specialistiche basate su TeX come [Metafont](https://en.wikipedia.org/wiki/Metafont) e [font virtuali](https://texfaq.org/FAQ-virtualfonts).

## Da dove comincio?

Le soluzioni di composizione tipografica basate su LaTeX operano in un contesto di legacy. Nel corso di oltre quattro decenni, lo sviluppo dei compilatori LaTeX e dei formati dei font ha prodotto un ecosistema che combina tecnologie più vecchie e nuove. Di conseguenza, il processo effettivo di installazione e configurazione di font personalizzati per l'uso con LaTeX dipende da questi due fattori:

1. Il tipo (formato) di qualunque font che vuoi installare:

* obsoleti [PostScript Type 1](https://en.wikipedia.org/wiki/PostScript_fonts#Type_1) o [TrueType](https://en.wikipedia.org/wiki/TrueType) font, oppure
* moderni [OpenType](https://en.wikipedia.org/wiki/OpenType) font.

3. Quale compilatore LaTeX viene usato per compilare i tuoi progetti Overleaf:
   * pdfLaTeX, oppure
   * XeLaTeX o LuaLaTeX

Vai alla sezione che copre il compilatore che preferisci:

* [Uso di font personalizzati con pdfLaTeX](#using-custom-fonts-with-pdflatex)
* [Uso di font personalizzati con XeLaTeX e LuaLaTeX](#using-custom-fonts-with-xelatex-and-lualatex)

## Uso di font personalizzati con pdfLaTeX

Ecco un riassunto di ciò che dovrai fare—a seconda della complessità della configurazione del tuo font personalizzato:

1. Per ogni file di font (`.ttf`, `.otf` o `.pfb`), dovrai avere (o generare!) una metrica di font TeX adatta (`.tfm`) e, forse, un file di codifica (`.enc`).
2. pdfLaTeX deve sapere come incorporare i font del documento nel file PDF finale. Per farlo, legge un file di mappa dei font (`pdftex.map`), che dovrai aggiornare con i dettagli del tuo font personalizzato. Su Overleaf, lo fai usando uno di questi comandi:

* `\pdfmapfile{...}`
* `\pdfmapline{...}`

4. Ti servirà un file di descrizione del font (`.fd`che indica a LaTeX come usare i nuovi file di font.

Questi sono i principali tipi di file di cui avrai bisogno:

* **`.tfm`** (Metrica dei font TeX): questi file binari compatti non contengono alcun dato che descriva l'aspetto visivo delle forme dei caratteri, solo le dimensioni dei caratteri e i “metadati” del font che i motori TeX possono usare per svolgere le loro attività fondamentali di composizione tipografica. Le metriche dei font TeX per i font matematici contengono dati aggiuntivi non richiesti dai font solo testo; in particolare, hanno diversi parametri di “spaziatura” usati per la composizione matematica.
* **`.fd`** (Descrizione del font): questi file contengono i comandi LaTeX necessari per configurare e preparare il tuo font per l'uso con LaTeX. I comandi consentiti all'interno di `.fd` file, e la `.fd` convenzione di denominazione dei file è descritta nel documento [Selezione dei font di LaTeX2ε](https://texdoc.org/serve/fntguide/1).
* **`.map`** (Mappa dei font): i file di mappa collegano il nome dei file di metriche dei font TeX con il file fisico del font contenente i dati necessari per disegnare le forme dei caratteri (glifi). Ogni font noto a pdfTeX è descritto su una singola riga del file di mappa, usando una sintassi ben definita. Per tutti i dettagli, vedi la Sezione 5 di [Il manuale utente di pdfTeX](http://mirrors.ctan.org/systems/doc/pdftex/manual/pdftex-a.pdf).
* **`.enc`** (Codifica): se richiesto, questo tipo di file definisce la mappatura tra i codici dei caratteri nel tuo testo LaTeX e le corrispondenti forme dei caratteri (glifi) contenute nel file del font.

### Esempio di font TrueType personalizzato

La Galleria Overleaf contiene un progetto che [mostra l'installazione di un font TrueType personalizzato](https://www.overleaf.com/latex/examples/example-using-a-custom-truetype-font/yndxyzgbhpjv)—un font PostScript Type 1 utilizzerebbe una configurazione simile. Compila con pdfLaTeX, XeLaTeX e LuaLaTeX e produce il seguente output:

![Immagine che mostra la composizione tipografica di Overleaf con un font personalizzato](/files/9b6207f90232f58cd4767c3e6e5acb0a11808e01)

#### Note sul progetto di esempio

* Utilizza il seguente `\pdfmapline` comando:

```latex
\pdfmapline{+delphine < Delphine.ttf <T1-WGL4.enc}
```

che collega un file di metrica del font TeX chiamato `delphine` al file fisico del font chiamato `Delphine.ttf`.

* Il primo `<` carattere indica a pdfTeX di eseguire il subset del font TrueType; cioè, *parzialmente* incorporare questo font nel file PDF finale. Creare il subset di un font produce file PDF più piccoli perché contengono solo i dati delle forme dei caratteri necessari a visualizzare i caratteri presenti nel documento.
* Il secondo `<` carattere precede il nome di un file di vettore di codifica, `T1-WGL4.enc`, usato per mappare i codici dei caratteri nel tuo testo ai dati delle forme dei caratteri (glifi) all'interno del file del font—i dati delle forme dei caratteri sono necessari per renderizzare (disegnare) il carattere.
* LuaLaTeX richiede un passaggio di configurazione aggiuntivo perché `\pdfmapline` genera un **Sequenza di controllo non definita** errore dovuto ai cambiamenti nella gestione di alcuni comandi di backend da parte di LuaTeX—la Sezione 3 del [Manuale di riferimento di LuaTeX](http://mirrors.ctan.org/systems/doc/luatex/luatex.pdf). Il `\ifLuaTeX` comando, fornito da `iftex` pacchetto, viene usata per verificare la presenza di LuaTeX; se rilevato, `\pdfmapline` viene definito:

```latex
\ifLuaTeX
\protected\def\pdfmapline {\pdfextension mapline }
\fi
```

### Uso di più font o di font commerciali

Per gestire i file forniti da fornitori di font commerciali e raccolte di font gratuiti, puoi creare cartelle nel tuo progetto Overleaf per organizzare i file dei font in base al loro tipo (`.tfm`, `.pfb`, `.ttf` ecc.). Un buon modello per nominare e organizzare le cartelle è la [TeX Directory Structure (TDS)](https://www.tug.org/tds/tds.pdf), progettata come un “modello” di best practice per gestire una raccolta di file correlati a TeX.

Con le cartelle del progetto in atto, devi poi creare un cosiddetto [`latexmcrc` file modificabile](/latex/it/articoli-approfonditi/28-how-to-use-latexmkrc-with-overleaf.md) contenente istruzioni che dicono al compilatore LaTeX di cercare i file in quelle cartelle. Per impostazione predefinita, i compilatori non sanno che quelle cartelle esistono e non troveranno i file che contengono.

#### Esempio di progetto Overleaf

L'esempio della Galleria Overleaf [Uso delle cartelle per gestire i file di font personalizzati](https://www.overleaf.com/latex/templates/example-using-folders-to-manage-custom-font-files/qvqgnpjxvqzd) usa cartelle e un `latexmkrc` file per installare un font TrueType personalizzato. Contiene una struttura di cartelle mostrata in questa immagine:

![Organizzare le cartelle del progetto su Overleaf](/files/38ca31e900165241e6ee734cc86a007a67082cb4)

e un `latexmkrc` file contenente le seguenti righe, che impostano a runtime [le variabili d'ambiente](https://en.wikipedia.org/wiki/Environment_variable) dicendo al compilatore LaTeX di cercare i file nelle cartelle del nostro progetto:

```perl
$ENV{'TEXINPUTS'}='myfonts/tex//:' . $ENV{'TEXINPUTS'};
$ENV{'T1FONTS'}='myfonts/fonts/type1//:' . $ENV{'T1FONTS'};
$ENV{'AFMFONTS'}='myfonts/fonts/afm//:' . $ENV{'AFMFONTS'};
$ENV{'TEXFONTMAPS'}='myfonts/fonts/map//:' . $ENV{'TEXFONTMAPS'};
$ENV{'TFMFONTS'}='myfonts/fonts/tfm//:' . $ENV{'TFMFONTS'};
$ENV{'TTFONTS'}='myfonts/fonts/ttf//:' . $ENV{'TTFONTS'};
$ENV{'VFFONTS'}='myfonts/fonts/vf//:' . $ENV{'VFFONTS'};
$ENV{'ENCFONTS'}='myfonts/fonts/enc//:' . $ENV{'ENCFONTS'};
```

Se ti stai chiedendo quali file di solito vanno in quale cartella, dai un'occhiata a [questo articolo](/latex/it/articoli-approfonditi/06-an-introduction-to-kpathsea-and-how-tex-engines-search-for-files.md#table-listing-kpathsea-config-variables).

## Uso di font personalizzati con XeLaTeX e LuaLaTeX

### Uso dei font PostScript Type 1

Per usare font legacy PostScript Type 1 con XeLaTeX e LuaLaTeX, puoi seguire le [linee guida per pdfLaTeX](#using-custom-fonts-with-pdflatex), quindi non ripeteremo qui quei dettagli.

### Uso dei font OpenType

XeLaTeX e LuaLaTeX offrono un ampio supporto per la composizione avanzata usando font OpenType—nelle varianti TrueType e PostScript—perché i loro motori TeX sottostanti, XeTeX e LuaHBTeX, hanno capacità native (integrate) di elaborare le tecnologie dei font OpenType, cosa che pdfTeX non ha.

* **Nota**: LuaLaTeX, tramite il suo motore TeX sottostante (LuaHBTeX), ha le capacità di gestione dei font più sofisticate di tutti i motori TeX; tuttavia, discuterne è oltre lo scopo di questo articolo—per maggiori informazioni, vedi le sezioni 6 e 12 del [Manuale di riferimento di LuaTeX](https://ctan.org/pkg/luatex?lang=en).

Per usare i font OpenType con XeLaTeX e LuaLaTeX, devi caricare [`fontspec`](https://ctan.org/pkg/fontspec?lang=en), un pacchetto potente e ricco di funzionalità che fornisce un'interfaccia alle capacità avanzate di composizione tipografica dei font OpenType.

* **Nota**: Non è necessario usare `\usepackage[T1]{fontenc}` (oppure `\usepackage[utf8]{inputenc}`) quando si usano font OpenType con XeLaTeX o LuaLaTeX.

### Esempio: introduzione a fontspec

Il processo è semplice perché non è richiesta alcuna installazione di font—non c'è bisogno di `.tfm`, `enc` o `.map` file e scrivere definizioni di font (`.fd`) è relegato alla storia! È semplice come questo:

1. Aggiungi la seguente riga al preambolo del tuo documento:

```latex
\usepackage{fontspec}
```

3. Seleziona l'icona di caricamento file (![UploadIcon.png](/files/25d4ebb2ee8d954b79fe7a30c1a13728d7437a5b)), situata sopra l'elenco dei file.
4. Trascina e rilascia i font nel pannello di caricamento, oppure selezionali dal tuo computer, per aggiungere i font al tuo progetto Overleaf.
5. Usa uno dei `fontspec` pacchetto `\set*xxx*font` comandi per configurare e attivare i font.

L'eccellente `fontspec` documentazione del pacchetto fornisce una grande quantità di esempi che puoi esplorare, quindi qui manterremo le cose semplici per aiutarti a iniziare. Per esempio, supponi di caricare un file di font chiamato `CrimsonText-Regular.ttf`; dopo aver caricato `fontspec` puoi impostare il font principale del testo del documento scrivendo

```latex
\setmainfont{CrimsonText-Regular.ttf}
```

Puoi anche scrivere sintassi come

```latex
\setmainfont{CrimsonText}[
Extension = .ttf,
UprightFont = *-Regular,
...]
```

Puoi anche dichiarare una nuova famiglia di font da usare in situazioni arbitrarie:

```latex
\newfontfamily{\crimson}{CrimsonText}
[Extension = .ttf, UprightFont = *-Regular, ...]
{\crimson Questo testo usa il font CrimsonText}
```

#### Risorse

* La [`fontspec` documentazione del pacchetto](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) è una lettura indispensabile—non solo fornisce numerosi esempi utili, ma contiene anche molte informazioni di contesto utili sui font OpenType.
* La pagina di aiuto di Overleaf su [XeLaTeX](/latex/it/caratteri/03-xelatex.md) contiene un [esempio dettagliato](/latex/it/caratteri/03-xelatex.md#using-fonts-not-installed-on-overleaf27s-servers-google-fonts-example) che mostra come scaricare font OpenType da Google e configurarli con `fontspec`.

**Progetti di esempio**

La Galleria Overleaf ha progetti di esempio che dimostrano l'uso dei font OpenType con XeLaTeX o LuaLaTeX—puoi aprirli e passare il compilatore da LuaLaTeX a XeLaTeX:

* [Uso dei font Google con XeLaTeX](https://www.overleaf.com/latex/templates/using-google-fonts-with-xelatex/xxkpcgfttjvd)
* [Uso dei font OpenType STIX2 con LuaLaTeX o XeLaTeX](https://www.overleaf.com/latex/templates/using-the-stix2-opentype-fonts-with-lualatex-or-xelatex/hdfvhzqmhnpx)

Il grafico seguente combina l'output prodotto da questi progetti:

![Progetti di esempio Overleaf che usano font OpenType](/files/2bbc99e6f7cd08552b4851e8e931f4cead1a886b)

## Basi dei font e del compilatore LaTeX

### Estensioni dei file dei font

La tabella seguente elenca le estensioni di file usate per indicare diversi tipi (formati) di file di font:

|                                                                                                                |                 |
| -------------------------------------------------------------------------------------------------------------- | --------------- |
| **Tipo di font**                                                                                               | **Estensione**  |
| [PostScript Type 1](https://en.wikipedia.org/wiki/PostScript_fonts#Type_1)$$\displaystyle{}^{\mathbf\*}$$      | `.pfb`          |
| [TrueType](https://en.wikipedia.org/wiki/TrueType)                                                             | `.ttf`          |
| [Raccolte TrueType](https://learn.microsoft.com/en-us/typography/opentype/otspec150/otff#truetype-collections) | `.ttc`          |
| [OpenType](https://learn.microsoft.com/en-us/typography/opentype/)                                             | `.otf` o `.ttf` |

$$\displaystyle{}^{\mathbf\*}$$ Nel gennaio 2023, tutte le applicazioni di authoring di Adobe [hanno cessato il supporto del formato di font legacy Type 1](https://helpx.adobe.com/uk/fonts/kb/postscript-type-1-fonts-end-of-support.html).

I font OpenType esistono in due “varianti”, spesso chiamate “flavour”: PostScript-flavour e TrueType-flavour, nomi che riflettono i dati e il meccanismo/i usati per rappresentare le forme dei caratteri (glifi) che contengono. Ecco perché i font OpenType hanno due estensioni di file: `.otf` o `.ttf` che, per *convenzione*, implicano:

* `*filename*.otf` è un font OpenType in flavour PostScript
* `*filename*.ttf` è un font OpenType in flavour TrueType

Per esempio, pdfTeX presume che l'estensione `.otf` indichi un font OpenType in flavour PostScript.

* **Nota**: il ruolo del file `.ttc` L'estensione viene usata solo per le raccolte di font TrueType.

### Informazioni sull'estensione di file .ttf

Dato un file di font con un' `.ttf` estensione, potrebbe essere:

* un font TrueType più vecchio (non OpenType), oppure
* un font OpenType che contiene dati TrueType più le funzionalità extra fornite da OpenType.

Determinare se un dato `.ttf` file di font è OpenType o TrueType puro può essere difficile, e richiede alle applicazioni di ispezionare/esaminare le strutture dati interne del font. Per ulteriori dettagli, vedi [questa discussione (thread)](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format) oppure questo [articolo Microsoft](https://learn.microsoft.com/en-us/typography/opentype/#why-is-my-opentype-font-listed-as-a-truetype-font-by-my-application).

### Formati dei font e compilatori LaTeX

La tabella seguente riassume i formati di font (mainstream) supportati da tre compilatori LaTeX (più precisamente, supportati dai motori TeX sottostanti):

|                 |                         |                                                           |                                                        |                                             |
| --------------- | ----------------------- | --------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------- |
| **Compilatore** | **PostScript (Type 1)** | **TrueType (semplice**$$\displaystyle{}^{\mathbf†}$$**)** | **OpenType (TrueType)**$$\displaystyle{}^{\mathbf\*}$$ | **OpenType (PostScript)**                   |
| pdfLaTeX        | Sì                      | Sì                                                        | Limitato$$\displaystyle{}^{\mathbf{\*\*}}$$            | Limitato$$\displaystyle{}^{\mathbf{\*\*}}$$ |
| XeLaTeX         | Sì                      | Sì                                                        | Sì                                                     | Sì                                          |
| LuaLaTeX        | Sì                      | Sì                                                        | Sì                                                     | Sì                                          |

$$\displaystyle{}^{\mathbf†}$$Con “semplice” intendiamo un font TrueType che non contiene i dati aggiuntivi (tabelle) definiti dalla specifica OpenType, e quindi non dispone delle funzionalità di composizione tipografica più avanzate dei font OpenType in flavour TrueType.

$$\displaystyle{}^{\mathbf\*}$$pdfTeX offre un supporto limitato per [Raccolte TrueType](https://learn.microsoft.com/en-us/typography/opentype/otspec150/otff#truetype-collections) (estensione `.ttc`)—leggerà solo i dati del primo font contenuto nella raccolta.

$$\displaystyle{}^{\mathbf{\*\*}}$$Il supporto OpenType “Limitato” di pdfTeX significa:

* non supporta le funzionalità avanzate di composizione tipografica contenute nei font OpenType;
* creerà il subset dei font OpenType in flavour TrueType, ma non dei font OpenType in flavour PostScript, che devono essere incorporati per intero. L'assenza del subset del font produce file PDF più grandi e comporta problemi di licenza con i font commerciali, che di solito vietano l'incorporamento completo;
* non può utilizzare più di 256 caratteri per font, mentre i singoli font OpenType ne supportano decine di migliaia;
* richiede la produzione di metriche dei font TeX e di altri file accessori (richiesti da LaTeX)—processi che esulano dallo scopo di questo articolo (vedi [Letture aggiuntive](#further-reading) per link a descrizioni di quei processi).

## Letture aggiuntive

* [Come funziona OpenType](https://simoncozens.github.io/fonts-and-layout/opentype.html) (di Simon Cozens).
* [Determina se un file di font è in formato OpenType o in formato TrueType](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format)—una discussione sulla difficoltà di determinare se un dato `.ttf` è TrueType puro o OpenType in flavour TrueType.
* [Uno sguardo più da vicino ai font TrueType e a pdfTeX](https://tug.org/TUGboat/tb30-1/tb94thanh.pdf)—un articolo di TUGboat scritto da [Hàn Thế Thành](https://tug.org/interviews/thanh.html), il creatore di [pdfTeX](https://www.tug.org/applications/pdftex/).
* [A Directory Structure for TeX Files](https://tug.org/tds/tds.html), una gerarchia standard di cartelle/directory per organizzare file correlati a TeX.
* [L'installazione e l'uso dei font OpenType in LaTeX](https://www.tug.org/TUGboat/tb27-2/tb87owens.pdf)—un articolo di TUGboat che spiega come preparare i font OpenType per l'uso con pdfLaTeX.
* [Come uso i font TrueType con PdfTeX usando otftotfm?](https://tex.stackexchange.com/questions/52819/how-do-i-use-truetype-fonts-with-pdftex-using-otftotfm/52902#52902)—un thread di tex.stackexchange contenente un esempio dettagliato.

### Una nota sulle “guerre dei font”...

Negli anni '80 e '90 si sono viste le cosiddette “guerre dei font”, in cui due formati di font concorrenti, PostScript Type 1 (di Adobe) e TrueType (creato da Apple, concesso in licenza a Microsoft), si sono battuti per la supremazia—per conquistare il cuore e la mente di tutti gli utenti, soprattutto designer e tipografi. Alla fine, il [formato di font OpenType](https://learn.microsoft.com/en-us/typography/opentype) è emerso (nel 1997) come soluzione ibrida, che comprende e estende le tecnologie dei font di Adobe e Apple. OpenType si basa sul formato di file TrueType originale per abilitare capacità avanzate di composizione tipografica e un supporto Unicode migliore tramite font contenenti oltre 65.000 forme di caratteri (glifi).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/it/domande-e-risposte/58-i-have-a-custom-font-i-d-like-to-load-to-my-document.-how-can-i-do-this.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
