SuperSettings
A Sublime Text package that enables per-directory configuration.
Details
Installs
- Total 4K
- Win 2K
- Mac 775
- Linux 665
Jun 3 | Jun 2 | Jun 1 | May 31 | May 30 | May 29 | May 28 | May 27 | May 26 | May 25 | May 24 | May 23 | May 22 | May 21 | May 20 | May 19 | May 18 | May 17 | May 16 | May 15 | May 14 | May 13 | May 12 | May 11 | May 10 | May 9 | May 8 | May 7 | May 6 | May 5 | May 4 | May 3 | May 2 | May 1 | Apr 30 | Apr 29 | Apr 28 | Apr 27 | Apr 26 | Apr 25 | Apr 24 | Apr 23 | Apr 22 | Apr 21 | Apr 20 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 3 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
SublimeSuperSettings
A Sublime Text package that enables per-directory configuration.
Table of Contents
Why?
Sublime Text can be configured easily without having to go through a dozen different menus and windows: Just adjust a single JSON file and be done with it. However, out of the box, configuration is limited to one global settings file and a single settings file per project. On top of that, syntax-specific settings for a project cannot be adjusted. SublimeSuperSettings takes care of all these limitations by enabling per-directory configuration.
Features
- Sublime Text settings are automatically adjusted using per-directory settings files.
- In addition to the general per-directory configuration functionality, settings can further be split by syntax.
- The complete directory tree is searched to discover and merge settings files.
Requirements
SublimeSuperSettings works with Sublime Text 3.
Installation
Package Control
Installing SublimeSuperSettings through Package Control is recommended. Please note that the package you need to install is called SuperSettings
. Check out the Package Control installation instructions if you need help.
Manual
Following steps can be used if you prefer to manually manage your Sublime Text packages:
- Download SublimeSuperSettings.
- Extract the downloaded archive.
- Rename the extracted directory to
SublimeSuperSettings
. - Move the directory to your Sublime Text packages directory. You can access the Sublime Text packages directory by opening the command palette (Tools → Command Palette) and entering
Browse Packages
.
Usage
General Settings Files
Simply place a file called Preferences.sublime-settings
inside a directory. Any Sublime Text tab for a file inside that directory (and subdirectories) will be configured accordingly. Settings files that are lower in the directory tree have higher priority and override settings that are defined in files higher up.
Syntax-Specific Settings Files
You can also split settings inside a directory by syntax. For example, to apply settings to JavaScript files inside a directory, use following steps:
- Open a JavaScript file with Sublime Text.
- Access the command palette (Tools → Command Palette) and enter
Settings Syntax Specific
. This will open a syntax-specific settings file for JavaScript. - Note the name of the open settings file. It will be
JavaScript.sublime-settings
in this example. - Create an equally named file inside the desired directory.
The syntax-specific settings files follow the same discovery and merge logic as the general settings files.
Settings File Format
The settings files for SublimeSuperSettings have the same format as the default Sublime Text settings files. For example:
{
"tab_size": 4,
"rulers": [80],
"translate_tabs_to_spaces": true
}
Note: You cannot use comments inside settings files.
Example
example/
Preferences.sublime-settings
HTML.sublime-settings
JavaScript.sublime-settings
js/
Preferences.sublime-settings
form.js
index.html
- The file
example/index.html
uses settings fromexample/Preferences.sublime-settings
andexample/HTML.sublime-settings
. - The file
example/js/form.js
uses settings fromexample/js/Preferences.sublime-settings
,example/Preferences.sublime-settings
andexample/JavaScript.sublime-settings
.