Pular para conteúdo

Coloração de sintaxe

O editor colore o código-fonte de acordo com a linguagem, tornando a estrutura fácil de ler num relance. A coloração é fornecida pelo Lexilla, então uma ampla gama de linguagens já vem suportada.

Como funciona

Um colorizador identifica a linguagem e marca cada token (palavra-chave, string, comentário, número, tipo, …); um tema associa cada categoria de token a uma cor. Como todas as linguagens falam o mesmo conjunto de categorias, trocar o tema recolore todas elas de uma vez.

Escolhendo a linguagem

A linguagem é detectada automaticamente quando você abre um arquivo, nesta ordem:

  1. Uma substituição por extensão definida por você em Preferências ▸ Coloração de sintaxe.
  2. Uma correspondência exata de nome de arquivo (por exemplo, Makefile, .gitignore).
  3. A extensão do arquivo.
  4. Um marcador na primeira linha (por exemplo, um shebang #! ou <?xml).

Use o menu Linguagem para substituir a linguagem detectada no documento atual quando a escolha automática não for a que você quer.

Configurações

Preferências ▸ Coloração de sintaxe permite que você:

  • Escolha o tema ativo (e, com o Editor de temas, crie ou edite temas).
  • Ative ou desative categorias inteiras de tokens (por exemplo, desligue a coloração de comentários) para que voltem à cor de texto padrão.
  • Defina substituições por extensão para forçar um tipo de arquivo a uma linguagem específica.
  • Defina o tamanho máximo de arquivo a colorir, em KB. O padrão é 16384 (16 MB): acima disso um arquivo abre como texto simples, e a dobra de código — que tira seus níveis da mesma passagem — vai junto. A coloração é calculada primeiro para a página visível e depois, em segundo plano, para o resto do arquivo, então mesmo um arquivo de vários megabytes abre sem pausa; digitar nele também não é afetado, porque o editor recolore apenas ao redor da alteração. Defina 0 para remover o limite por completo. O limite existe como salvaguarda de memória: o analisador léxico guarda dados de estilo e de dobra para cada byte que coloriu, então em arquivos muito grandes é isso que o teto limita — não a velocidade.

Coloração e inteligência de código são independentes

Ultrapassar o limite de tamanho — ou desligar a coloração por completo — não desativa mais o servidor de linguagem para aquele arquivo. Ele mantém seus diagnósticos, sua navegação e seu autocompletar; apenas não é pintado.

Adicione suas próprias linguagens e temas

Colorizadores e temas são simples arquivos JSON que você pode editar ou acrescentar sem recompilar — coloque-os no seu diretório de configuração de usuário e eles substituem ou ampliam o conjunto que vem de fábrica. O arquivo de colorizador também define as extensões, as palavras-chave e o mapeamento de estilos de token de cada linguagem. Um arquivo de tema pode trazer um bloco attribution opcional (autores, copyright, licença, aviso); o editor o ignora na coloração e o mantém inalterado quando salva o tema.