Edit the markdown source for "command-line-usage"
使用命令行编译 .less
文件生成 .css
文件
注意! 如果命令行不是你的长处, 更多的去了解 GUIs for Less.
Installing lessc for use globally (安装Lessc到全局使用)
用npm工具包安装
npm install less -g
然后你将可以使用 lessc
这个全局命令. 对于指定的版本(或者 标签) 你能在我们的安装包后添加 @VERSION
, 例如. npm install less@1.6.2 -g
.
Installing for node development (安装到项目开发)
另外如果你不使用全局编译器,你可能会
npm i less --save-dev
该命令会安装最新的lessc官方版本到你的项目文件夹, 同时会把它添加到你项目package.json
文件的devDependencies
.
请注意,[波浪线版本范围][]将自动在package.json中指定。这是对的,因为最新版本发布的新补丁将由npm安装。
Beta releases of lessc (lessc的测试版本)
因为新功能将会定期的发布,lessc 构建也会将他们作为标记发布到npm。 这些版本不会作为@latest
的正式发布,通常是带有版本号或带alpha/beta/release
字样的候选版本.
由于补丁发布是持续性的,我们会同时公布补丁版本,作为次要或主要版本升级的alpha/beta/候选版本也会被公布(为了遵循语义版本,我们会从1.4.0版本继续)。
Installing an unpublished development version of lessc (安装lessc 未发布的开发版本)
如果你想安装一个超前的,lessc未发布的版本,按照说明指定一个[git的URL作为一个依赖][]和一定要指定一个实际的提交SHA(不是一个分支的名字)使用commit-ish
。这将保证您的项目总是使用lessc的具体版本.
指定的git URL 可能就是官方lessc的repo库或者一个fork库.
Server-Side and Command Line Usage (服务器端命令行使用)
这个资源库包含了二进制资源,bin/lessc
可以在安装有Node.js 的*nix, OSX and Windows这些平台上工作。
Usage: lessc [option option=parameter ...] <source> [destination]
Command line usage (命令行使用)
lessc [option option=parameter ...] <source> [destination]
如果源文件设置`-'命令选项,从标准输入文件读取数据。
Examples (例如)
$ lessc bootstrap.less bootstrap.css
$ lessc -x bootstrap.less bootstrap.css
Options (选项)
Help (帮助)
lessc --help
lessc --h
打印一个带有可选项的帮助菜单,然后退出
Include paths
lessc --include-path=PATH1;PATH2
设置可用的包含路径,在Windows,用':' 或者 ';'分隔
使用这个命令配置一系列less导入所能用到的路径,你可能用到这个比如你想在less文件中指定一个你想要引用的一个less工具库.
在node中使用的话,这样设置一个路径选项
{ paths: ['PATH1', 'PATH2'] }
Makefile (输出一个带有依赖列表关系的makefile)
lessc -M
lessc --depends
No Color (禁用彩色的输出)
lessc --no-color
No IE Compatability (禁用IE兼容性检查)
lessc --no-ie-compat
目前仅用于 data-uri函数,确保创建出能够适合浏览器处理的图片大小。
Disable JavaScript (禁用JavaScript)
lessc --no-js
Lint (仅语法检查)
lessc --lint
lessc --l
运行less转换器,仅仅会报告错误,无任何输出
Silent (抑制错误消息输出)
lessc -s
lessc --silent
停止所有警告信息显示。
Strict Imports
lessc --strict-imports
Allow imports from insecure https hosts (允许导入不安全的https hosts)
lessc --insecure
Version (显示版本)
lessc -v
lessc --version
Compress (压缩)
lessc -x
lessc --compress
压缩使用less内置的压缩工具,这是一个好的习惯,但没有利用所有专用压缩css的技巧.您能发挥想象改进我们的压缩输出,通过提交pull request.
Clean CSS (清理CSS)
在less v2中,Clean CSS不再被包括进来作为必须依赖。
要使用 lessc 的 Clean CSS (清理CSS),请使用clean css 插件。
Source Map Output Filename (可输出自定义文件名的源代码映射)
lessc --source-map
lessc --source-map=file.map
告诉less 生成一个源代码映射文件(sourcemap).如果不提供文件名映射,则使用源less编译后CSS全文件名来作为扩展映射名称。
Source Map Rootpath (源代码映射带根路径)
lessc --source-map-rootpath=dev-files/
指定一个根路径添加到源代码映射的每一个less文件路径,并添加到编译生成的css文件源代码映射文件名上
因为basepath默认为存放less文件的目录,rootpath默认的路径从sourcemap输出文件到存放less文件的基本目录。
举例来说如果你生成的css文件在Web服务器根目录上,但你的源Less/Css/map文件在不同的文件夹中。因此,用这个选项可能有下面的结果
output.css
dev-files/output.map
dev-files/main.less
Source Map Basepath
lessc --source-map-basepath=less-files/
与根路径相反的相反的做法,它指明应当从输出路径被移除的路径。例如,如果你正在编译less-files
目录的一个文件,但源文件将在根目录或当前目录下的Web服务器有效,您可以指定此项,移除输出路径中额外的less-files
文件路径。
它默认是存放less文件的路径。
Source Map Less Inline
lessc --source-map-less-inline
此选项指定所有的less文件内容都会内嵌在源文件映射中,意味着获取你的.map文件就能获取less源代码.
这可以与内联映射选项(见Source Map Map Inline)一起使用,这样你不需要任何额外的外部文件。
Source Map Map Inline
lessc --source-map-map-inline
此选项指定map文件(包括less文件)应该内嵌在输出的CSS,在生产中不推荐,但对于开发环境,编译输出单个文件,在支持它的浏览器,就可以使用编译的css而显示未编译的less资源
Source Map URL
lessc --source-map-url=../my-map.json
允许你在CSS中重写你的指向map文件的URL,为了防止根路径和原路径选项没有准确生成你需要的情况。
Rootpath (根路径)
lessc -rp=resources/
lessc --rootpath=resources/
允许你添加一个用于导入文件和Css文件生成的路径,这不会影响less 被编译的导入语句,仅仅影响停留在输出Css的位置。
例如,如果所有Css引用了resources文件的图片,你能使用此选项添加路径到URL,然后有你配置的文件夹名称。
Relative URLs (相对路径)
lessc -ru
lessc --relative-urls
默认情况下,URL是保持原样,因此当你导入一个引入了图片的子目录文件时,输出Css中路径也会保持相对一致。此选项允许您重写URL,将导入的文件的路径作为图片路径的相对路径,这样就确保URL总是相对于基于导入的文件。例如
# main.less
@import "files/backgrounds.less";
# files/backgrounds.less
.icon-1 {
background-image: url(images/lamp-post.png');
}
正常情况将输出如下:
.icon-1 {
background-image: url(images/lamp-post.png');
}
但是使用此选项则生成如下:
.icon-1 {
background-image: url('files/images/lamp-post.png');
}
你可能也想考虑使用能嵌入图片到css中的 data-uri函数替换这个选项。
Strict Math (严格的数学运算)
lessc -sm=on
lessc --strict-math=on
默认关闭
如果这个选项关闭, Less将尝试计算你Css中所有的数学运算,例如.
.class {
height: calc(100% - 10px);
}
目前能被计算。
如果开启严格数学运算, 仅仅只有不必要的圆括号号内的运算会被计算,例如。
.class {
width: calc(100% - (10px - 5px));
height: (100px / 4px);
font-size: 1 / 4;
}
.class {
width: calc(100% - 5px);
height: 25px;
font-size: 1 / 4;
}
我们原计划默认开启在将来,但它一直是矛盾的选项,我们正在考虑是否用正确的方式解决了这个问题,或者是否Less应该有例外情况‘/’是有效的或Calc 是有用的
Strict Units (严格的单位)
lessc -su=on
lessc --strict-units=on
默认关闭
没有这个选项, less 会尝试猜数学上单位输出。例如:
.class {
property: 1px * 2px;
}
对于这个例子,事情很明显不对,一个长度乘以另一个长度得到一个面积,但是css不支持这种面积,因此我们断定用户的意思是一个值乘以另外一个值,而不是长度单位,因此输出 2px
.
如果这个选项开启,我们会断定是一个计算bug,然后报出一个错误。
Global Variable (全局变量)
lessc --global-var="my-background=red"
这个选项定义一个能被文件引用的变量.高效的声明是放置在你基础Less文件的顶部,意味着他能被使用,但也能被覆盖如果在文件中定义了这个变量.
Modify Variable (修改变量)
lessc --modify-var="my-background=red"
与全局变量选项不同的是,这将在你的基础文件最后放置一个声明,意味着它将覆盖任何Less文件中的定义。
URL Arguments (URL 参数)
lessc --url-args="cache726357"
与全局变量选项不同的是,这将在你的基础文件最后放置一个声明,意味着它将覆盖任何Less文件中的定义。
Line Numbers (行号)
lessc --line-numbers=comments
lessc --line-numbers=mediaquery
lessc --line-numbers=all
生成内嵌source-mapping. 这是浏览器开始支持sourcemaps之前唯一的选择。我们认为这样做是不好的,所以如果你想要保留这个选项请联系我们。
Plugin
lessc --clean-css
lessc --plugin=clean-css="advanced"
--plugin 加载一个插件. 如果插件以less-plugin
开始,您也可以省略--plugin=
。例如,一旦安装 (npm 安装 less-plugin-clean-css) less-plugin-clean-css
的清理css插件,可以使用--plugin=less-plugin-clean-css
或 --clean-css
加载,也可以后面指定选项,比如--plugin=less-plugin-clean-css="advanced"
或 --clean-css="advanced"
。