Temas

Um tema altera o aspeto do MDM e mantém tudo no seu lugar: as mesmas janelas, menus e botões nos mesmos locais, desenhados com outras cores, formas e ícones. Cada tema tem um lado claro e um lado escuro.

Escolher um

Abra Ver → Tema e clique num tema: toda a janela muda de uma vez, sem necessidade de reiniciar. Ver → Suporte para Modo Escuro e Ver → Sempre escuro escolhem o lado claro ou escuro, tal como para o aspeto clássico (Modo escuro).

Os temas incorporados são Clássico (o aspeto próprio do MDM, o predefinido), Nativo (a cor de destaque e o contraste do seu sistema), Alto contraste, e os temas de estilo Metro, Adwaita, Breeze, Luna, Aero e Aqua, cada um com as suas próprias formas e ícones de controlo, e no Windows a sua própria barra de título. Primeiros passos descreve cada um; a página de Temas do site mostra-os todos, claros e escuros.

Onde ficam os ficheiros de tema

Os ficheiros de tema que criar ou transferir ficam na pasta de temas do MDM. Ver → Tema → Abrir pasta de temas abre-a (e cria-a pela primeira vez). Fica na pasta de dados do MDM:

Em dois segundos, um novo ficheiro aparece em Ver → Tema, abaixo dos temas incorporados, pelo name que se atribui. Depois de editar um ficheiro, selecione-o novamente em Ver → Tema para ver a alteração.

Um tema pode ser um único ficheiro (harbour.toml) ou uma pasta própria (harbour/theme.toml) quando inclui ícones.

Ver → Tema → Adicionar um ficheiro de tema… faz isso por si: escolha um ficheiro em qualquer lugar e o MDM copia-o para a pasta de temas e usa-o de imediato. Um ficheiro que não seja um tema fica de fora e o MDM explica porquê.

Esquemas de cores Base16 e pywal

Os esquemas de cores feitos para outros programas também são temas, sem necessidade de conversão:

• Um esquema Base16, o ficheiro .yaml em que vêm os esquemas Base16 e Base24: tanto o esquema clássico (scheme: e base00 a base0F no topo) como o mais recente (name: e um bloco palette:). Um esquema Base24 é lido como as suas primeiras 16 cores.
• O colors.json do pywal, ou o ficheiro de qualquer programa no formato do pywal (o modelo pywal do wallust).

Adicione-o com Ver → Tema → Adicionar um ficheiro de tema…, ou coloque-o na pasta de temas manualmente. Aparece em Ver → Tema com o nome do esquema (name: ou scheme:; o do pywal tem o nome do papel de parede).

O próprio pywal: depois de wal ter sido executado, Ver → Tema lista pywal, lido diretamente de onde o pywal escreve as suas cores: ~/.cache/wal/colors.json (no Windows %USERPROFILE%\.cache\wal\colors.json, onde o winwal e o pywal o escrevem; $PYWAL_CACHE_DIR ou $XDG_CACHE_HOME/wal quando os define). Escolha-o e o MDM segue o seu papel de parede: cada vez que wal escreve novas cores, o MDM as assume em dois segundos. Verifica apenas a data e o tamanho do ficheiro, a cada dois segundos, e apenas enquanto o pywal é o tema. Uma cópia adicionada com Adicionar um ficheiro de tema… mantém as cores que tinha.

Um esquema muda apenas as cores, no visual clássico: todas as janelas, botões e menus permanecem onde estavam. Um esquema escuro torna o MDM escuro e um claro torna-o claro, independentemente do que Ver → Sempre escuro diga. As cores do esquema vão para onde significam o mesmo:

As bordas e os tons de passar o rato e de pressionar são misturados a partir destes, como para um ficheiro de tema [seeds]. O texto permanece legível: texto e texto secundário com uma proporção de 4,5:1 ou mais contra todos os fundos em que se encontram (WCAG AA), o destaque em 3:1. Um esquema que não atinja isso tem essas cores ligeiramente mais escuras (mais claras num esquema escuro) até que passem; o registo do MDM indica quais.

Para mudar mais do que cores, crie um ficheiro de tema que herde o esquema pelo nome do ficheiro e adicione o que quiser:

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

[sizes]
radius = 6

inherits = "pywal"funciona da mesma forma e também segue wal.

O ficheiro

Um tema é um pequeno ficheiro de texto em TOML (ou JSON, .json; ou um esquema de cores, .yaml). Nomeia apenas o que muda; tudo o resto vem do tema que 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 — o que Ver → Tema lista; o nome do ficheiro quando não há nenhum.
• inherits — o tema de onde o seu começa: classic (o predefinido quando omitido), um ID de tema incorporado (metro, adwaita, breeze, luna, aero, aqua, high-contrast), ou outro ficheiro de tema na mesma pasta, pelo seu nome de ficheiro sem .toml. Um ficheiro que herda outro pode ser herdado por sua vez; um tema não pode herdar-se a si próprio.
• [seeds] — um punhado de cores (background, surface, header, text, accent, selection, error, warning, success) que o MDM espalha por todos os controlos. [seeds.light] e [seeds.dark] dão a cada lado o seu próprio.
• [colors] — funções de cor única (como window, accent ou "segments.done") em ambos os lados; [light] e [dark] apenas num lado. Uma cor é #rrggbb, ou #rrggbbaa com transparência. As funções que um ficheiro define prevalecem sobre as suas sementes.
• [sizes] — raios de canto, larguras de borda, tamanhos de letra e alturas de linha, em píxeis.
• [controls] — a forma de caixas de texto, caixas de verificação, botões, barras de progresso, barras de deslocamento, a marca de foco e a barra de título.
• icons — color, mono (uma cor) ou accent.
• contrast = "high" — reforça todas as cores de borda e texto por cima do resto.

Cada função de cor, tamanho e estilo de controlo, com o que define, está listada na página de Temas do site (lida a partir do próprio código do MDM, para que nunca se desvie). Os temas incorporados são escritos da mesma forma: leia-os no GitHub.

Uma chave que o MDM não conhece, ou um valor que não consegue ler, é ignorada e escrita no registo do MDM (a pasta logs ao lado da pasta de temas), para que um ficheiro feito para um MDM mais recente ainda seja carregado. Um ficheiro que não seja TOML ou JSON válido não é carregado, e o registo indica o motivo. Um ficheiro com o nome de um tema incorporado (metro.toml) é ignorado: dê ao seu um nome próprio.

Ícones

Um tema numa pasta própria (harbour/theme.toml) pode trazer os seus ícones em icons/16 e icons/24 (e, para imagens PNG, icons/32 e icons/48, usados num ecrã com escala de 150 % e mais), cada um nomeado para o que mostra (tb-add-url.svg, cat-music.png…). Os ficheiros SVG e PNG mantêm as suas cores; os ficheiros -symbolic.svg e -symbolic.png, como o GNOME e o KDE os nomeiam, assumem a cor do texto do tema. Um ícone que o conjunto não tem é desenhado como o aspeto clássico o desenha. A lista completa de nomes está em themeicons.rs (NEEDS).

Criar um

1. Ver → Tema → Abrir pasta de temas, e crie um novo ficheiro .toml lá (qualquer editor de texto).
2. Comece pelo exemplo acima: altere as cores das sementes e, em seguida, adicione funções e tamanhos à medida que avança.
3. Selecione-o em Ver → Tema e observe ambos os lados: Ver → Sempre escuro ativado e desativado. Verifique se o texto é legível e a marca de foco visível em ambos.

A página de Temas do site tem um prompt que pode dar a um assistente de IA, com o formato, todas as chaves e as regras, para escrever um tema para si a partir de uma descrição.

Partilhe-o

Fez algo que outros gostariam? Abra um pull request que o adicione a crates/app/assets/themes, com:

• o ficheiro .toml e a sua pasta de ícones, se tiver uma;
• capturas de ecrã da janela principal nos seus lados claro e escuro;
• uma SOURCES.txt junto a quaisquer ícones, indicando quem os desenhou e sob que licença. Os ícones devem ser seus ou estar sob uma licença que permita ao MDM partilhá-los (GPL-3.0), nunca copiados de outro programa.

Ainda não tem a certeza? Mostre-o primeiro nas discussões. O ficheiro CONTRIBUTING.md explica como funcionam os pedidos de pull aqui.

Próximos passos

• Primeiros passos →
• Opções →