Tous les réglages

Table des matières

Éditeur › Fichier de réglages (Ctrl+,) ouvre ~/.config/kaivalya-editor/settings.toml. Chaque option ci-dessous y figure, avec le même commentaire : vous aurez donc rarement besoin de cette page. Une option que le fichier ne mentionne pas garde la valeur indiquée ici. Un projet peut aussi modifier n’importe laquelle pour lui seul, dans .kaivalya/settings.toml, en n’y écrivant que ce qui change — voir Les réglages propres à un projet.

Cette page est générée à partir des valeurs et des commentaires de l’éditeur lui-même, à chaque construction du site.

`theme`

Par défaut: "Kaivalya Blue"

Les couleurs. Au choix :

« system »            suivre le bureau, clair ou sombre
« light »             identique à « Kaivalya Light »
« dark »              identique à « Kaivalya Dark »
« Kaivalya Night »    un sombre plus profond et plus froid
« Kaivalya Kiln »     clair et chaud, accents rouges
« Kaivalya Ember »    sombre et chaud, accents rouges
« Kaivalya Blue »     la fenêtre elle-même en bleu
« Kaivalya Red »      la fenêtre elle-même en rouge

Avec tout autre nom que « system », l’éditeur ne suit plus le bureau. Pour vos propres thèmes : un fichier .json dans le dossier themes, à côté de ce fichier — ~/.config/kaivalya-editor/themes/, sauf si XDG_CONFIG_HOME indique un autre emplacement. L’enregistrer change les couleurs sans redémarrer.

`locale`

Par défaut: aucune valeur — locale = "fr-FR"

La langue des menus et des messages. « en-US » ou « fr-FR ». Omettez la ligne pour suivre la langue du bureau.

`font_family`

Par défaut: "JetBrainsMonoNL Nerd Font Mono"

La police du texte. N’importe quelle police installée sur cette machine, ou "" pour la police à chasse fixe de votre bureau. Un nom introuvable revient à cette dernière, et l’éditeur le signale. Une police qui n’a pas son propre ❤, comme JetBrains Mono, laisse ❤ et ses semblables s’afficher en couleur, comme des émojis. La variante NL (sans ligatures) affiche tels que vous les tapez.

`interface_font_family`

Par défaut: aucune valeur — interface_font_family = "Inter"

La police des menus, des onglets et de la barre d’état. Sans valeur, IBM Plex Sans si elle est installée, sinon la première police installée de la liste du framework — Ubuntu, Noto Sans, DejaVu Sans… — qui a son propre gras.

`pane_font_family`

Par défaut: aucune valeur — pane_font_family = "Inter"

La police des panneaux. Sans valeur, elle suit interface_font_family.

`font_size`

Par défaut: 17.0

La taille du texte que vous écrivez, en pixels. C’est aussi celle des cellules de la grille de tableau, qui contiennent elles aussi votre texte. Les panneaux et les menus ont leur propre taille.

`interface_font_size`

Par défaut: 16.0

La taille des menus, des onglets, des panneaux et de la barre d’état, en pixels. Un réglage distinct de font_size, volontairement : celui-là donne la taille du texte que vous écrivez, celui-ci celle de l’interface, et on peut vouloir changer l’une sans l’autre. Dans la grille de tableau, il règle les boutons autour des cellules et la place accordée à une colonne pour les contenir ; les cellules, elles, suivent font_size.

`pane_font_size`

Par défaut: 16.0

La taille du texte de l’explorateur, du plan et des résultats de recherche. Une troisième taille, car un panneau pose une troisième question : la taille d’une liste de noms de fichiers n’est ni celle de votre texte, ni celle des menus. Elle était fixée à 12,8 et impossible à changer jusqu’à ce que vous le demandiez. La grille de tableau n’est pas un panneau : ses cellules suivent font_size.

`tab_size`

Par défaut: 2

Le nombre de colonnes d’un niveau d’indentation. Le markdown et le web indentent de deux, et une liste imbriquée est l’indentation la plus courante dans un éditeur markdown ; un projet Rust ou Python utilise plutôt 4. « Formater ce fichier » utilise la même largeur.

`insert_spaces`

Par défaut: true

true indente avec des espaces, false avec des tabulations. false écrit une tabulation par niveau, quelle que soit la largeur que tab_size donne à un niveau. « Formater ce fichier » le respecte aussi.

`soft_wrap`

Par défaut: true

Si une ligne trop longue pour la fenêtre revient à la ligne au lieu de défiler. Activé par défaut : c’est avant tout un éditeur markdown, et un texte qui dépasse à droite de la fenêtre est un texte qu’on ne peut pas lire. Alt+Z le désactive pour la fenêtre en cours.

`show_line_numbers`

Par défaut: true

Les numéros de ligne, à gauche du texte.

`show_invisibles`

Par défaut: false

Afficher les espaces, les tabulations et les fins de ligne par des marques discrètes.

`on_open`

Par défaut: "home"

Ce qu’affiche une fenêtre ouverte sans fichier. « home » une liste où choisir, le dernier projet en tête ; « last_project » le dernier projet, directement, sans un clic ; « empty » un document sans titre, comme avant l’existence de ce réglage.

`markdown_mode`

Par défaut: "edit"

La vue dans laquelle s’ouvre un fichier markdown. « preview » le document mis en forme, « edit » le texte, « split » les deux côte à côte.

`markdown_properties`

Par défaut: false

Si l’en-tête d’un document est affiché sous forme de tableau au-dessus de lui — le bloc entre les lignes — en haut d’un fichier : titre, étiquettes, css, et tout ce que vous y rangez. false le laisse hors du document mis en forme, comme il l’a toujours été : l’en-tête est une instruction pour l’éditeur, pas une partie de votre texte. true l’affiche, ce qui vous convient si ce bloc contient des notes plutôt que des réglages. Seules les vues mises en forme changent : le texte, lui, ne bouge pas.

`markdown_stylesheet`

Par défaut: "github-light"

La feuille de style de l’aperçu quand rien d’autre n’en a choisi une. Un nom dans styles/, à côté de ce fichier — pas un chemin. « github-light » est celle de GitHub, en clair, quel que soit votre thème. « github » est la paire, qui suit votre thème, clair ou sombre. « kaivalya » est celle de l’éditeur, qui contient les deux palettes. Une seule règle : -light.css et -dark.css sont cherchés d’abord et suivent le thème, puis .css. Une feuille à vous n’a donc besoin que d’un fichier de ce nom dans ce dossier ; elle suit votre thème si vous en avez déposé deux, pas si vous n’en avez déposé qu’un. Ce n’est qu’une valeur par défaut : le sélecteur de la barre d’état, une ligne css: dans un document et une règle de dossier dans .kaivalya/project.toml l’emportent, dans cet ordre.

`heavy_preview`

Par défaut: true

Si l’aperçu complet est proposé : du vrai CSS, dans sa propre fenêtre. C’est la seule fonction de l’éditeur dont le coût en mémoire mérite d’être annoncé — un second processus, avec un moteur de style et un accès à la carte graphique : environ 120 Mo tant qu’un document est affiché. Il ne coûte rien tant qu’il n’est pas ouvert. Une version compilée sans le moteur de rendu le signale au lieu de faire semblant.

`maths_scale`

Par défaut: 1.1

La taille d’une formule par rapport au texte qui l’entoure. Un rapport, pas une taille : les formules sont dessinées en em, elles prennent donc la taille de ce qui les contient — un paragraphe, un titre, une cellule de tableau —, avec votre feuille de style comme avec une autre, et ce réglage la multiplie. Un peu plus de 1.0 se lit mieux, car une police mathématique à côté d’une police de texte de même taille paraît petite ; 1.1 avec la feuille kaivalya fournie donne exactement 14 pt. 1.0 donne la taille du texte lui-même. Seuls l’aperçu complet et les exports dessinent les formules.

`export_mathjax_url`

Par défaut: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js"

L’adresse d’où le second export charge MathJax. « Exporter en HTML, dessiné par le navigateur » inscrit cette adresse dans la page, et c’est le navigateur du lecteur qui va chercher le script : la page a donc besoin du réseau pour être lue, et elle demande un script au serveur de quelqu’un d’autre. Faites-la pointer vers votre propre copie si cela ne vous convient pas. Par défaut : le CDN de MathJax, version SVG — sans police web, la page s’imprime telle qu’elle s’affiche. L’export ordinaire « Exporter en HTML… » ignore ce réglage : il dessine les formules ici, et la page qu’il écrit n’a besoin de rien.

`export_mermaid_url`

Par défaut: "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs"

L’adresse d’où ce même export charge mermaid, aux mêmes conditions. La version module ES, celle qu’importe la documentation de mermaid.

`paste_image_folder`

Par défaut: "images"

Le dossier où est enregistrée une image collée, à côté du document — ainsi qu’une image déposée, sauf si elle se trouve déjà à côté du document ou en dessous. Créé au premier collage. Vide : directement à côté du document.

`daily_note_folder`

Par défaut: "journal"

Le dossier du projet où est écrite la note du jour, AAAA-MM-JJ.md. Créé à la première note. Vide : la racine du projet.

`daily_note_template`

Par défaut: "journal"

Le modèle de départ d’une nouvelle note du jour, par son nom, sans .md — ou sous la forme dossier/nom pour un modèle rangé dans un dossier, comme « notes/jour ». Vide : une note vide. Les marqueurs y sont remplacés comme d’habitude. « journal » est celui qui est fourni, dans le dossier templates à côté de ce fichier.

`whiteboard_background`

Par défaut: ""

La couleur derrière un tableau blanc (un fichier .canvas) : "" pour celle du thème, ou “#rrvvbb”. Le fichier d’Obsidian ne mémorise pas de fond : ce réglage vaut pour tous les tableaux, et Obsidian utilise le sien.

`whiteboard_text`

Par défaut: ""

La couleur du texte d’un tableau blanc : "" pour celle du thème, ou “#rrvvbb”. À changer avec le fond quand le texte du thème ne s’y lirait pas : un fond sombre sous un thème clair demande un texte clair.

`whiteboard_grid`

Par défaut: true

Si un tableau blanc affiche une grille de points derrière ses cartes.

`show_markdown`

Par défaut: true

La mise en forme de ce document, dans un panneau : sa feuille de style, et les commandes qui agissent sur le markdown, en sections repliables. Activé ne veut pas dire ouvert : un bord n’affiche qu’un panneau, ce réglage ajoute donc son icône dans le rail, à côté de celui qui est ouvert.

`markdown_side`

Par défaut: "right"

« left » ou « right ».

`show_colour`

Par défaut: false

Un sélecteur de couleur, et les couleurs déjà présentes dans ce fichier, dans un panneau.

`colour_side`

Par défaut: "right"

« left » ou « right ».

`colour_as`

Par défaut: "window"

« pane » : dans le rail, ancré ou ouvert au survol. « window » : une fenêtre à part, ouverte par la même icône et les mêmes touches, qui écrit là où se trouvait votre curseur. Avec « window », désactiver le réglage show_ retire l’icône du rail ; les touches et la palette ouvrent toujours la fenêtre.

`show_characters`

Par défaut: false

Tous les caractères absents du clavier — flèches, symboles, émojis, entités HTML — dans un panneau : une recherche, les derniers utilisés, et une grille. Un clic les insère.

`characters_side`

Par défaut: "right"

« left » ou « right ».

`characters_as`

Par défaut: "window"

`show_outline`

Par défaut: true

Le plan du fichier ouvert, dans un panneau.

`outline_side`

Par défaut: "right"

« left » ou « right ».

`show_explorer`

Par défaut: true

Les fichiers du projet, dans un panneau.

`explorer_side`

Par défaut: "left"

« left » ou « right ». Deux panneaux peuvent choisir le même bord : ce bord en affiche un et propose l’autre sous forme d’icône à côté, qui s’ouvre d’un clic et se consulte au survol.

`show_search`

Par défaut: true

La recherche dans le projet, dans un panneau. Activé ne veut pas dire ouvert : un bord n’affiche qu’un panneau, ce réglage ajoute donc son icône dans le rail, à côté de celui qui est ouvert.

`search_side`

Par défaut: "left"

« left » ou « right ».

`show_files`

Par défaut: true

Tous les documents ouverts dans cette fenêtre, dans un panneau : la barre d’onglets sous forme de liste, le document actif mis en évidence. Un clic pour s’y rendre.

`files_side`

Par défaut: "left"

« left » ou « right ».

`open_files_button`

Par défaut: "right"

À quelles extrémités de la barre d’onglets se trouve le bouton qui liste les documents ouverts : « left », « right », « both » ou « none ».

`show_git`

Par défaut: true

Ce qui a changé depuis le dernier commit, dans un panneau : les différences d’un fichier d’un double-clic, et un champ de message pour committer les fichiers cochés.

`git_side`

Par défaut: "left"

« left » ou « right ».

`show_todo`

Par défaut: true

Chaque ligne du projet portant l’un des todo_tags, dans n’importe quel fichier, dans un panneau. Un clic pour s’y rendre.

`todo_side`

Par défaut: "left"

« left » ou « right ».

`todo_tags`

Par défaut: ["TODO", "FIXME"]

Les mots que cherche le panneau À faire, en mots entiers et tels qu’écrits : « TODO » trouve TODO: et // TODO(ana), mais ni todo ni TODOS.

`scrollbar_marks`

Par défaut: true

Des repères le long de la barre de défilement : les titres ou les définitions du fichier, et ses lignes TODO. Ils viennent de ce que le plan et le panneau À faire ont déjà lu.

`peek_on_hover`

Par défaut: false

Si le survol d’une icône du rail ouvre son panneau par-dessus l’éditeur. Désactivé : un panneau ne s’ouvre qu’au clic, et reste ouvert.

`preview_follows_caret`

Par défaut: true

Dans la vue côte à côte : l’aperçu suit le curseur de titre en titre, faire défiler un côté amène l’autre au même titre, et un clic sur un titre de l’aperçu y amène le texte.

`local_history`

Par défaut: true

Chaque enregistrement conserve une version du fichier, sur cette machine et jamais dans le projet : Fichier > Historique local les liste, compare chacune au fichier actuel et permet d’en restaurer une. Un texte identique n’est conservé qu’une fois.

`local_history_keep`

Par défaut: 50

Le nombre de versions conservées par fichier, les plus récentes. 0 : pas de limite.

`local_history_days`

Par défaut: 30

Le nombre de jours pendant lesquels une version est conservée. 0 : sans limite d’âge.

`copy_on_select`

Par défaut: false

Sélectionner du texte le copie dans le presse-papiers, comme dans un terminal. Désactivé par défaut, car la sélection remplacerait aussi ce que vous aviez copié au moment de sélectionner un texte pour coller par-dessus.

`clipboard_history`

Par défaut: 20

Le nombre d’éléments copiés ou coupés que propose Édition > Coller depuis l’historique (Alt+V), du plus récent au plus ancien. Gardés en mémoire uniquement, jamais écrits sur le disque. 0 : aucun.

`rail_order`

Par défaut: ["explorer", "files", "search", "todo", "git", "outline", "markdown", "characters", "colour"]

L’ordre des icônes de panneau dans le rail, par nom, pour les deux bords : « explorer », « files », « search », « todo », « git », « outline », « markdown », « characters », « colour ». Un panneau absent de la liste vient après ceux qui y figurent. Le premier panneau d’un bord est celui qu’il affiche à l’ouverture.

`rail_icon_size`

Par défaut: 25.0

La taille des icônes du rail, en pixels, de 12 à 40. Le rail prend la largeur dont elles ont besoin.

`show_hidden`

Par défaut: true

Si les fichiers dont le nom commence par un point sont listés. Activé : .gitignore, .github/ et .env sont justement des fichiers pour lesquels cet éditeur existe. .git/ n’est jamais listé, quel que soit le réglage.

`use_gitignore`

Par défaut: false

Si ce que .gitignore exclut est laissé de côté. Activé : vous n’avez pas ouvert le projet pour lire target/ ou node_modules/. Désactivé : ils réapparaissent, à la fois dans l’explorateur, le sélecteur de fichiers et la recherche. Ctrl+Maj+G change ce réglage le temps d’une séance, sans modifier ce fichier.

`toc_min_level`

Par défaut: 2

Le niveau de titre le plus élevé que reprend une table des matières. 2 laisse de côté le titre de niveau 1, qui est celui du document lui-même.

`toc_max_level`

Par défaut: 6

Le niveau de titre le plus profond qu’elle reprend. De 1 à 6.

`line_width`

Par défaut: 80

La largeur de ligne, en colonnes, que vise le formatage.

`format_wrap_text`

Par défaut: false

Si le formatage renvoie à la ligne le texte qui dépasse line_width. Désactivé par défaut : ce renvoi réécrit toutes les lignes d’un paragraphe, si bien qu’un seul formatage d’un document écrit à raison d’une phrase par ligne modifie tout le fichier.

`format_on_save`

Par défaut: "off"

Si l’enregistrement formate d’abord le fichier : « off », « embedded » ou « always ». « embedded » ne formate que là où le formateur est intégré — markdown, JavaScript, TypeScript, JSON, CSS, HTML, XML, Vue, YAML, TOML, PHP —, ce qui ne lance aucun processus ; « always » lance aussi rustfmt, gofmt, shfmt, ruff, ou dprint quand le projet a un dprint.json. Désactivé par défaut : reformater un dépôt dont l’éditeur a deviné les conventions produit des différences que personne ne peut relire.

`format_on_save_languages`

Par défaut: {}

La même chose, langage par langage : { rust = “always”, markdown = “off” }.

`format_timeout_ms`

Par défaut: 400

Le temps, en millisecondes, qu’un formateur externe peut prendre avant d’être arrêté ; le texte est alors laissé tel quel.