Skip to content

如何使用项目配置功能?

Ethan Lai edited this page Jun 20, 2013 · 2 revisions

创建配置

选中项目后右键,依次选择"项目配置" --> "新建配置" --> 选择你使用的语言。 操作后Koala将在该项目目录下生成"koala-config.json"文件,然后就可以编辑此文件来设置你需要的编译配置。
当"koala-config.json"文件被修改后,Koala将自动读取里面的设置并重新载入该项目。

字段说明

language

(string) 语言类型,无需编辑。

http_path

(string) 设置项目的根路径,默认值是"/",即"koala-config.json"文件所在目录。

sass_dir/less_dir/coffee_dir

(string) 指定sass/less/coffee 文件所在目录,请使用相对与"http_path"的路径。
默认下Koala会读取项目目录下的所有目录及文件,设置后将只读取该目录下面的文件。

css_dir/javascripts_dir

(string) 指定css/javascripts输出目录,使用相对与"http_path"的路径。 默认输出路径是与编译文件同级目录,设置后将在指定的目录输出相应css/javascripts文件。

options

指定文件默认的编译选项。
如果想自定义某个文件,依然可以在选中文件后右侧展开的设置栏中设置。

custom_options

(array) 如果"options"中没有你需要的选项,你可以在这里添加。
添加时请使用选项的全名,如"-h, --help"请使用"--help"。
如果你已安装编译组件,在终端中运行"sass -h"、"lessc -h"、"coffee -h"可以看到全部的编译选项。

include_paths

(array) 指定Less/Sass @import文件的引用路径,等价于Less的"--include-path"选项或Sass的"--load-path PATH"选项,请直接填写引用目录的完整路径。
场景示例:假如Sass组件"zurb-foundation"存放在/home/libs/zurb-foundation目录,而你的Sass文件存放在/home/workspaces/project/sass/app.scss,此时如果你想使用"zurb-foundation"组件,可以在"include_paths"中添加路径,如:["/home/libs/zurb-foundatio"],然后即可直接在"app.scss"使用@import "foundation/components/global";

require_libs

(array) 在执行Sass编译前载入指定的ruby库,可指定多个库。 等价于Sass选项"--require LIB"。