Libsass构建

Linux & OSX	Windows
	?

Sublime Text 2/3的Sass/scss文件构建系统，无外部依赖

它使用libsass（通过官方sassc前端）进行编译，与官方Ruby实现相比，编译时间更快。

https://github.com/blitzrk/sublime_libsass

配置

默认情况下，sassc未提供任何参数，css文件被放置在相对于项目根目录（包含正在编译文件的sass文件的目录）的build/css中。默认输出目录和sassc标志可以在偏好设置->包设置->Libsass构建 ->设置 - 用户中进行修改。在设置 - 默认中有一个骨架，或参见以下内容。

可以在.libsass.json文件中写入特定项目的配置。此外，此文件的位置将明确指出项目的根目录，以便根据sass导入和输出目录的根目录。您可以编辑此配置或通过选择菜单项工具->Libsass构建 ->编辑项目配置生成示例。

示例

你有以下目录结构

/path/to/projects/example/
|-- lib/
|-- static/
|   |-- js/
|   |-- css/
|   |   +-- main.css
|   +-- images/
|-- .libsass.json
+-- styles/
    |-- partials/
    |   +-- _reset.scss
    +-- main.scss (has @import 'partials/reset';)

然后你可以使用

/path/to/projects/example/.libsass.json:

{
    "output": {
        "dir": "static/css",
        "structure": "flat"
    },
    "compile": {
        "line-comments": true,
        "line-numbers":  true,
        "style":         "nested", // Comments allowed in `.libsass.json`, but not `*.sublime-settings`
        "load-path":     "/path/to/projects/example/styles" // You DO NOT need this line
    }
}

或选择在/path/to/projects/example/styles/.libsass.json

{
    "output": {
        "dir": "../static/css", // This path gets normalized, so `..`s get handled
        "structure": "flat"
    },
    "compile": {
        "line-comments": true,
        "line-numbers":  true,
        "style":         "nested",
        "load-path":     "/path/to/node_modules/bourbon" // Get your fill of bourbon or point to compass!
    }
}

结构

在配置中，您可以在output.structure中指定希望编译资源是并排还是在原始结构中嵌套。

./
|-- .libsass.json (output dir is "css")
|-- css/
+-- scss/
    |-- main.scss
    +-- modules/
        +-- menu.scss

• 嵌套（默认）：编译为css/scss/main.css和css/scss/modules/window.css
• 嵌套与根目录：如果您的.libsass.json更远，从嵌套路径中移除前缀
  • 示例：“结构”：[“嵌套”，“scss”]
  • 编译为css/main.css和css/modules/menu.css
• 平面：并行编译为css/main.css和css/menu.css

使用方法

配置完全是可选的，所以在最简单的情况下，只需用Ctrl+Shift+B构建。如果您已安装了另一个Sass构建系统，您可能需要在Sublime的菜单中选择Sass (libsass)。

故障排除

Libsass没有自动选择为构建系统

如果您已安装其他 Sass 构建系统，可能会发生冲突。如果没有选择构建系统，则可能未安装 Sass 语法定义，或者定义不正确（即未使用 source.sass 或 source.scss）。请尝试更换为其他语法高亮包，例如 Sass。

我的文件编译完成了，但不知道它去哪了！

Libsass 会查找目录结构直到找到（或找不到）一个 .libsass.json 配置文件。如果您没有使用配置文件，则请检查父目录中是否存在配置文件。例如，如果您项目位于 /home/ben/projects/app，且存在多余的配置文件 /home/ben/projects/.libsass.json，CSS 输出将相对于 /home/ben/projects 而不是 /home/ben/projects/app/build/css。

我的配置似乎不起作用

在 0.9.0 版本中，配置格式已经更改。对此我们很抱歉，但这是很重要的！现在名称应该不那么令人困惑了。不管怎样，请查看上面的示例。顶级键现在是“output”和“compile”，而不是“output_dir”和“options”。

无效的 UTF-8

目前 Libsass Sublime 在 Unicode 支持 上存在一些错误，所以如果您看到 UTF 错误，您的项目文件路径或名称中很可能含有非 ASCII 字符。目前，最好的解决方案是重新命名您的文件或目录。这显然很烦人，我们应该尽快修复这个问题。