less.js-middleware
文件大小: unknow
源码售价: 5 个金币 积分规则     积分充值
资源说明:Connect Middleware for LESS.js compiling
This middleware was created to allow processing of [Less](http://lesscss.org) files for [Connect JS](http://www.senchalabs.org/connect/) framework and by extension the [Express JS](http://expressjs.com/) framework.

[![CircleCI](https://circleci.com/gh/emberfeather/less.js-middleware.svg?style=shield)](https://circleci.com/gh/emberfeather/less.js-middleware)
[![Dependency Status](https://david-dm.org/emberfeather/less.js-middleware.svg)](https://david-dm.org/emberfeather/less.js-middleware)

## Installation

```sh
npm install less-middleware --save
```

## Usage

```js
lessMiddleware(source, [{options}])
```

### Express

```js
var lessMiddleware = require('less-middleware');

var app = express();
app.use(lessMiddleware(__dirname + '/public'));
app.use(express.static(__dirname + '/public'));
```

### `options`

The following options can be used to control the behavior of the middleware:

Option Description Default
debug Show more verbose logging? false
dest Destination directory to output the compiled .css files. Same directory as less source files.
force Always re-compile less files on each request. false
once Only recompile once after each server restart. Useful for reducing disk i/o on production. false
pathRoot Common root of the source and destination. It is prepended to both the source and destination before being used. null
postprocess Object containing functions relevant to postprocessing data.
postprocess.css Function that modifies the compiled css output before being stored. function(css, req){...}
preprocess Object containing functions relevant to preprocessing data.
preprocess.less Function that modifies the raw less output before being parsed and compiled. function(src, req){...}
preprocess.path Function that modifies the less pathname before being loaded from the filesystem. function(pathname, req){...}
preprocess.importPaths Function that modifies the import paths used by the less parser per request. function(paths, req){...}
render Options for the less render. See the "render Options" section below.
storeCss Function that is in charge of storing the css in the filesystem. function(pathname, css, req, next){...}
cacheFile Path to a JSON file that will be used to cache less data across server restarts. This can greatly speed up initial load time after a server restart - if the less files haven't changed and the css files still exist, specifying this option will mean that the less files don't need to be recompiled after a server restart.
## `render` Options The `options.render` is passed directly into the `less.render` with minimal defaults or changes by the middleware. The following are the defaults used by the middleware:
Option Default
compress auto
yuicompress false
paths []
## Examples Common examples of using the Less middleware are available in the [wiki](https://github.com/emberfeather/less.js-middleware/wiki/Examples). ## Troubleshooting ### My less never recompiles, even when I use `{force: true}`! Make sure you're declaring less-middleware before your static middleware, if you're using the same directory, e.g. (with express): ```js var lessMiddleware = require('less-middleware'); var app = express(); app.use(lessMiddleware(__dirname + '/public')); app.use(express.static(__dirname + '/public')); ``` not ```js var lessMiddleware = require('less-middleware'); var app = express(); app.use(express.static(__dirname + '/public')); app.use(lessMiddleware(__dirname + '/public')); ``` ### IIS If you are hosting your app on IIS you will have to modify your `web.config` file in order to allow NodeJS to serve your CSS static files. IIS will cache your CSS files, bypassing NodeJS static file serving, which in turn does not allow the middleware to recompile your LESS files.

本源码包内暂不包含可直接显示的源代码文件,请下载源码包。