source: Dev/trunk/node_modules/grunt-contrib-less/docs/less-options.md @ 484

Last change on this file since 484 was 484, checked in by hendrikvanantwerpen, 11 years ago

Commit node_modules, to make checkouts and builds more deterministic.

File size: 1.9 KB
Line 
1# Options
2
3## paths
4Type: `String|Array`
5Default: Directory of input file.
6
7Specifies directories to scan for @import directives when parsing. Default value is the directory of the source, which is probably what you want.
8
9## compress
10Type: `Boolean`
11Default: False
12
13Compress output by removing some whitespaces.
14
15## yuicompress
16Type: `Boolean`
17Default: False
18
19Compress output using cssmin.js
20
21## ieCompat
22Type: `Boolean`
23Default: true
24
25Enforce the css output is compatible with Internet Explorer 8.
26
27For example, the [data-uri](https://github.com/cloudhead/less.js/pull/1086) function encodes a file in base64 encoding and embeds it into the generated CSS files as a data-URI. Because Internet Explorer 8 limits `data-uri`s to 32KB, the [ieCompat](https://github.com/cloudhead/less.js/pull/1190) option prevents `less` from exceeding this.
28
29## optimization
30Type: `Integer`
31Default: null
32
33Set the parser's optimization level. The lower the number, the less nodes it will create in the tree. This could matter for debugging, or if you want to access the individual nodes in the tree.
34
35## strictImports
36Type: `Boolean`
37Default: False
38
39Force evaluation of imports.
40
41## syncImport
42Type: `Boolean`
43Default: False
44
45Read @import'ed files synchronously from disk.
46
47## dumpLineNumbers
48Type: `String`
49Default: false
50
51Configures -sass-debug-info support.
52
53Accepts following values: `comments`, `mediaquery`, `all`.
54
55## relativeUrls
56Type: `boolean`
57Default: false
58
59Rewrite urls to be relative. False: do not modify urls.
60
61## report
62Choices: `false` `'min'` `'gzip'`
63Default: `false`
64
65Either do not report anything, report only minification result, or report minification and gzip results. This is useful to see exactly how well Less is performing, but using `'gzip'` can add 5-10x runtime task execution.
66
67Example ouput using `'gzip'`:
68
69```
70Original: 198444 bytes.
71Minified: 101615 bytes.
72Gzipped:  20084 bytes.
73```
Note: See TracBrowser for help on using the repository browser.