Thema's

Een thema verandert het uiterlijk van MDM, maar de indeling blijft hetzelfde: dezelfde vensters, menu's en knoppen op dezelfde plaatsen, maar dan in andere kleuren, vormen en met andere pictogrammen. Elk thema heeft een lichte en een donkere kant.

Kies een thema

Open Beeld → Thema en klik op een thema: het hele venster verandert meteen, zonder opnieuw op te starten. Beeld → Ondersteuning voor donkere modus en Beeld → Altijd donker kiezen vervolgens de lichte of donkere kant, net als bij het klassieke uiterlijk (Donkere modus).

De ingebouwde thema's zijn Klassiek (MDM's eigen uiterlijk, de standaard), Systeemeigen (de accentkleur en het contrast van uw systeem), Hoog contrast, en de stijlthema's Metro, Adwaita, Breeze, Luna, Aero en Aqua, elk met eigen besturingsvormen en pictogrammen, en op Windows een eigen titelbalk. Aan de slag beschrijft elk thema; de Thema's-pagina van de website toont ze allemaal, licht en donker.

Waar themabestanden staan

Themabestanden die u maakt of downloadt, komen in de themamap van MDM. Beeld → Thema → Map met thema's openen opent deze (en maakt deze de eerste keer aan). Deze bevindt zich in de gegevensmap van MDM:

Binnen twee seconden verschijnt een nieuw bestand in Beeld → Thema, onder de ingebouwde thema's, met de name die het zichzelf geeft. Nadat u een bestand hebt bewerkt, kiest u het opnieuw in Beeld → Thema om de wijziging te zien.

Een thema kan één bestand (harbour.toml) zijn of een eigen map (harbour/theme.toml) als het pictogrammen bevat.

Beeld → Thema → Themabestand toevoegen… doet het voor u: kies een bestand en MDM kopieert het naar de themamap en gebruikt het meteen. Een bestand dat geen thema is, wordt niet toegevoegd en MDM legt uit waarom.

Base16- en pywal-kleurenschema's

Kleurenschema's die voor andere programma's zijn gemaakt, zijn ook thema's, zonder dat er iets hoeft te worden geconverteerd:

• Een Base16-schema, het .yaml-bestand waarin de Base16- en Base24-schema's komen: zowel de klassieke lay-out (scheme: en base00 tot base0F bovenaan) als de nieuwere (name: en een palette:-blok). Een Base24-schema wordt gelezen als de eerste 16 kleuren.
• pywal's colors.json, of het bestand van een ander programma in de vorm van pywal (wallust's pywal-sjabloon).

Voeg het toe met Beeld → Thema → Themabestand toevoegen…, of plaats het zelf in de themamap. Het verschijnt in Beeld → Thema onder de naam van het schema (name: of scheme:; pywal's is vernoemd naar de achtergrondafbeelding).

pywal zelf: zodra wal is uitgevoerd, toont Beeld → Thema pywal, rechtstreeks gelezen van waar pywal zijn kleuren schrijft: ~/.cache/wal/colors.json (op Windows %USERPROFILE%\.cache\wal\colors.json, waar winwal en pywal het schrijven; $PYWAL_CACHE_DIR of $XDG_CACHE_HOME/wal als u deze instelt). Kies het en MDM volgt uw achtergrondafbeelding: elke keer dat wal nieuwe kleuren schrijft, neemt MDM deze binnen twee seconden over. Het kijkt alleen naar de datum en grootte van het bestand, elke twee seconden, en alleen zolang pywal het thema is. Een kopie die is toegevoegd met Themabestand toevoegen… behoudt de kleuren die het had.

Een schema verandert alleen kleuren, in de klassieke weergave: elk venster, elke knop en elk menu blijft op zijn plaats. Een donker schema maakt MDM donker en een licht schema licht, ongeacht wat Beeld → Altijd donker zegt. De kleuren van het schema gaan naar waar ze hetzelfde betekenen:

Randen en de hover- en ingedrukte tinten worden hiervan gemengd, net als voor een themabestand's [seeds]. Tekst blijft leesbaar: tekst en secundaire tekst met een contrastverhouding van 4.5:1 of meer tegen elke achtergrond waarop ze staan (WCAG AA), het accent op 3:1. Een schema dat hieraan niet voldoet, krijgt die kleuren iets donkerder (lichter bij een donker schema) totdat ze voldoen; MDM's logboek vermeldt welke.

Om meer dan alleen kleuren te wijzigen, maakt u een themabestand dat het schema overneemt op basis van de bestandsnaam en toevoegt wat u wilt:

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

[sizes]
radius = 6

inherits = "pywal"werkt op dezelfde manier en volgt ook wal.

Het bestand

Een thema is één klein tekstbestand in TOML (of JSON, .json; of een kleurenschema, .yaml). Het benoemt alleen wat het verandert; al het andere komt van het thema dat het 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 — wat Beeld → Thema weergeeft; de bestandsnaam als er geen is.
• inherits — het thema waarvan het uwe begint: classic (de standaard als het wordt weggelaten), de id van een ingebouwd thema (metro, adwaita, breeze, luna, aero, aqua, high-contrast), of een ander themabestand in dezelfde map, op basis van de bestandsnaam zonder .toml. Een bestand dat een ander erft, kan op zijn beurt worden geërfd; een thema kan zichzelf niet erven.
• [seeds] — een handvol kleuren (background, surface, header, text, accent, selection, error, warning, success) die MDM over elk besturingselement verspreidt. [seeds.light] en [seeds.dark] geven elke kant zijn eigen.
• [colors] — rollen met één kleur (zoals window, accent of "segments.done") aan beide zijden; [light] en [dark] aan slechts één zijde. Een kleur is #rrggbb, of #rrggbbaa met transparantie. De rollen die een bestand instelt, winnen van de basiskleuren.
• [sizes] — hoekradii, randbreedtes, lettergroottes en rijhoogtes, in pixels.
• [controls] — de vorm van tekstvakken, selectievakjes, knoppen, voortgangsbalken, schuifbalken, de focusmarkering en de titelbalk.
• icons — color, mono (één kleur) of accent.
• contrast = "high" — versterkt elke rand- en tekstkleur bovenop de rest.

Elke kleurrol, grootte en besturingsstijl, met wat deze instelt, staat vermeld op de Thema's-pagina van de website (rechtstreeks gelezen uit MDM's eigen code, zodat het nooit afwijkt). De ingebouwde thema's zijn op dezelfde manier geschreven: lees ze op GitHub.

Een sleutel die MDM niet kent, of een waarde die het niet kan lezen, wordt overgeslagen en naar het logboek van MDM geschreven (de map logs naast de themamap), zodat een bestand dat voor een nieuwere MDM is gemaakt, nog steeds wordt geladen. Een bestand dat geen geldige TOML of JSON is, wordt niet geladen en het logboek vermeldt waarom. Een bestand dat is genoemd naar een ingebouwd thema (metro.toml) wordt overgeslagen: geef het uwe een eigen naam.

Pictogrammen

Een thema in een eigen map (harbour/theme.toml) kan zijn pictogrammen meebrengen in icons/16 en icons/24 (en, voor PNG-afbeeldingen, icons/32 en icons/48, gebruikt op een scherm geschaald naar 150% en meer), elk genoemd naar wat het toont (tb-add-url.svg, cat-music.png…). SVG- en PNG-bestanden behouden hun kleuren; -symbolic.svg en -symbolic.png-bestanden, zoals GNOME en KDE ze noemen, nemen de tekstkleur van het thema over. Een pictogram dat de set mist, wordt getekend zoals het klassieke uiterlijk het tekent. De volledige lijst met namen staat in themeicons.rs (NEEDS).

Maak een thema

1. Beeld → Thema → Map met thema's openen, en maak daar een nieuw .toml-bestand (elke teksteditor).
2. Begin met het bovenstaande voorbeeld: wijzig de kleuren van de basiskleuren en voeg vervolgens rollen en groottes toe naarmate u verdergaat.
3. Kies het in Beeld → Thema, en bekijk beide zijden: Beeld → Altijd donker aan en uit. Controleer of de tekst leesbaar is en de focusmarkering zichtbaar is in beide.

De Thema's-pagina van de website heeft een prompt die u aan een AI-assistent kunt geven, met het formaat, elke sleutel en de regels, om een thema voor u te schrijven op basis van een beschrijving.

Delen

Iets gemaakt dat anderen leuk zouden vinden? Open een pull request dat het toevoegt aan crates/app/assets/themes, met:

• het .toml-bestand, en de map met pictogrammen als die er is;
• schermafbeeldingen van het hoofdvenster in de lichte en donkere modus;
• een SOURCES.txt naast eventuele pictogrammen, met de naam van de ontwerper en de licentie. Pictogrammen moeten van uzelf zijn of onder een licentie vallen die MDM toestaat ze te delen (GPL-3.0), en mogen nooit van een ander programma zijn gekopieerd.

Nog niet zeker? Bespreek het eerst in de discussies. In CONTRIBUTING.md staat hoe pull requests hier werken.

Volgende stappen

• Aan de slag →
• Opties →