Outils du document
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
Section intitulée « 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
Section intitulée « Où vont les valeurs »- 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
\setdefaultlanguagequand le document charge polyglossia, ou ajoute\usepackage[language]{babel}. Utilisez des noms babel commeenglish. - L’Interligne est Simple, Un et demi, Double, ou un nombre comme
1.5. Il utilise le paquet setspace, ou\linespreadquand 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.
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 comme1.,1.1,1.a,I.ouA.#set math.equation(numbering: …), avec(1),(1.1)ou1
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
Section intitulée « 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. 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.
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
Section intitulée « 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,llncsetbeamerfixent 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
#setqui porte la valeur comporte une conditionifou 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
Section intitulée « Pages liées »- Paquets : ajoutez d’autres paquets LaTeX ou Typst
- Compilation : choisissez XeLaTeX ou LuaLaTeX, et une variante de compilation Typst
- Analyse du document : voyez ce que contient le document