# Réglages du document

Changez le format de page, les marges, la police, la langue, l'interligne et la numérotation dans une boîte de dialogue qui modifie le préambule LaTeX, les règles #set de Typst ou l'en-tête YAML Markdown.

Chaque langage range sa mise en page ailleurs : options de classe et commandes de préambule en LaTeX, règles `#set` en Typst, en-tête YAML en Markdown. Les **Réglages du document** vous donnent un formulaire unique pour tout. Quand vous l'appliquez, Oleafly écrit le changement dans votre fichier principal comme du source ordinaire, que vous pouvez lire et modifier ensuite.

Ouvrez-le avec le bouton **Réglages du document** à l'extrémité droite de la barre d'outils de l'éditeur, ou lancez **Réglages du document** depuis la palette ⌘K (Ctrl+K). La boîte de dialogue modifie toujours le document principal du projet, quel que soit le fichier que vous avez ouvert.

## Les champs

Le formulaire compte quatre sections. Les champs dépendent du moteur :

| Section | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| Page | Format de page, Colonnes, Marges | Format de page, Marges, Colonnes | Type de document, Classe de document, Format de page, Colonnes, Marges |
| Texte | Police du texte, Taille de police, Langue | Police du texte, Taille de police, Langue, Région | Police du texte, Taille de police, Langue |
| Paragraphe | Interligne | Justification, Interligne | Interligne |
| Numérotation | Niveaux numérotés, Numérotation des équations | Numérotation des titres, Numérotation des équations | Numéros de section |

Les listes commencent par **Par défaut**, qui retire le réglage pour que la valeur par défaut de la classe, du modèle ou du moteur s'applique de nouveau. Laissez un champ texte vide pour le même effet. Les longueurs prennent des unités, comme `2.5cm`, `1in` ou `11pt`, et les marges Typst acceptent aussi `auto`. Une valeur qu'Oleafly ne peut pas utiliser reçoit une courte note sous le champ, et **Appliquer** attend que vous la corrigiez.

La **Police du texte** propose des polices au fil de la saisie. Dans les projets Typst, la liste contient toutes les polices que Typst peut trouver et indique d'où vient chacune : le dossier `fonts` du projet, l'ordinateur, ou l'ensemble intégré à Typst. Dans les projets LaTeX et Markdown, elle liste les polices installées sur l'ordinateur.

Choisissez **Appliquer** pour écrire les changements, ou **Annuler** pour ne pas toucher au fichier. Quand le fichier principal est ouvert dans l'éditeur, un seul ⌘Z (Ctrl+Z) annule l'ensemble du changement.

## Où vont les valeurs

### LaTeX

- Le **Format de page**, les **Colonnes** et la **Taille de police** deviennent des options de `\documentclass`.
- Les **Marges** passent par le paquet geometry. Oleafly modifie une `\geometry{…}` ou une option geometry existante, ou ajoute `\usepackage[margin=…]{geometry}`.
- La **Police du texte** écrit `\setmainfont{…}` et charge fontspec. Dans un projet latexmk, elle demande le compilateur XeLaTeX ou LuaLaTeX, et le champ le dit jusqu'à ce que vous en choisissiez un dans le menu de compilation ou que le document en demande un, par exemple avec une ligne `% !TeX program = xelatex`.
- La **Langue** ajoute la langue à babel, utilise `\setdefaultlanguage` quand le document charge polyglossia, ou ajoute `\usepackage[language]{babel}`. Utilisez des noms babel comme `english`.
- L'**Interligne** est **Simple**, **Un et demi**, **Double**, ou un nombre comme `1.5`. Il utilise le paquet setspace, ou `\linespread` quand c'est ce que le document a déjà.
- Les **Niveaux numérotés** règlent `secnumdepth`. Choisissez **Aucun**, **Chapitres uniquement**, ou la profondeur de la numérotation, de **Jusqu'aux sections** à **Jusqu'aux sous-paragraphes**.
- La **Numérotation des équations** écrit `\numberwithin{equation}{…}` pour **Par section**, **Par chapitre** ou **Par sous-section**.

### Typst

Les valeurs vont dans les règles `#set` du fichier principal. Quand une règle manque, Oleafly l'ajoute vers le haut :

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, où la **Justification** est **Justifié** ou **Aligné à gauche**
- `#set heading(numbering: …)`, avec des motifs comme `1.`, `1.1`, `1.a`, `I.` ou `A.`
- `#set math.equation(numbering: …)`, avec `(1)`, `(1.1)` ou `1`

La **Langue** prend un code de deux ou trois lettres, comme `en`, et la **Région** un code de deux lettres, comme `GB`.

Les projets Typst reçoivent aussi une section **Variantes de compilation**. Chaque variante est un ensemble nommé de valeurs que le document lit avec `sys.inputs`, par exemple une version brouillon et une version définitive. Utilisez **Ajouter une variante**, donnez-lui un nom, puis ajoutez chaque valeur avec **Ajouter une valeur**. Choisissez la variante à compiler depuis **Variante (ce projet)** dans le menu de compilation.

### Markdown

Les valeurs vont dans l'en-tête YAML que Pandoc lit quand il construit le PDF : `type`, `documentclass`, `papersize`, `classoption` pour les colonnes, `geometry` pour les marges, `mainfont`, `fontsize`, `lang`, `linestretch` et `numbersections`. Le **Type de document** propose **Article**, **Rapport ou thèse**, **Livre**, **Diapositives**, **Poster**, **Lettre** et **CV**, et décide de ce que le document produit. Voir [Types de document](/docs/writing/markdown/#document-types). La **Classe de document** propose `article`, `report`, `book`, `scrartcl`, `scrreprt` et `memoir`. La **Langue** prend une balise comme `en-US`.

Là où vous n'avez pas défini de police, Oleafly en choisit une pour chaque écriture du document, comme le coréen, l'arabe ou le devanagari. La **Langue** décide aussi quelle police reçoivent les caractères chinois : `ja` donne la police japonaise, `zh` le chinois simplifié et `zh-TW` le chinois traditionnel. Voir [Texte dans d'autres langues](/docs/writing/markdown/#text-in-other-languages).

Si le fichier n'a pas encore d'en-tête YAML, la boîte de dialogue le dit, et **Appliquer** ajoute un bloc en haut. Un en-tête YAML sans ligne `---` de fermeture doit d'abord être corrigé à la main.

## Champs en lecture seule

Certaines valeurs appartiennent à autre chose, et la boîte de dialogue les affiche en grisé avec la raison dessous :

- **Défini par la classe …** : des classes comme `acmart`, `IEEEtran`, `llncs` et `beamer` fixent leurs propres marges, et certaines fixent aussi le format de page, la taille de police, les colonnes, l'interligne ou la langue. Une note en haut de la boîte de dialogue nomme la classe.
- **Défini par le style …** : les paquets de style de conférence, comme ceux de NeurIPS, ICML, ICLR, CVPR et ACL, définissent le format de page et les marges. Une note en haut de la boîte de dialogue indique quel style est responsable.
- **Le source définit chaque marge séparément** : le document donne les marges gauche, droite, haute et basse individuellement au lieu d'une seule valeur `margin`.
- **Défini dans un bloc conditionnel** : la valeur se trouve dans du code `\if…`, donc la changer ici pourrait casser la logique.
- **Défini par le modèle** : en Typst, la règle `#set` qui porte la valeur comporte une condition `if` ou passe des arguments `..`, comme le code de modèle le fait souvent, donc la boîte de dialogue n'y touche pas.
- **Défini par une expression dans le source** : la valeur est calculée, pas écrite en clair, donc modifiez plutôt le source.

Quand un document Typst applique un modèle, une note en haut indique que les valeurs définies dans le modèle ne sont pas affichées, et qu'une valeur définie ici remplace celle du modèle. En LaTeX, une note similaire apparaît quand une partie du préambule se trouve dans d'autres fichiers.

## Pages liées

- [Paquets](/docs/packages/) : ajoutez d'autres paquets LaTeX ou Typst
- [Compilation](/docs/compiling/) : choisissez XeLaTeX ou LuaLaTeX, et une variante de compilation Typst
- [Analyse du document](/docs/document-insights/) : voyez ce que contient le document
