↓ Ir para o conteúdo principal
Rogerio de Queiroz Junior

Temas

Versão documentada: v0.5.1

Tradução da página original em inglês, que é a referência se algo estiver diferente.

Tabela de conteúdos

As cores da TUI vêm do tema escolhido em theme: de config.yaml, aplicado na inicialização. Os temas incluídos e seus IDs estão na referência.

Temas incluídos
#

A família padrão é SP Night, inspirada em São Paulo. As variantes sp-night, sp-night-garoa e sp-night-jaragua incluem toda a paleta original e todos os papéis semânticos, sem adaptação. IDs usados até v0.2 (noite, garoa, jaragua) continuam funcionando em theme: e extends:.

Também há temas da comunidade com paletas oficiais: Tokyo Night, Dracula, Gruvbox, Nord, Rosé Pine, Kanagawa, Everforest e One Dark. Se uma cor original tornar texto ilegível (contraste abaixo de 3:1 contra fundo ou seleção), o papel usa outra da mesma paleta. Se nenhuma passar, o arquivo acrescenta uma cor derivada com comentário.

Para combinar terminal e editor, o SP Night tem versões para outras ferramentas em sp-night.github.io.

Seu próprio tema
#

Crie ~/.config/lazyagents/themes/<id>.yaml e use theme: <id>. Escreva só as mudanças: o restante vem de extends, cujo padrão é sp-night.

# ~/.config/lazyagents/themes/my-dracula.yaml
label: Meu Dracula
extends: dracula
palette:
  purple: "#caa9fa"        # muda papéis herdados que usam purple
ui:
  accent: "#ff79c6"        # destaque: aba ativa e bordas focadas
  bg: "#1e1f29"
diagnostic:
  ok: "#50fa7b"

Formato:

CampoSignificado
idopcional; se presente, deve coincidir com o nome do arquivo
label, descriptionnome do tema e descrição curta
appearancedark ou light; informativo, não muda a renderização
extendstema herdado; padrão sp-night
palettecores nomeadas, name: "#rrggbb"
ui, diagnostic, git, syntax, ansigrupos de papéis; cada valor é hexadecimal entre aspas ou nome da paleta

Os nomes são resolvidos após a herança: mudar uma cor nomeada altera todos os papéis herdados que a usam.

A lista completa de papéis e o que desenham está em internal/tui/theme/README.md. Os arquivos incluídos são exemplos completos.

Regras
#

  • Não reutilize o ID de um tema incluído; use extends para modificá-lo.
  • Arquivos inválidos (hexadecimal incorreto, papel desconhecido, ciclo de herança) são ignorados com aviso; os demais carregam.
  • Avisos aparecem na saída de erro ao sair da TUI ou antes da saída de um comando.

Plugins e temas
#

Plugins recebem o tema ativo ao iniciar, com tokens e papéis em hexadecimal, para combinar sua aba. Veja o protocolo.

Contribuir um tema
#

Um novo tema incluído é um YAML completo em internal/tui/theme/themes/: paleta e todos os papéis, sem extends. Papéis de texto devem ter contraste de ao menos 3:1 sobre ui.bg e ui.selection; go test ./internal/tui/theme/ verifica. Acrescente a licença da paleta em LICENSES-themes.md e execute go test ./docs -update para atualizar a referência.

Licenças
#

As paletas são MIT, exceto Tokyo Night (Apache-2.0). Avisos: LICENSE-SP-Night e LICENSES-themes.md.