为 Less.js 做贡献

感谢你考虑贡献！请仔细阅读[贡献说明](https://github.com/less/less.js/blob/master/CONTRIBUTING.md "贡献说明")以避免浪费工作。

### 安装这些工具

- node - http://nodejs.org/
- phantomjs - http://phantomjs.org/download.html

确保路径已设置。启动你喜欢的命令行并输入 `node -v`，你会看到 node 编译器。如果运行 `phantomjs -v`，你会看到 `phantomjs` 的版本号。

- 克隆本地的 less.js 仓库
- 导航到本地的 less.js 仓库，然后运行 `npm install` 安装 less 的 npm 依赖项。

### 用法

Grunt 用于运行测试、构建和基准测试等开发命令。如果你在全局安装了 `grunt-cli` 或 `npm run grunt -- [command_name]`，就可以使用 `grunt [command_name]` 运行它们。

如果你进入 Less 仓库的根目录，应该可以执行 `npm test`（`npm run grunt -- test` 的便捷别名）--这会运行所有测试。如果只针对浏览器，请运行 `npm run grunt -- browsertest` 如果想针对某个文件试用当前版本的 less，请执行 `node bin/lessc path/to/file.less` 。

要调试浏览器测试，请运行 `npm run grunt -- browsertest-server`，然后访问 `http://localhost:8088/tmp/browser/` 查看测试运行页面。

可选： 要获取当前版本的 Less 编译器，请执行 `npm -g install less` - npm 是节点软件包管理器，"-g" 会将其安装到全局。

现在你应该可以执行 `lessc file.less`，如果有合适的 `file.less` 就会被编译并输出到 stdout。然后，你就可以将其与本地运行（`node bin/lessc file.less`）进行比较。

其他 grunt 命令

- `npm run grunt -- benchmark` - 运行我们的基准测试以获得一些性能数据
- `npm run grunt -- stable` 用于创建新版本
- `npm run grunt -- readme` 在根目录下生成新的 readme.md（每次发布之后）

### 如何在其他环境中运行 Less

在 libs 文件夹中可以看到 `less`、`less-node` 和 `less-browser` 文件夹。如果要求使用 `less/libs/less`，就会得到一个接收环境对象和文件管理器数组的函数。这些文件管理器与可作为插件编写的文件管理器相同。

```less
var createLess = require("less/libs/less"),
    myLess = createLess(environment, [myFileManager]);
```
环境 api 在 [less/libs/less/environment/environment-api.js](https://github.com/less/less.js/blob/master/lib/less/environment/environment-api.js "less/libs/less/environment/environment-api.js") 中指定文件管理器 api 在 [less/libs/less/environment/file-manager-api.js](https://github.com/less/less.js/blob/master/lib/less/environment/file-manager-api.js "less/libs/less/environment/file-manager-api.js") 中指定。

对于文件管理器，我们强烈建议将其原型设置为新的 AbstractFileManager - 这样您就可以覆盖所需的功能，并允许我们在不破坏现有文件管理器的情况下实现新功能。有关文件管理器的示例，请参阅 2 个节点实现、浏览器实现或 npm 导入插件实现。

### 指南

如需了解更多信息，请访问 http://www.gliffy.com/go/publish/4784259 。警告！需要根据 V2 的变化进行更新。