> 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/fr/questions-et-reponses/58-i-have-a-custom-font-i-d-like-to-load-to-my-document.-how-can-i-do-this.md).

# J'ai une police personnalisée que j'aimerais charger dans mon document. Comment puis-je faire cela ?

## Introduction

Cet article montre comment installer des polices personnalisées pour la composition du texte de votre document — il ne traite pas des polices pour la composition des mathématiques. Par « police personnalisée », nous entendons une police non disponible sur les serveurs d’Overleaf, y compris les polices commerciales qui nécessitent une licence ou les polices gratuites non distribuées avec TeX Live ou incluses dans notre installation Linux.

* **Remarque**: Cet article traite des technologies de polices grand public, mais ne discute pas de solutions spécialisées basées sur TeX telles que [Metafont](https://en.wikipedia.org/wiki/Metafont) et [les polices virtuelles](https://texfaq.org/FAQ-virtualfonts).

## Par où commencer ?

Les solutions de composition basées sur LaTeX fonctionnent dans un contexte hérité. Sur plus de quatre décennies, le développement des compilateurs LaTeX et des formats de polices a produit un écosystème composé d’un mélange de technologies anciennes et nouvelles. En conséquence, le processus réel d’installation et de configuration de polices personnalisées pour une utilisation avec LaTeX dépend de ces deux facteurs :

1. Le type (format) de la ou des polices que vous souhaitez installer :

* héritées [PostScript Type 1](https://en.wikipedia.org/wiki/PostScript_fonts#Type_1) ou [TrueType](https://en.wikipedia.org/wiki/TrueType) de polices, ou
* modernes [OpenType](https://en.wikipedia.org/wiki/OpenType) de polices.

3. Quel compilateur LaTeX est utilisé pour compiler votre ou vos projets Overleaf :
   * pdfLaTeX, ou
   * XeLaTeX ou LuaLaTeX

Accédez à la section correspondant à votre compilateur préféré :

* [Utilisation de polices personnalisées avec pdfLaTeX](#using-custom-fonts-with-pdflatex)
* [Utilisation de polices personnalisées avec XeLaTeX et LuaLaTeX](#using-custom-fonts-with-xelatex-and-lualatex)

## Utilisation de polices personnalisées avec pdfLaTeX

Voici un résumé de ce que vous devrez faire — selon la complexité de votre configuration de police personnalisée :

1. Pour chaque fichier de police (`.ttf`, `.otf` ou `.pfb`), vous devrez disposer de (ou générer !) une métrique de police TeX appropriée (`.tfm`) et, éventuellement, d’un fichier d’encodage (`.enc`).
2. pdfLaTeX doit savoir comment incorporer les polices du document dans le fichier PDF final. Pour ce faire, il lit un fichier de carte de police (`pdftex.map`), que vous devrez mettre à jour avec les détails de votre police personnalisée. Sur Overleaf, vous le faites à l’aide de l’une de ces commandes :

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

4. Vous aurez besoin d’un fichier de description de police (`.fd`), qui indique à LaTeX comment utiliser les nouveaux fichiers de police.

Voici les principaux types de fichiers dont vous aurez besoin :

* **`.tfm`** (métrique de police TeX) : ces fichiers binaires compacts ne contiennent aucune donnée décrivant l’apparence visuelle des formes des caractères, seulement les dimensions des caractères et des « métadonnées » de police que les moteurs TeX peuvent utiliser pour effectuer leurs tâches principales de composition. Les métriques de police TeX pour les polices mathématiques contiennent des données supplémentaires non requises par les polices de texte seul ; en particulier, elles comportent plusieurs paramètres d’« espacement » utilisés pour la composition des mathématiques.
* **`.fd`** (description de police) : ces fichiers contiennent les commandes LaTeX nécessaires pour configurer et préparer votre police en vue d’une utilisation avec LaTeX. Les commandes autorisées dans les fichiers `.fd` et la `.fd` convention de nommage des fichiers sont décrites dans le document [LaTeX2ε font selection](https://texdoc.org/serve/fntguide/1).
* **`.map`** (carte de police) : les fichiers de carte relient le nom des fichiers de métrique de police TeX au fichier de police physique contenant les données nécessaires pour dessiner les formes des caractères (glyphes). Chaque police connue de pdfTeX est décrite sur une seule ligne du fichier de carte, à l’aide d’une syntaxe bien définie. Pour plus de détails, voir la section 5 de [Le manuel utilisateur de pdfTeX](http://mirrors.ctan.org/systems/doc/pdftex/manual/pdftex-a.pdf).
* **`.enc`** (encodage) : si nécessaire, ce type de fichier définit la correspondance entre les codes de caractères dans votre texte LaTeX et les formes de caractères correspondantes (glyphes) contenues dans le fichier de police.

### Exemple de police TrueType personnalisée

La Galerie Overleaf contient un projet qui [démontre l’installation d’une police TrueType personnalisée](https://www.overleaf.com/latex/examples/example-using-a-custom-truetype-font/yndxyzgbhpjv)— une police PostScript Type 1 utiliserait une configuration similaire. Il compile avec pdfLaTeX, XeLaTeX et LuaLaTeX et produit la sortie suivante :

![Image montrant une composition Overleaf utilisant une police personnalisée](/files/d86a4fb5a0c8d5c7d5cb260458c7aebcc1dbe2fa)

#### Remarques sur le projet d’exemple

* Il utilise la commande suivante `\pdfmapline` commande :

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

qui relie un fichier de métrique de police TeX appelé `delphine` au fichier de police physique appelé `Delphine.ttf`.

* Le premier `<` caractère indique à pdfTeX de sous-ensembler la police TrueType ; c.-à-d. *partiellement* incorporer cette police dans le fichier PDF final. Le sous-ensemble d’une police produit des fichiers PDF plus petits, car ils ne contiennent que les données des formes de caractères nécessaires pour afficher les caractères présents dans le document.
* Le deuxième `<` caractère précède le nom d’un fichier de vecteur d’encodage, `T1-WGL4.enc`, utilisé pour faire la correspondance entre les codes de caractères de votre texte et les données des formes de caractères (glyphes) dans le fichier de police — les données des formes de caractères sont nécessaires pour rendre (dessiner) le caractère.
* LuaLaTeX nécessite une étape de configuration supplémentaire parce que `\pdfmapline` génère une **Séquence de contrôle indéfinie** erreur en raison de changements dans la gestion par LuaTeX de certaines commandes du backend — la section 3 du [Manuel de référence de LuaTeX](http://mirrors.ctan.org/systems/doc/luatex/luatex.pdf). Le `\ifLuaTeX` , fournie par `iftex` package est utilisée pour détecter LuaTeX ; s’il est détecté, `\pdfmapline` est définie :

```latex
\ifLuaTeX
\protected\def\pdfmapline {\pdfextension mapline }
Этот текст будет на русском языке. Это демонстрация того, что символы кириллицы в сгенерированном документе отображаются правильно.
```

### Utilisation de plusieurs polices ou de polices commerciales

Pour gérer les fichiers fournis par des éditeurs de polices commerciales et des collections de polices gratuites, vous pouvez créer des dossiers dans votre projet Overleaf afin d’organiser les fichiers de police selon leur type (`.tfm`, `.pfb`, `.ttf` etc.). Un bon modèle pour nommer et organiser vos dossiers est la [TeX Directory Structure (TDS)](https://www.tug.org/tds/tds.pdf), conçue comme un « plan » de bonnes pratiques pour gérer une collection de fichiers liés à TeX.

Une fois les dossiers du projet en place, vous devez ensuite créer ce qu’on appelle un [`latexmcrc` fichier modifiable](/latex/fr/articles-approfondis/28-how-to-use-latexmkrc-with-overleaf.md) contenant des instructions indiquant au compilateur LaTeX de chercher les fichiers dans ces dossiers. Par défaut, les compilateurs ne savent pas que ces dossiers existent et ne trouveront pas les fichiers qu’ils contiennent.

#### Exemple de projet Overleaf

L’exemple de la Galerie Overleaf [Utilisation de dossiers pour gérer des fichiers de polices personnalisées](https://www.overleaf.com/latex/templates/example-using-folders-to-manage-custom-font-files/qvqgnpjxvqzd) utilise des dossiers et un `latexmkrc` fichier pour installer une police TrueType personnalisée. Il contient une structure de dossiers illustrée dans cette image :

![Organisation des dossiers du projet sur Overleaf](/files/0d8007c222b88375de90f03e59212a6f1f663733)

et un `latexmkrc` fichier contenant les lignes suivantes, qui définissent des [variables d’environnement](https://en.wikipedia.org/wiki/Environment_variable) d’exécution indiquant au compilateur LaTeX de rechercher les fichiers dans nos dossiers de projet :

```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'};
```

Si vous vous demandez quels fichiers vont généralement dans quel dossier, jetez un œil à [cet article](/latex/fr/articles-approfondis/06-an-introduction-to-kpathsea-and-how-tex-engines-search-for-files.md#table-listing-kpathsea-config-variables).

## Utilisation de polices personnalisées avec XeLaTeX et LuaLaTeX

### Utilisation des polices PostScript Type 1

Pour utiliser des polices PostScript Type 1 héritées avec XeLaTeX et LuaLaTeX, vous pouvez suivre les [consignes pour pdfLaTeX](#using-custom-fonts-with-pdflatex), nous ne répéterons donc pas ces détails ici.

### Utilisation des polices OpenType

XeLaTeX et LuaLaTeX offrent un support étendu pour la composition avancée à l’aide des polices OpenType — variantes TrueType et PostScript — parce que leurs moteurs TeX sous-jacents, XeTeX et LuaHBTeX, disposent de capacités natives (intégrées) pour traiter les technologies de polices OpenType, ce qui n’est pas le cas de pdfTeX.

* **Remarque**: LuaLaTeX, via son moteur TeX sous-jacent (LuaHBTeX), possède les capacités de gestion des polices les plus sophistiquées de tous les moteurs TeX ; toutefois, leur discussion dépasse le cadre de cet article — pour plus d’informations, voir les sections 6 et 12 du [Manuel de référence de LuaTeX](https://ctan.org/pkg/luatex?lang=en).

Pour utiliser des polices OpenType avec XeLaTeX et LuaLaTeX, vous devez charger [`fontspec`](https://ctan.org/pkg/fontspec?lang=en), un package puissant et riche en fonctionnalités qui fournit une interface aux capacités avancées de composition des polices OpenType.

* **Remarque**: Vous n’avez pas besoin d’utiliser `\usepackage[T1]{fontenc}` (ou `\usepackage[utf8]{inputenc}`) lorsque vous utilisez des polices OpenType avec XeLaTeX ou LuaLaTeX.

### Exemple : introduction à fontspec

Le processus est simple, car aucune installation de police n’est requise — pas besoin de `.tfm`, `enc` ou `.map` fichiers, et écrire des définitions de police (`.fd`) appartient au passé ! C’est aussi simple que cela :

1. Ajoutez la ligne suivante au préambule de votre document :

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

3. Sélectionnez l’icône de téléversement de fichier (![UploadIcon.png](/files/c287877f42a4b31ac45df641d9625872535ed485)), située au-dessus de la liste des fichiers.
4. Glissez-déposez les polices dans la fenêtre modale de téléversement, ou sélectionnez-les depuis votre ordinateur, pour ajouter la ou les polices à votre projet Overleaf.
5. Utilisez l’une des commandes `fontspec` package `\set*xxx*font` pour configurer et activer la ou les polices.

L’excellente `fontspec` documentation du package fournit une grande richesse d’exemples que vous pouvez explorer ; ici, nous resterons simples pour vous aider à démarrer. Par exemple, supposons que vous téléversiez un fichier de police appelé `CrimsonText-Regular.ttf`; après avoir chargé `fontspec` vous pouvez définir la police du texte principal du document en écrivant

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

Vous pouvez aussi écrire une syntaxe telle que

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

Vous pouvez aussi déclarer une nouvelle famille de polices à utiliser dans des situations arbitraires :

```latex
\newfontfamily{\crimson}{CrimsonText}
[Extension = .ttf, UprightFont = *-Regular, ...]
{\crimson Ce texte utilise la police CrimsonText}
```

#### Ressources

* Le [`fontspec` documentation du paquet](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) est un incontournable — il fournit non seulement de nombreux exemples utiles, mais contient aussi beaucoup d’informations de contexte utiles sur les polices OpenType.
* La page d’aide Overleaf sur [XeLaTeX](/latex/fr/polices/03-xelatex.md) contient un [exemple détaillé](/latex/fr/polices/03-xelatex.md#using-fonts-not-installed-on-overleaf27s-servers-google-fonts-example) montrant comment télécharger des polices OpenType depuis Google et les configurer avec `fontspec`.

**Projets d’exemple**

La Galerie Overleaf propose des projets d’exemple qui montrent l’utilisation de polices OpenType avec XeLaTeX ou LuaLaTeX — vous pouvez les ouvrir et basculer le compilateur entre LuaLaTeX et XeLaTeX :

* [Utilisation des polices Google avec XeLaTeX](https://www.overleaf.com/latex/templates/using-google-fonts-with-xelatex/xxkpcgfttjvd)
* [Utilisation des polices OpenType STIX2 avec LuaLaTeX ou XeLaTeX](https://www.overleaf.com/latex/templates/using-the-stix2-opentype-fonts-with-lualatex-or-xelatex/hdfvhzqmhnpx)

Le graphique suivant combine les sorties produites par ces projets :

![Exemples de projets Overleaf utilisant des polices Opentype](/files/910cfadf203d77e58b11ffdbaeeef70c14733d47)

## Bases des polices et des compilateurs LaTeX

### Extensions de fichiers de police

Le tableau ci-dessous répertorie les extensions de fichiers utilisées pour indiquer différents types (formats) de fichiers de police :

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

$$\displaystyle{}^{\mathbf\*}$$ En janvier 2023, toutes les applications de création d’Adobe [ont cessé de prendre en charge l’ancien format de police Type 1](https://helpx.adobe.com/uk/fonts/kb/postscript-type-1-fonts-end-of-support.html).

Les polices OpenType existent en deux « variétés », souvent appelées « saveurs » : saveur PostScript et saveur TrueType, des noms qui reflètent les données et le ou les mécanismes utilisés pour représenter les formes des caractères (glyphes) qu’elles contiennent. C’est pourquoi les polices OpenType ont deux extensions de fichier : `.otf` ou `.ttf` qui, par *convention*, impliquent :

* `*nomdeFichier*.otf` est une police OpenType de saveur PostScript
* `*nomdeFichier*.ttf` est une police OpenType de saveur TrueType

Par exemple, pdfTeX suppose que l’extension `.otf` indique une police OpenType de saveur PostScript.

* **Remarque** : le `.ttc` l’extension est utilisée uniquement pour les collections de polices TrueType.

### À propos de l’extension de fichier .ttf

Pour un fichier de police avec une extension `.ttf` , il peut s’agir soit :

* d’une police TrueType ancienne (non OpenType), soit
* d’une police OpenType contenant des données TrueType ainsi que les fonctionnalités supplémentaires fournies par OpenType.

Déterminer si un fichier de police donné `.ttf` est au format OpenType ou au format TrueType simple peut être délicat et nécessite que les applications examinent/investiguent les structures de données internes de la police. Pour plus de détails, voir [cette discussion (fil)](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format) ou cet [article Microsoft](https://learn.microsoft.com/en-us/typography/opentype/#why-is-my-opentype-font-listed-as-a-truetype-font-by-my-application).

### Formats de police et compilateurs LaTeX

Le tableau suivant résume les formats de police « grand public » pris en charge par trois compilateurs LaTeX (à proprement parler, pris en charge par les moteurs TeX sous-jacents) :

|                 |                         |                                                         |                                                        |                                           |
| --------------- | ----------------------- | ------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------- |
| **Compilateur** | **PostScript (Type 1)** | **TrueType (simple**$$\displaystyle{}^{\mathbf†}$$**)** | **OpenType (TrueType)**$$\displaystyle{}^{\mathbf\*}$$ | **OpenType (PostScript)**                 |
| pdfLaTeX        | Oui                     | Oui                                                     | Limité$$\displaystyle{}^{\mathbf{\*\*}}$$              | Limité$$\displaystyle{}^{\mathbf{\*\*}}$$ |
| XeLaTeX         | Oui                     | Oui                                                     | Oui                                                    | Oui                                       |
| LuaLaTeX        | Oui                     | Oui                                                     | Oui                                                    | Oui                                       |

$$\displaystyle{}^{\mathbf†}$$Par « simple », nous entendons une police TrueType qui ne contient pas les données supplémentaires (tables) définies par la spécification OpenType, et qui ne dispose donc pas des fonctionnalités de composition plus avancées des polices OpenType de saveur TrueType.

$$\displaystyle{}^{\mathbf\*}$$pdfTeX offre un support limité pour [Collections TrueType](https://learn.microsoft.com/en-us/typography/opentype/otspec150/otff#truetype-collections) (extension `.ttc`) — il ne lira les données que pour la première police contenue dans la collection.

$$\displaystyle{}^{\mathbf{\*\*}}$$Le support « limité » d’OpenType par pdfTeX signifie :

* il ne prend pas en charge les fonctionnalités avancées de composition contenues dans les polices OpenType ;
* il peut sous-ensembler les polices OpenType de saveur TrueType, mais pas les polices OpenType de saveur PostScript, qui doivent être entièrement incorporées. L’absence de sous-ensemble de police produit des fichiers PDF plus volumineux et pose des problèmes de licence avec les polices commerciales, qui interdisent généralement l’incorporation complète ;
* il ne peut pas utiliser plus de 256 caractères par police, alors que des polices OpenType individuelles en prennent en charge des dizaines de milliers ;
* il nécessite la production de métriques de police TeX et d’autres fichiers auxiliaires (requis par LaTeX) — des प्रक्रédures qui dépassent le cadre de cet article (voir [Lectures complémentaires](#further-reading) pour des liens vers des descriptions de ces processus).

## Lectures complémentaires

* [Fonctionnement d’OpenType](https://simoncozens.github.io/fonts-and-layout/opentype.html) (par Simon Cozens).
* [Déterminer si un fichier de police est au format OpenType ou TrueType](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format)— une discussion sur la difficulté à déterminer si un `.ttf` est du TrueType simple ou du TrueType de saveur OpenType.
* [Un examen plus approfondi des polices TrueType et de pdfTeX](https://tug.org/TUGboat/tb30-1/tb94thanh.pdf)— un article TUGboat rédigé par [Hàn Thế Thành](https://tug.org/interviews/thanh.html), le créateur de [pdfTeX](https://www.tug.org/applications/pdftex/).
* [A Directory Structure for TeX Files](https://tug.org/tds/tds.html), une hiérarchie standard de dossiers/répertoires pour organiser les fichiers liés à TeX.
* [L’installation et l’utilisation des polices OpenType dans LaTeX](https://www.tug.org/TUGboat/tb27-2/tb87owens.pdf)— un article TUGboat expliquant comment préparer des polices OpenType pour une utilisation avec pdfLaTeX.
* [Comment utiliser des polices TrueType avec PdfTeX à l’aide de otftotfm ?](https://tex.stackexchange.com/questions/52819/how-do-i-use-truetype-fonts-with-pdftex-using-otftotfm/52902#52902)— un fil tex.stackexchange contenant un exemple détaillé.

### Une note sur les « guerres des polices »...

Les années 1980 et 1990 ont vu les soi-disant « guerres des polices », alors que deux formats de police concurrents, PostScript Type 1 (d’Adobe) et TrueType (créé par Apple, sous licence Microsoft), se disputaient la suprématie — pour conquérir le cœur et l’esprit de tous les utilisateurs, en particulier des designers et des typographes. Finalement, le [format de police OpenType](https://learn.microsoft.com/en-us/typography/opentype) a émergé (en 1997) comme solution hybride, englobant et étendant les technologies de polices d’Adobe et d’Apple. OpenType s’appuie sur le format de fichier TrueType d’origine pour permettre des capacités de composition avancées et une meilleure prise en charge d’Unicode grâce à des polices contenant plus de 65 000 formes de caractères (glyphes).


---

# 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/fr/questions-et-reponses/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.