==================== Settings (Reference) ==================== Global Settings =============== **Target file:** ``Global.sublime-settings``. ``theme`` Theme to be used. Accepts a file base name (e. g.: ``Default.sublime-theme``). ``remember_open_files`` Determines whether to reopen the buffers that were open when Sublime Text was last closed. ``folder_exclude_patterns`` Excludes the matching folders from the side bar, GoTo Anything, etc. ``file_exclude_patterns`` Excludes the matching files from the side bar, GoTo Anything, etc. ``scroll_speed`` Set to ``0`` to disable smooth scrolling. Set to a value between ``0`` and ``1`` to scroll slower, or set to a value larger than ``1`` to scroll faster. ``show_tab_close_buttons`` If ``false``, hides the tabs' close buttons until the mouse is hovered over the tab. ``mouse_wheel_switches_tabs`` If ``true``, scrolling the mouse wheel will cause tabs to switch if the cursor is in the tab area. ``open_files_in_new_window`` OS X only. When filters are opened from Finder, or by dragging onto the dock icon, this controls if a new window is created or not. File Settings ============= **Target files:** ``Base File.sublime-settings``, ``.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 :kbd:`Tab` is pressed. ``use_tab_stops`` If ``translate_tabs_to_spaces`` is ``true``, will make :kbd:`Tab` and :kbd:`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 :kbd:`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. Input Settings ************** ``command_mode`` If set to ``true``, the buffer will ignore key strokes. Useful to emulate Vim.