Thèmes

Un thème modifie l’apparence de MDM tout en conservant la même disposition : les fenêtres, menus et boutons restent à leur place, mais avec des couleurs, des formes et des icônes différentes. Chaque thème propose une version claire et une version sombre.

Choisir un thème

Ouvrez Affichage → Thème et cliquez sur un thème : la fenêtre entière change instantanément, sans redémarrage. Affichage → Prise en charge du mode sombre et Affichage → Toujours sombre permettent ensuite de choisir sa version claire ou sombre, comme pour l’apparence classique (Mode sombre).

Les thèmes intégrés sont Classique (l’apparence propre à MDM, par défaut), Natif (couleur d’accentuation et contraste de votre système), Contraste élevé, et les thèmes de style Metro, Adwaita, Breeze, Luna, Aero et Aqua, chacun avec ses propres formes de commandes et icônes, et sous Windows sa propre barre de titre. Démarrer les décrit tous ; la page des thèmes du site web les montre tous, en clair et en sombre.

Emplacement des fichiers de thème

Les fichiers de thème que vous créez ou téléchargez vont dans le dossier des thèmes de MDM. Affichage → Thème → Ouvrir le dossier des thèmes l’ouvre (et le crée la première fois). Il se trouve dans le dossier de données de MDM :

En deux secondes, un nouveau fichier apparaît dans Affichage → Thème, sous les thèmes intégrés, avec le name qu’il se donne. Après avoir modifié un fichier, sélectionnez-le à nouveau dans Affichage → Thème pour voir le changement.

Un thème peut être un seul fichier (harbour.toml) ou un dossier propre (harbour/theme.toml) s’il contient des icônes.

L'option Affichage → Thème → Ajouter un fichier de thème… s'en charge : choisissez un fichier n'importe où, et MDM le copie dans le dossier des thèmes et l'utilise aussitôt. Un fichier qui n'est pas un thème n'est pas ajouté, et MDM vous dit pourquoi.

Palettes de couleurs Base16 et pywal

Les palettes de couleurs conçues pour d'autres programmes sont aussi des thèmes, sans aucune conversion nécessaire :

• Une palette Base16, le fichier .yaml dans lequel les palettes Base16 et Base24 sont fournies : aussi bien la disposition classique (scheme: et base00 à base0F en haut) que la plus récente (name: et un bloc palette:). Une palette Base24 est lue comme ses 16 premières couleurs.
• Le fichier colors.json de pywal, ou tout fichier d'un programme ayant la forme de pywal (le modèle pywal de wallust).

Ajoutez-le avec Affichage → Thème → Ajouter un fichier de thème…, ou placez-le vous-même dans le dossier des thèmes. Il apparaît dans Affichage → Thème sous le nom de la palette (name: ou scheme: ; celui de pywal porte le nom du fond d'écran).

pywal lui-même : une fois que wal a été exécuté, Affichage → Thème liste pywal, lu directement là où pywal écrit ses couleurs : ~/.cache/wal/colors.json (sous Windows %USERPROFILE%\.cache\wal\colors.json, où winwal et pywal l'écrivent ; $PYWAL_CACHE_DIR ou $XDG_CACHE_HOME/wal si vous les définissez). Choisissez-le et MDM suit votre fond d'écran : chaque fois que wal écrit de nouvelles couleurs, MDM les prend en moins de deux secondes. Il ne regarde que la date et la taille du fichier, toutes les deux secondes, et seulement tant que pywal est le thème. Une copie ajoutée avec Ajouter un fichier de thème… conserve les couleurs qu'elle avait.

Une palette ne change que les couleurs, sur l'apparence classique : chaque fenêtre, bouton et menu reste à sa place. Une palette sombre rend MDM sombre et une palette claire le rend clair, quelle que soit la valeur de Affichage → Toujours sombre. Les couleurs de la palette vont là où elles ont la même signification :

Les bordures et les nuances de survol et de pression sont mélangées à partir de celles-ci, comme pour un fichier de thème [seeds]. Le texte reste lisible : le texte et le texte secondaire à 4,5:1 ou plus par rapport à chaque arrière-plan sur lequel ils se trouvent (WCAG AA), l'accent à 3:1. Une palette en deçà de cela a ces couleurs légèrement assombries (éclaircies sur une palette sombre) jusqu'à ce qu'elles passent ; le journal de MDM indique lesquelles.

Pour modifier plus que les couleurs, créez un fichier de thème qui hérite de la palette par son nom de fichier et ajoute ce que vous voulez :

name = "Gruvbox, my way"
inherits = "gruvbox-dark-medium"   # gruvbox-dark-medium.yaml, beside it
icons = "accent"

[sizes]
radius = 6

inherits = "pywal"fonctionne de la même manière, et suit wal aussi.

Le fichier

Un thème est un petit fichier texte au format TOML (ou JSON, .json ; ou une palette de couleurs, .yaml). Il ne nomme que ce qu'il change ; tout le reste provient du thème dont il inherits :

name = "Harbour"
inherits = "classic"
icons = "color"

[seeds.light]
background = "#eef3f6"
surface = "#ffffff"
text = "#11202b"
accent = "#0f6c8c"

[seeds.dark]
background = "#14212a"
surface = "#0e171d"
text = "#e8f0f4"
accent = "#5cc3e6"

[sizes]
radius = 6

[controls]
focus = "ring"

• name — ce que Affichage → Thème liste ; le nom du fichier s’il n’y en a pas.
• inherits — le thème dont le vôtre hérite : classic (par défaut s’il est omis), l’identifiant d’un thème intégré (metro, adwaita, breeze, luna, aero, aqua, high-contrast), ou un autre fichier de thème dans le même dossier, par son nom de fichier sans .toml. Un fichier qui hérite d’un autre peut être hérité à son tour ; un thème ne peut pas s’hériter lui-même.
• [seeds] — une poignée de couleurs (background, surface, header, text, accent, selection, error, warning, success) que MDM applique à chaque commande. [seeds.light] et [seeds.dark] donnent à chaque côté sa propre couleur.
• [colors] — rôles de couleur uniques (tels que window, accent ou "segments.done") des deux côtés ; [light] et [dark] d’un seul côté. Une couleur est #rrggbb, ou #rrggbbaa avec transparence. Les rôles définis par un fichier l’emportent sur ses couleurs de base.
• [sizes] — rayons des coins, largeurs des bordures, tailles de police et hauteurs de ligne, en pixels.
• [controls] — la forme des zones de texte, des cases à cocher, des boutons, des barres de progression, des barres de défilement, du marqueur de focus et de la barre de titre.
• icons — color, mono (une couleur) ou accent.
• contrast = "high" — renforce chaque bord et couleur de texte par-dessus le reste.

Chaque rôle de couleur, taille et style de commande, avec ce qu’il définit, est listé sur la page des thèmes du site web (lu directement depuis le code de MDM, donc toujours à jour). Les thèmes intégrés sont écrits de la même manière : lisez-les sur GitHub.

Une clé que MDM ne connaît pas, ou une valeur qu’il ne peut pas lire, est ignorée et écrite dans le journal de MDM (le dossier logs à côté du dossier des thèmes), de sorte qu’un fichier créé pour une version plus récente de MDM se charge toujours. Un fichier qui n’est pas un TOML ou JSON valide ne se charge pas, et le journal indique pourquoi. Un fichier nommé comme un thème intégré (metro.toml) est ignoré : donnez au vôtre un nom qui lui est propre.

Icônes

Un thème dans son propre dossier (harbour/theme.toml) peut apporter ses icônes dans icons/16 et icons/24 (et, pour les images PNG, icons/32 et icons/48, utilisées sur un écran mis à l’échelle à 150 % et plus), chacune nommée pour ce qu’elle représente (tb-add-url.svg, cat-music.png…). Les fichiers SVG et PNG conservent leurs couleurs ; ceux de type -symbolic.svg et -symbolic.png, tels que nommés par GNOME et KDE, prennent la couleur du texte du thème. Une icône manquante dans l’ensemble est dessinée comme l’apparence classique la dessine. La liste complète des noms se trouve dans themeicons.rs (NEEDS).

Créer un thème

1. Affichage → Thème → Ouvrir le dossier des thèmes, et créez-y un nouveau fichier .toml (avec n’importe quel éditeur de texte).
2. Commencez par l’exemple ci-dessus : modifiez les couleurs de base, puis ajoutez des rôles et des tailles au fur et à mesure.
3. Sélectionnez-le dans Affichage → Thème, et regardez les deux versions : Affichage → Toujours sombre activé et désactivé. Vérifiez que le texte est lisible et que le marqueur de focus est visible dans les deux.

La page des thèmes du site web propose une invite que vous pouvez donner à un assistant IA, avec le format, chaque clé et les règles, pour écrire un thème pour vous à partir d’une description.

Partagez-le

Vous avez créé quelque chose qui pourrait plaire à d’autres ? Ouvrez une pull request qui l’ajoute à crates/app/assets/themes, avec :

• le fichier .toml, et son dossier d'icônes s'il en a un ;
• des captures d'écran de la fenêtre principale dans son côté clair et son côté sombre ;
• une SOURCES.txt à côté de chaque icône, indiquant son auteur et sa licence. Les icônes doivent être les vôtres ou sous une licence permettant à MDM de les partager (GPL-3.0), jamais copiées d'un autre programme.

Vous n’êtes pas sûr ? Présentez-le d’abord dans les discussions. Le fichier CONTRIBUTING.md explique le fonctionnement des pull requests ici.

Étapes suivantes

• Démarrer →
• Options →