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

Super​Settings

A Sublime Text package that enables per-directory configuration.

Details

  • 1.0.0
  • github.​com
  • github.​com
  • 7 months ago
  • 15 minutes ago
  • 10 years ago

Installs

  • Total 4K
  • Win 2K
  • Mac 761
  • Linux 651
Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 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
Windows 0 0 0 0 1 0 0 0 1 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 1 0 1 0 0 0 0 0 0 1 1
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 1 0 0 0 1 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 0 0 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, the built-in functionality is limited to a 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

    javascripts/
        Preferences.sublime-settings
        app.js

    index.html
  • The file example/index.html uses settings from example/Preferences.sublime-settings and example/HTML.sublime-settings.
  • The file example/javascripts/app.js uses settings from example/javascripts/Preferences.sublime-settings, example/Preferences.sublime-settings and example/JavaScript.sublime-settings.