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 787
  • Linux 672
Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6 Jul 5 Jul 4 Jul 3 Jul 2 Jul 1 Jun 30 Jun 29 Jun 28 Jun 27 Jun 26 Jun 25 Jun 24 Jun 23 Jun 22 Jun 21 Jun 20 Jun 19 Jun 18 Jun 17 Jun 16 Jun 15 Jun 14 Jun 13 Jun 12 Jun 11 Jun 10 Jun 9 Jun 8 Jun 7 Jun 6 Jun 5 Jun 4 Jun 3 Jun 2 Jun 1
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 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 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 0 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 1 0 0 0 0 0 0 0 0 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:

  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.