Questions tagged [sublime-build]

Build systems let you run your files through external programs without leaving Sublime Text, and see the output they generate.

Build systems configurations are stored in .sublime-build files. These JSON files can contain various keys:

• selector: allows Sublime Text to find the build, looking for the current file extension
• target: Sublime Text command to run (by default exec)
• variants: allows you to provide build options
• windows: OS-specific configuration
• linux: OS-specific configuration
• osx: OS-specific configuration
• cmd: the command to execute when F7 is pressed
• file_regex: Perl regex to capture output of cmd
• line_regex: Perl regex to capture output of cmd
• working_dir: directory to change the current directory before running cmd
• encoding: output encoding of cmd
• env: dictionary of environment variables to be merged before passing them to cmd
• shell: if true, cmd will be run through the shell
• path: will replace the current process' PATH before calling cmd
• syntax: output syntax for highlighting purpose

Here is a simple build, used to run the sass command for .scss and .sass files:

{

    "cmd": [
        "sass",
        "--update",
        "--stop-on-error",
        "--no-cache",
        "--load-path", "${file_path}",
        "--sourcemap=none",
        "$file:../${file_base_name}.css"
    ],

    "selector": "source.sass, source.scss",
    "line_regex": "Line ([0-9]+):",

    "osx": {
        "path": "/usr/local/bin:$PATH"
    },
    "windows": {
        "shell": "true"
    }

}

Links

• Build Systems documentation