Temas

Um tema muda a aparência do MDM e mantém tudo no 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 escuro.

Escolha um

Abra Exibir → Tema e clique em um tema: a janela inteira muda de uma vez, sem precisar reiniciar. Exibir → Suporte ao Modo Escuro e Exibir → Sempre escuro então escolhem seu lado claro ou escuro, como na aparência clássica (Modo escuro).

Os temas integrados são Clássico (a aparência própria do MDM, o padrão), 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 suas próprias formas e ícones de controle, e no Windows sua própria barra de título. Primeiros passos descreve cada um; a página de Temas do site mostra todos, claros e escuros.

Onde ficam os arquivos de tema

Os arquivos de tema que você cria ou baixa vão para a pasta de temas do MDM. Exibir → Tema → Abrir pasta de temas a abre (e a cria na primeira vez). Ela fica na pasta de dados do MDM:

Em dois segundos, um novo arquivo aparece em Exibir → Tema, abaixo dos temas integrados, pelo name que ele mesmo se dá. Depois de editar um arquivo, selecione-o novamente em Exibir → Tema para ver a mudança.

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

O caminho Exibir → Tema → Adicionar um arquivo de tema… faz isso por você: escolha um arquivo em qualquer lugar, e o MDM o copia para a pasta de temas e o usa imediatamente. Um arquivo que não é um tema fica de fora, e o MDM informa o motivo.

Esquemas de cores Base16 e pywal

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

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

Adicione-o com Exibir → Tema → Adicionar um arquivo de tema…, ou coloque-o você mesmo na pasta de temas. Ele aparece em Exibir → Tema com o nome do esquema (name: ou scheme:; o do pywal é nomeado a partir do papel de parede).

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

Um esquema muda apenas as cores, na aparência clássica: todas as janelas, botões e menus permanecem onde estavam. Um esquema escuro torna o MDM escuro e um claro o torna claro, independentemente do que Exibir → Sempre escuro disser. As cores do esquema vão para onde significam o mesmo:

Bordas e os tons de foco e pressionado são misturados a partir desses, assim como para o [seeds] de um arquivo de tema. O texto permanece legível: texto e texto secundário com proporção de 4,5:1 ou mais contra cada plano de fundo em que estão (WCAG AA), o destaque em 3:1. Um esquema que não atenda a isso tem essas cores movidas um pouco mais escuras (mais claras em um esquema escuro) até que passem; o log do MDM informa quais.

Para mudar mais do que cores, crie um arquivo de tema que herde o esquema pelo nome do arquivo e adicione o que você 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 arquivo

Um tema é um pequeno arquivo de texto em TOML (ou JSON, .json; ou um esquema de cores, .yaml). Ele nomeia apenas o que muda; todo o resto vem do tema que ele 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 Exibir → Tema lista; o nome do arquivo quando não há nenhum.
• inherits — o tema do qual o seu começa: classic (o padrão quando omitido), o ID de um tema integrado (metro, adwaita, breeze, luna, aero, aqua, high-contrast), ou outro arquivo de tema na mesma pasta, pelo nome do arquivo sem .toml. Um arquivo que herda outro pode ser herdado por sua vez; um tema não pode herdar a si mesmo.
• [seeds] — algumas cores (background, surface, header, text, accent, selection, error, warning, success) que o MDM espalha por todos os controles. [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] em apenas um lado. Uma cor é #rrggbb, ou #rrggbbaa com transparência. As funções que um arquivo define prevalecem sobre suas sementes.
• [sizes] — raios de canto, larguras de borda, tamanhos de fonte e alturas de linha, em pixels.
• [controls] — a forma de caixas de texto, caixas de seleção, botões, barras de progresso, barras de rolagem, a marca de foco e a barra de título.
• icons — color, mono (uma cor) ou accent.
• contrast = "high" — fortalece todas as cores de borda e texto além do resto.

Cada função de cor, tamanho e estilo de controle, com o que define, está listada na página de Temas do site (lida do próprio código do MDM, para que nunca se desvie). Os temas integrados 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 log do MDM (a pasta logs ao lado da pasta de temas), para que um arquivo feito para um MDM mais recente ainda seja carregado. Um arquivo que não é um TOML ou JSON válido não é carregado, e o log informa o motivo. Um arquivo nomeado como um tema integrado (metro.toml) é ignorado: dê ao seu um nome próprio.

Ícones

Um tema em uma pasta própria (harbour/theme.toml) pode trazer seus ícones em icons/16 e icons/24 (e, para imagens PNG, icons/32 e icons/48, usadas em uma tela escalada para 150% e mais), cada um nomeado para o que mostra (tb-add-url.svg, cat-music.png…). Arquivos SVG e PNG mantêm suas cores; os -symbolic.svg e -symbolic.png, como GNOME e KDE os nomeiam, assumem a cor do texto do tema. Um ícone que o conjunto não possui é desenhado como a aparência clássica o desenha. A lista completa de nomes está em themeicons.rs (NEEDS).

Crie um

1. Exibir → Tema → Abrir pasta de temas, e crie um novo arquivo .toml lá (qualquer editor de texto).
2. Comece pelo exemplo acima: mude as cores das sementes, depois adicione funções e tamanhos conforme avança.
3. Selecione-o em Exibir → Tema, e olhe para ambos os lados: Exibir → Sempre escuro ligado e desligado. 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 você pode dar a um assistente de IA, com o formato, todas as chaves e as regras, para escrever um tema para você a partir de uma descrição.

Compartilhe

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

• o arquivo .toml, e sua pasta de ícones, se houver;
• capturas de tela da janela principal em seu lado claro e escuro;
• uma SOURCES.txt ao lado de qualquer ícone, informando quem o desenhou e sob qual licença. Os ícones devem ser seus ou estar sob uma licença que permita ao MDM compartilhá-los (GPL-3.0), nunca copiados de outro programa.

Ainda não tem certeza? Discuta primeiro. O arquivo CONTRIBUTING.md explica como os pull requests funcionam aqui.

Próximos passos

• Primeiros passos →
• Opções →