ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Super​Settings

A Sublime Text package that enables per-directory configuration.

Details

Installs

  • Total 4K
  • Win 2K
  • Mac 769
  • Linux 658
Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4 Aug 3 Aug 2 Aug 1 Jul 31 Jul 30 Jul 29 Jul 28 Jul 27 Jul 26 Jul 25 Jul 24 Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6
Windows 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 1 0 1 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 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 0 0
Linux 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 0 0 0 0 0 0 0 1 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:

  1. Download SublimeSuperSettings.
  2. Extract the downloaded archive.
  3. Rename the extracted directory to SublimeSuperSettings.
  4. 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:

  1. Open a JavaScript file with Sublime Text.
  2. Access the command palette (Tools → Command Palette) and enter Settings Syntax Specific. This will open a syntax-specific settings file for JavaScript.
  3. Note the name of the open settings file. It will be JavaScript.sublime-settings in this example.
  4. 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 from example/Preferences.sublime-settings and example/HTML.sublime-settings.
  • The file example/js/form.js uses settings from example/js/Preferences.sublime-settings, example/Preferences.sublime-settings and example/JavaScript.sublime-settings.