Apêndice B: Opções do Arquivo de Preferências
Abaixo vamos detalhar todas as opções de configuração de preferências do Sublime Text:
color_scheme
Nome do esquema de cores que será utilizado para exibir o conteúdo da área de texto
font_face
Nome da fonte utilizada para mostrar o texto
font_size
Tamanho da fonte utilizada para mostrar o texto
font_options
Configura alguns detalhes de como as fontes são mostradas na área de texto, tais como permitir ou não texto em itálico ou negrito, o tipo de antialias, entre outros. As opções válidas são
no_bold
,no_italic
,no_antialias
,gray_antialias
,subpixel_antialias
,no_round
(apenas para OS X),gdi
(apenas para Windows) edirectwrite
(apenas para Windows)
word_separators
String contendo a lista de caracteres que o Sublime Text deve considerar como delimitadores ou separadores de palavras. A lista padrão é “
./\\()\"'-:,.;<>~!@#$%^&*|+=[]{}`~?
”.
line_numbers
Habilita ou desabilita a exibição dos números das linhas na margem. Opções válidas: true ou false.
gutter
Habilita ou desabilita a exibição da margem. Opções válidas: true ou false.
margin
Determina a largura, em caracteres, do espaço entre a margem e o texto. O valor padrão é 4.
fold_buttons
Habilita ou desabilita as exibição dos botões de dobra de código na margem. Esses botões tem a forma de pequenos triângulos e permitem exibir ou esconder trechos de código - como o corpo da definição de uma função, por exemplo - ao clicarmos neles. Opções válidas: true ou false.
fade_fold_buttons
Esconde os botões de dobra a menos que o mouse esteja sobre a margem. Opções válidas: true ou false.
rulers
Lista de números que indicam em quais colunas da área de edição devem ser mostradas linhas verticais. Por exemplo, para mostrar linhas nas colunas 66, 80 e 100 o valor desse atributo deve ser modificado para
[66, 80, 100]
. Esta configuração é útil quando queremos seguir convenções de código ou melhores práticas de diagramação de texto. O valor padrão é[]
.
spell_check
Habilita ou desabilita a verificação ortográfica. Opções válidas: true ou false.
tab_size
Número que indica a quantidade de espaços correspondentes à largura de uma parada de tabulação (tab stop). O valor padrão é
4
.
translate_tabs_to_spaces
Uma vez habilitada, esta opção insere espaços quando a tecla Tab é pressionada. Opções válidas: true ou false.
use_tab_stops
Quando a opção
translate_tabs_to_spaces
estiver habilitada, esta opção fará com que as teclasTab
eBackspace
respectivamente insiram ou removam os espaços até a próxima parada de tabulação. Opções válidas: true ou false.
detect_indentation
Habilita ou desabilita a detecção de tabs ou espaços ao carregar um arquivo. Opções válidas: true ou false.
auto_indent
Quando esta opção está habilitada, o Sublime Text aplica as indentações de código automaticamente ao pressionar
Enter
, de acordo com a sintaxe do arquivo. Opções válidas: true ou false.
smart_indent
Incrementa o funcionamento da opção
auto_indent
fazendo com que a linha seguinte a um comando que deve ser sucedido por um bloco de comandos seja automaticamente indentada, como após umif
na linguagem C, por exemplo. Esta opção requer queauto_indent
seja true. Opções válidas: true ou false.
indent_to_bracket
Quando esta opção está habilitada, o Sublime Text adiciona espaços até a coluna onde está o primeiro parênteses aberto. Esta opção é útil para alinhar em linhas separadas os parâmetros de uma função que aceita muitos argumentos, como por exemplo:
somar_numeros(primeiro_numero, segundo_numero, terceiro_numero)Para funcionar, a opção
auto_indent
deve estar habilitada.
trim_automatic_white_space
Elimina o espaço em branco inserido pelo
auto_indent
quando movemos o cursor para fora da linha. Opções válidas são true ou false.
word_wrap
Quando esta opção está habilitada, a barra de rolagem horizontal é desabilitada, fazendo com que as linhas que excedem a largura da janela do Sublime Text sejam visualmente quebradas. As opções válidas são true, false ou “auto”. No caso da opção “auto”, a quebra de linha é desabilitada quando o arquivo editado for de código-fonte e habilitada caso contrário.
wrap_width
Indica em qual coluna ocorrerá a quebra visual de linha. Se o valor desse atributo for 0, a largura da linha acompanhará a largura da janela. O valor padrão é 0.
indent_subsequent_lines
Indica se as linhas seguintes a uma quebra de linha manual devem ser indentadas no mesmo nível que a anterior. Opções válidas: true ou false.
draw_centered
Quando esta opção está habilitada, o texto é mostrado no centro da janela, ao invés de alinhado à esquerda, como é o padrão. Opções válidas: true ou false.
auto_match_enabled
Esta opção controla o pareamento automático de aspas, parênteses, chaves e similares. É ela que faz com que o “fecha aspas” ou “fecha parênteses” apareça automaticamente ao abri-los. Opções válidas: true ou false.
dictionary
Indica o arquivo no qual está armazenada a lista de palavras (dicionário) utilizadas para a verificação ortográfica. O valor padrão é “Packages/Language - English/en_US.dic”
spelling_selector
Define quais são os escopos nos quais as verificação ortográfica deve procurar por erros. Essa opção é útil pois evita que sejam apontados erros ortográficos em tipos ou trechos de arquivos nos quais não há necessidade, tais como código-fonte de programas.
draw_minimap_border
Habilita ou desabilita a exibição de uma borda no minimapa, quando este está ativo. O valor padrão é false.
always_show_minimap_viewport
Habilita ou desabilita a exibição permanente no minimapa do destaque da porção do arquivo que está sendo mostrada na janela. Quando esse atributo está desabilitado, o destaque só é mostrado quando colocamos o cursor do mouse em cima do minimapa. O valor padrão é false.
highlight_line
Quando habilitado, destaca com uma tonalidade de cor diferente a linha na qual o cursor está. O valor padrão é false.
caret_style
Define o estilo do cursor. Os valores possíveis são “smooth”, “phase”, “blink” e “solid”.
caret_extra_top
Define um tamanho adicional para a parte superior do cursor.
caret_extra_bottom
Define um tamanho adicional para a parte inferior do cursor.
caret_extra_width
Define um tamanho adicional para a largura do cursor.
match_brackets
Habilita o sublinhado em parênteses, colchetes ou chaves correspondentes quando o cursor está posicionado ao lado de um deles.
match_brackets_content
Habilita o sublinhado em parênteses, colchetes ou chaves correspondentes quando o cursor está posicionado em qualquer lugar entre eles.
match_brackets_square
Habilita o sublinhado especificamente para colchetes correspondentes. Funciona somente quando match_brackets for true.
match_brackets_braces
Habilita o sublinhado especificamente para chaves correspondentes. Funciona somente quando match_brackets for true.
match_brackets_angle
Habilita o sublinhado especificamente para
<
e>
correspondentes. Funciona somente quando match_brackets for true.
match_tags
Habilita visualização da tag HTML ou XML correspondente.
match_selection
Destaca as todas as ocorrências do texto selecionado.
line_padding_top
Define tamanho adicional (em pixels) do espaço superior de cada linha.
line_padding_bottom
Define tamanho adicional (em pixels) do espaço inferior de cada linha.
scroll_past_end
Habilita a capacidade de rolar a tela para além do final do buffer (conteúdo da view).
move_to_limit_on_up_down
Define o que acontece quando pressionamos seta para cima ou para baixo quando estamos na primeira ou na última linha de um arquivo, respectivamente. Por exemplo, quando habilitado, ao digitar seta para cima na primeira linha, o cursor vai para o limite inicial do arquivo, ou seja, a primeira coluna da primeira linha.
draw_white_space
draw_indent_guides
Habilita a exibição das guias de indentação.
indent_guide_options
Controla como as guias de indentação são mostradas. As opções possíveis são
draw_normal
edraw_active
, sendo que esta última serve para mostrar a guia de indentação da linha na qual o cursor está em uma cor diferente.
trim_trailing_white_space_on_save
Remove os espações em branco ao final das linhas ao salvar. Valor padrão é false.
ensure_newline_at_eof_on_save
Quando habilitado, garante que a última linha do arquivo termine com um caracter de quebra de linha.
save_on_focus_lost
Quando habilitado, salva automaticamente o arquivo quando trocamos o foco para outro arquivo ou outra aplicação.
atomic_save
Faz com que o salvamento de um arquivo seja feito gravando em um arquivo alternativo e depois renomeando esse arquivo com o nome do arquivo original.
fallback_encoding
Encoding que deve ser utilizado para salvar o arquivo quando o original não puder ser determinado automaticamente.
default_encoding
Encoding utilizado para salvar novos arquivos ou arquivos abertos com encoding não definido. Se um arquivo for aberto com um encoding definido, esta opção é desconsiderada e o arquivo será salvo com o encoding no qual foi aberto.
enable_hexadecimal_encoding
Define se arquivos que contém bytes nulos devem ser abertos como hexadecimal por padrão.
default_line_ending
Define quais caracteres devem ser utilizados para demarcar o final de cada linha. As opções válidas são
windows
(CRLF),unix
(LF apenas) ousystem
(usa o padrão do sistema operacional).
Configurações de autocomplemento
tab_completion
Ativa o autocomplemento utilizando a tecla
Tab
.
auto_complete
Ativa o autocomplemento automático ao digitar.
auto_complete_size_limit
Tamanho máximo do arquivo para o qual o autocomplemento automático é ativado.
auto_complete_delay
Intervalo em milissegundos entre a digitação e a exibição da janela de autocomplemento.
auto_complete_selector
Define em quais escopos o autocomplemento deve ser ativado.
auto_complete_triggers
Define situações adicionais para as quais o autocomplemento deve ser ativado. O valor padrão, por exemplo, determina que nos arquivos HTML o autocomplemento é ativado quando digitamos
<
(abertura de tag).
auto_complete_commit_on_tab
Define se a confirmação do autocomplemento deve ser feita com a tecla
Tab
. Caso o valor desse atributo seja false, a confirmação é feita comEnter
.
auto_complete_with_fields
Define se os autocomplementos devem ser exibidos quando os campos de um snippet estiverem ativos (ver seção Estrutura de um snippet no capítulo Snippets). É relevante somente quando
auto_complete_commit_on_tab
for true.
auto_complete_cycle
Define o que acontece quando pressionamos a seta para cima ou para baixo no primeiro ou no último item da lista de autocomplemento. Quando habilitado, a seleção passa para o último ou o primeiro item respectivamente, de maneira cíclica. Quando desabilitado, a lista desaparece.
auto_close_tags
Quando habilitado, a última tag HTML previamente aberta é fechada ao pressionar
</
.
shift_tab_unindent
Quando habilitado a combinação de teclas
Shift+Tab
passa a sempre funcionar como o comando de remover indentação. Normalmente, isso só ocorre quando mais de uma linha está selecionada. Do contrário, a combinação insere o caracterTab
.
copy_with_empty_selection
Quando habilitado, os comandos de copiar e colar atuam sobre a linha na qual o cursor está quando não há nenhum trecho selecionado.
find_selected_text
Quando habilitado, o texto selecionado é copiado automaticamente para o painel de busca quando este é exibido.
auto_find_in_selection
Quando habilitado e mais de uma linha é selecionada, a opção “Find in Selection” é ativada automaticamente no painel de busca.
drag_text
Quando ativado, o ato de clicar em um texto selecionado inicia uma operação de arrastar-e-soltar.
Configurações de interface de usuário
theme
Define qual o tema visual da interface (botões, abas, barras de rolagem etc.)
scroll_speed
Deve ser informado um valor entre 0 e 1 que define a velocidade de rolagem da tela.
tree_animation_enabled
Define se deve ser aplicada animação ao expandir ou recolher as pastas na barra lateral.
animation_enabled
Define se deve ser aplicada animação na aplicação em geral.
highlight_modified_tabs
Define se as abas que contém texto modificado em relação ao último salvamento de arquivo devem ser destacadas em uma cor diferente.
show_tab_close_buttons
Habilita a exibição dos botões de fechar abas.
bold_folder_labels
Quando habilitado, faz com que as pastas sejam mostradas em negrito na barra lateral.
use_simple_full_screen
Apenas para o OS X, serve para habilitar o suporte a tela cheia específico do sistema operacional.
gpu_window_buffer
Apenas para o OS X, serve para hablitar a configuração de rodar em telas com largura de 2560 pixels ou mais.
overlay_scroll_bars
Habilita exibição das barras de rolagem.
enable_tab_scrolling
Define se as abas devem se expandir e rolar para os lados quando ocuparem a largura da tela ou se devem encolher.
show_encoding
Mostra o encoding do arquivo aberto na barra de status.
show_line_endings
Mostra o tipo de caracteres de encerramento de linha na barra de status.
Configurações do comportamento da aplicação
hot_exit
Habilita a capacidade de sair imediatamente da aplicação de modo que as modificações não salvas sejam preservadas e restauradas da próxima vez que o editor for iniciado.
remember_full_screen
Quando ativado, inicia automaticamente a sessão no modo tela cheia caso a sessão anterior tenha sido encerrada em tela cheia.
always_prompt_for_file_reload
Quando ativado, sempre pergunta antes de recarregar um arquivo, mesmo que ele não tenha sido modificado. O comportamento padrão é recarregar o arquivo automaticamente se ele não tiver sido editado. Se houver modificações não salvas, a caixa de diálogo de confirmação sempre será exibida.
open_files_in_new_window
Apenas para o OS X. Quando arquivos forem abertos pelo Finder ou arrastando para o ícone no Dock, controla se uma nova janela é ou não criada.
create_window_at_startup
Apenas para o OS X. Controla se uma janela vazia é ou não criada ao iniciar.
close_windows_when_empty
Quando habilitado, fecha as janelas assim que o último arquivo é fechado, a menos que haja uma pasta aberta na janela.
show_full_path
Define se o caminho completo do arquivo que está sendo editado deve aparecer na barra de título.
show_panel_on_build
Quando habilitado, mostra o painel Build Results ao executar um build. Caso contrário, os resultados do build podem ser visualizados usando o menu Tools | Build Results.
preview_on_click
Define se o conteúdo do arquivo deve ser mostrado ao clicar em um arquivo na barra lateral. Um duplo clique ou editar a pré-visualização abrirá o arquivo em uma aba própria.
folder_exclude_patterns e file_exclude_patterns
Lista de padrões de nomes de pastas ou arquivos que definem os itens que não devem ser exibidos na barra lateral.
binary_file_patterns
Lista de padrões de nomes de arquivos binários que, apesar de serem exibidos na barra lateral, são excluídos de buscas efetuadas pelo Goto Anything ou Find in Files.
index_files
Quando ativada, esta opção faz com que os arquivos que constam na barra lateral sejam analisados e, a partir daí, seja montado o índice de símbolos necessário para o funcionamento do recurso Goto Symbol.
index_workers
Define o número de threads utilizadas para indexação dos símbolos.
index_exclude_patterns
Lista de padrões de nomes de arquivos que serão desconsiderados na montagem do índice de símbolos.
enable_telemetry
Quando habilitado, permite que sejam enviados dados anonimamente para os desenvolvedores do Sublime Text, para que possam ajudar nas decisões sobre melhorias do editor.
ignored_packages
Lista de pacotes que, mesmo instalados, devem ser ignorados ao iniciar o editor.