File Settings
Target files: Base File.sublime-settings, <file_type>.sublime-settings.
Whitespace and Indentation
- auto_indent
- Toggles automatic indentation.
- tab_size
- Number of spaces a tab is considered to be equal to.
- translate_tabs_to_spaces
- Determines whether to replace a tab character with tab_size number of
spaces when Tab is pressed.
- use_tab_stops
- If translate_tabs_to_spaces is true, will make Tab and
Backspace insert/delete tab_size number of spaces per key press.
- trim_automatic_white_space
- Toggles deletion of white space added by auto_indent.
- detect_indentation
- Set to false to disable detection of tabs vs. spaces whenever a buffer
is loaded. If set to true, it will automatically modify
translate_tabs_to_spaces and tab_size.
- draw_white_space
- Valid values: none, selection, all.
- trim_trailing_white_space_on_save
- Set to true to remove white space on save.
Visual Settings
- color_scheme
- Sets the colors used for text highlighting. Accepts a path rooted at the
data directory (e. g.: Packages/Color Scheme - Default/Monokai Bright.tmTheme).
- font_face
- Font face to be used for editable text.
- font_size
- Size of the font for editable text.
- font_options
- Valid values: bold, italic, no_antialias, gray_antialias,
subpixel_antialias, directwrite (Windows).
- gutter
- Toggles display of gutter.
- rulers
- Columns in which to display vertical rules. Accepts a list of numeric values
(e. g. [79, 89, 99] or a single numeric value (e. g. 79).
- draw_minimap_border
- Set to true to draw a border around the minimap’s region corresponding
to the the view’s currently visible text. The active color scheme’s
minimapBorder key controls the border’s color.
- highlight_line
- Set to false to stop highlighting lines with a cursor.
- line_padding_top
- Additional spacing at the top of each line, in pixels.
- line_padding_bottom
- Additional spacing at the bottom of each line, in pixels.
- scroll_past_end
- Set to false to disable scrolling past the end of the buffer. If true,
Sublime Text will leave a wide, empty margin between the last line and the
bottom of the window.
- line_numbers
- Toggles display of line numbers in the gutter.
- word_wrap
- If set to false, long lines will be clipped instead of wrapped. Scroll
the screen horizontally to see the clipped text.
- wrap_width
- If greater than 0, wraps long lines at the specified column as opposed
to the window width. Only takes effect if wrap_width is set to true.
- indent_subsequent_lines
- If set to false, wrapped lines will not be indented. Only takes effect
if wrap_width is set to true.
- draw_centered
- If set to true, text will be drawn centered rather than left-aligned.
- match_brackets
- Set to false to disable underlining the brackets surrounding the cursor.
- match_brackets_content
- Set to false is you’d rather only highlight the brackets when the cursor
is next to one.
- match_brackets_square
- Set to false to stop highlighting square brackets. Only takes effect if
match_brackets is true.
- match_bracktets_braces
- Set to false to stop highlighting curly brackets. Only takes effect if
match_brackets is true.
- match_bracktets_angle
- Set to false to stop highlighting angle brackets. Only takes effect if
match_brackets is true.
Automatic Behavior
- auto_match_enabled
- Toggles automatic pairing of quotes, brackets, etc.
- save_on_focus_lost
- Set to true to automatically save files when switching to a different file
or application.
- find_selected_text
- If true, the selected text will be copied into the find panel when it’s
shown.
- word_separators
- Characters considered to separate words in actions like advancing the cursor,
etc. They are not used in all contexts where a notion of a word separator is
useful (e. g.: word wrapping). In such other contexts, the text might be
tokenized based on other criteria (e. g. the syntax definition rules).
- ensure_newline_at_eof_on_save
- Always adds a new line at the end of the file if not present when saving.
System and Miscellaneous Settings
- is_widget
- Returns true if the buffer is an input field in a dialog as opposed to
a regular buffer.
- spell_check
- Toggles the spell checker.
- dictionary
- Word list to be used by the spell checker. Accepts a path rooted at the
data directory (e. g.: Packages/Language - English/en_US.dic). You can
add more dictionaries.
- fallback_encoding
- The encoding to use when the encoding can’t be determined automatically.
ASCII, UTF-8 and UTF-16 encodings will be automatically detected.
- default_line_ending
- Determines what characters to use to designate new lines. Valid values:
system (OS-dependant), windows (CRLF) and unix (LF).
- tab_completion
- Determines whether pressing Tab will insert completions.
Build and Error Navigation Settings
- result_file_regex
- Regular expression used to extract error information from some output dumped
into a view or output panel. Follows the same rules as error capturing in
build systems.º
- result_line_regex
- Regular expression used to extract error information from some output dumpºed
into a view or output panel. Follows the same rules as error capturing in
build systems.
- result_base_dir
- Directory to start looking for offending files in based on information
extracted with result_file_regex and result_line_regex.
- build_env
- List of paths to add to build systems by default.
File and Directory Settings
- default_dir
- Sets the default save directory for the view.