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) e directwrite (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 teclas Tab e Backspace 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 um if na linguagem C, por exemplo. Esta opção requer que auto_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

Define quando os espaços em branco devem ficar visíveis. Os valores possíveis são none (nunca deixar visível), ``selection``(visível apenas quando selecionado) ou ``all``(sempre deixar visiível). O valor padrão é selection.

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 e draw_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) ou system (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 com Enter.

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 caracter Tab.

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.