Todo tema é o gosto de outra pessoa. Trinta vêm com o Codeshot, cada um em variante clara e escura, e quase sempre há um que chega perto o bastante — mas perto o bastante é uma régua estranha para uma imagem que leva o seu nome.

No Mac você não precisa mais se contentar com isso. Ajustes → Temas te dá um tema seu: treze cores, uma pré-visualização que se redesenha conforme você escolhe e um arquivo que você pode entregar a alguém.

Onde fica

Abra os ajustes do Codeshot e vá até a aba Temas. À esquerda está a lista dos seus temas. + adiciona um, − remove o selecionado.

À direita há um trecho de exemplo no tema selecionado, um campo de nome abaixo dele e a lista de cores mais embaixo. Tudo nesse painel é ao vivo: mude uma cor e o exemplo acima se redesenha na hora.

Dois controles importam. O campo de nome renomeia o tema. Use This Theme faz dele o tema com que o app realmente desenha — editar um tema não muda para ele, e é esse o passo que as pessoas esquecem.

As treze cores

Um tema de sintaxe não são treze decisões de mesmo peso. Duas definem o clima e onze fazem o trabalho.

Cor O que ela cobre
Background O papel atrás do código
Plain Text Tudo o que o realce não reivindica: pontuação, parênteses, operadores
Keywords let, var, struct, func, return
Strings Texto entre aspas
Numbers Literais numéricos
Comments Comentários e documentação
Declared Types Tipos definidos no próprio trecho
Library Types Tipos que vêm do framework: String, View, CGFloat
Functions Nomes de funções e métodos
Members Propriedades e membros acessados em outra coisa
Variables Nomes de variáveis
Annotations Property wrappers e anotações, @State e companhia
Attributes Nomes de atributos, principalmente em linguagens de marcação

Você não precisa preencher as treze com cores diferentes. Os temas que se leem bem costumam usar quatro ou cinco tons e repeti-los: tipos e funções dividem um, palavras-chave e anotações dividem outro. Treze cores distintas não são um tema, são uma fruteira.

Um método que funciona

Comece por Background e Plain Text, e resolva esse par antes de mexer em qualquer outra coisa. Todas as outras decisões são julgadas contra eles, então escolhê-los por último significa reescolher tudo.

Depois ajuste Comments, e ajuste apagado. Comentários são o único token que deve recuar: são contexto, não código. Um tema em que os comentários gritam tanto quanto as palavras-chave se lê como ruído por melhor que seja o resto da paleta.

Em seguida palavras-chave, strings e números, que é onde cai a maior parte da cor num trecho real. Tipos, funções e membros depois, e os últimos podem muito bem repetir cores que você já escolheu.

Olhe a pré-visualização a cada passo, não só no fim. O painel existe para julgar a paleta em código de verdade — seletores de cor mentem, código não.

O que vale saber antes de escolher

Contraste não é opcional. Imagens de código são reduzidas num feed, vistas num celular sob luz do dia e recomprimidas pela plataforma onde você publicou. Uma paleta sutil e de baixo contraste que parece refinada em tamanho cheio fica ilegível quando chega em alguém. Se uma cor é difícil de ler na pré-visualização, no feed ela já se foi.

Evite fundos pretos puros, a menos que você exporte com transparência ou sobre um fundo escuro. Contra um papel de parede claro, #000000 se lê como um buraco. Os bons temas escuros ficam entre #1F1F24 e #282C34 exatamente por isso.

Comentários e texto simples precisam diferir. Se ficarem com brilho parecido, prosa e código viram um bloco cinza só e a forma do trecho desaparece.

Copie o seu editor, se quiser, mas confira fora de contexto. Um tema do Xcode é afinado para uma janela grande numa mesa. As mesmas cores numa imagem de 1000 pixels de largura no celular de outra pessoa são outra história, e normalmente pedem um pouco mais de contraste que o original.

Compartilhar um tema

O menu ⋯ no rodapé da lista de temas importa e exporta arquivos de tema.

Exportar grava o tema como arquivo; importar lê um de volta. É assim que um tema vai do seu Mac para o seu outro Mac, para um backup ou para alguém do time — e é isso que torna uma paleta da casa viável para mais de uma pessoa.

Quando os trinta incluídos são a melhor resposta

Montar um tema compensa quando você produz imagens com regularidade e quer que elas pareçam um conjunto: uma série de posts, a documentação de um produto, os slides de uma palestra.

Para um trecho avulso, não. Os trinta que vêm com o app são todos bem desenhados, todos têm claro e escuro, e estão a dois cliques. Compare lado a lado e fique com o que combina com o trecho.

O editor está lá para o caso em que você já fez isso e a resposta ainda era quase.