Temi

Un tema cambia l'aspetto di MDM, ma mantiene tutto al suo posto: le stesse finestre, menu e pulsanti nelle stesse posizioni, disegnati con altri colori, forme e icone. Ogni tema ha un lato chiaro e uno scuro.

Scegli un tema

Apri Visualizza → Tema e fai clic su un tema: l'intera finestra cambia subito, senza bisogno di riavviare. Visualizza → Supporto modalità scura e Visualizza → Sempre scuro scelgono poi il lato chiaro o scuro, come per l'aspetto classico (Modalità scura).

I temi integrati sono Classico (l'aspetto predefinito di MDM), Nativo (il colore principale e il contrasto del sistema), Contrasto elevato e i temi di stile Metro, Adwaita, Breeze, Luna, Aero e Aqua, ognuno con le proprie forme e icone dei controlli e, su Windows, la propria barra del titolo. Per iniziare descrive ciascuno; la pagina dei temi del sito web li mostra tutti, chiari e scuri.

Dove vanno i file dei temi

I file dei temi che crei o scarichi vanno nella cartella dei temi di MDM. Visualizza → Tema → Apri la cartella dei temi la apre (e la crea la prima volta). Si trova nella cartella dei dati di MDM:

Entro due secondi un nuovo file appare in Visualizza → Tema, sotto i temi integrati, con il name che si dà. Dopo aver modificato un file, selezionalo di nuovo in Visualizza → Tema per vedere la modifica.

Un tema può essere un singolo file (harbour.toml) o una propria cartella (harbour/theme.toml) quando include icone.

Visualizza → Tema → Aggiungi un file tema… lo fa per te: scegli un file ovunque e MDM lo copia nella cartella dei temi e lo usa subito. Un file che non è un tema resta fuori e MDM dice perché.

Combinazioni di colori Base16 e pywal

Le combinazioni di colori create per altri programmi sono anch'esse temi, senza bisogno di conversioni:

• Una combinazione Base16, il file .yaml in cui sono contenute le combinazioni Base16 e Base24: sia il layout classico (scheme: e da base00 a base0F in alto) sia quello più recente (name: e un blocco palette:). Una combinazione Base24 viene letta come le sue prime 16 colori.
• Il file colors.json di pywal, o il file di qualsiasi programma nella forma di pywal (il modello pywal di wallust).

Aggiungilo con Visualizza → Tema → Aggiungi un file tema…, oppure mettilo tu stesso nella cartella dei temi. Appare in Visualizza → Tema sotto il nome della combinazione (name: o scheme:; quello di pywal prende il nome dallo sfondo).

pywal stesso: una volta che wal è stato eseguito, Visualizza → Tema elenca pywal, letto direttamente da dove pywal scrive i suoi colori: ~/.cache/wal/colors.json (su Windows %USERPROFILE%\.cache\wal\colors.json, dove winwal e pywal lo scrivono; $PYWAL_CACHE_DIR o $XDG_CACHE_HOME/wal quando li imposti). Selezionalo e MDM seguirà il tuo sfondo: ogni volta che wal scrive nuovi colori, MDM li riprende entro due secondi. Controlla solo la data e la dimensione del file, ogni due secondi, e solo mentre pywal è il tema. Una copia aggiunta con Aggiungi un file tema… mantiene i colori che aveva.

Una combinazione cambia solo i colori, nell'aspetto classico: ogni finestra, pulsante e menu resta dove era. Una combinazione scura rende MDM scuro e una chiara lo rende chiaro, indipendentemente da ciò che dice Visualizza → Sempre scuro. I colori della combinazione vanno dove significano la stessa cosa:

I bordi e le sfumature al passaggio del mouse e alla pressione sono miscelati da questi, come per il [seeds] di un file tema. Il testo resta leggibile: testo e testo secondario con un rapporto di 4.5:1 o più contro ogni sfondo su cui si trovano (WCAG AA), l'accento a 3:1. Una combinazione che non rispetta questo ha quei colori leggermente più scuri (più chiari su una combinazione scura) finché non passano; il log di MDM indica quali.

Per cambiare più dei colori, crea un file tema che erediti la combinazione tramite il suo nome file e aggiunga ciò che desideri:

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

[sizes]
radius = 6

inherits = "pywal"funziona allo stesso modo e segue anche wal.

Il file

Un tema è un piccolo file di testo in TOML (o JSON, .json; o una combinazione di colori, .yaml). Nomina solo ciò che cambia; tutto il resto proviene dal tema che 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 — ciò che Visualizza → Tema elenca; il nome del file quando non ce n'è uno.
• inherits — il tema da cui il tuo parte: classic (il predefinito se omesso), l'ID di un tema integrato (metro, adwaita, breeze, luna, aero, aqua, high-contrast) o un altro file di tema nella stessa cartella, con il suo nome file senza .toml. Un file che eredita un altro può essere ereditato a sua volta; un tema non può ereditare se stesso.
• [seeds] — una manciata di colori (background, surface, header, text, accent, selection, error, warning, success) che MDM distribuisce su ogni controllo. [seeds.light] e [seeds.dark] danno a ogni lato il suo.
• [colors] — ruoli di colore singolo (come window, accent o "segments.done") su entrambi i lati; [light] e [dark] su un solo lato. Un colore è #rrggbb, o #rrggbbaa con trasparenza. I ruoli impostati da un file prevalgono sui suoi semi.
• [sizes] — raggi degli angoli, larghezze dei bordi, dimensioni dei caratteri e altezze delle righe, in pixel.
• [controls] — la forma di caselle di testo, caselle di controllo, pulsanti, barre di avanzamento, barre di scorrimento, il segno di messa a fuoco e la barra del titolo.
• icons — color, mono (un colore) o accent.
• contrast = "high" — rafforza ogni bordo e colore del testo sopra il resto.

Ogni ruolo di colore, dimensione e stile di controllo, con ciò che imposta, è elencato nella pagina dei temi del sito web (letta dal codice di MDM, quindi non si discosta mai). I temi integrati sono scritti allo stesso modo: leggili su GitHub.

Una chiave che MDM non conosce, o un valore che non può leggere, viene saltata e scritta nel log di MDM (la cartella logs accanto alla cartella dei temi), in modo che un file creato per un MDM più recente si carichi comunque. Un file che non è un TOML o JSON valido non si carica, e il log dice perché. Un file con lo stesso nome di un tema integrato (metro.toml) viene ignorato: dai al tuo un nome proprio.

Icone

Un tema in una propria cartella (harbour/theme.toml) può portare le sue icone in icons/16 e icons/24 (e, per le immagini PNG, icons/32 e icons/48, usate su uno schermo scalato al 150% e oltre), ognuna nominata per ciò che mostra (tb-add-url.svg, cat-music.png…). I file SVG e PNG mantengono i loro colori; quelli -symbolic.svg e -symbolic.png, come li chiamano GNOME e KDE, assumono il colore del testo del tema. Un'icona che il set non ha viene disegnata come la disegna l'aspetto classico. L'elenco completo dei nomi è in themeicons.rs (NEEDS).

Creane uno

1. Visualizza → Tema → Apri la cartella dei temi, e crea un nuovo file .toml lì (qualsiasi editor di testo).
2. Inizia dall'esempio sopra: cambia i colori dei semi, poi aggiungi ruoli e dimensioni man mano.
3. Selezionalo in Visualizza → Tema, e guarda entrambi i lati: Visualizza → Sempre scuro attivo e disattivo. Verifica che il testo sia leggibile e il segno di messa a fuoco visibile in entrambi.

La pagina dei temi del sito web ha un suggerimento che puoi dare a un assistente AI, con il formato, ogni chiave e le regole, per scrivere un tema per te da una descrizione.

Condividilo

Hai creato qualcosa che piacerebbe ad altri? Apri una pull request che lo aggiunga a crates/app/assets/themes, con:

• il file .toml e la sua cartella di icone, se ne ha una;
• screenshot della finestra principale nel suo lato chiaro e nel suo lato scuro;
• una SOURCES.txt accanto a ogni icona, che indichi chi l'ha disegnata e con quale licenza. Le icone devono essere tue o sotto una licenza che permetta a MDM di condividerle (GPL-3.0), mai copiate da un altro programma.

Non sei ancora sicuro? Prima mostralo nelle discussioni. CONTRIBUTING.md spiega come funzionano le pull request qui.

Passi successivi

• Per iniziare →
• Opzioni →