Adds support for the Stylus CSS pre-processor to DocPad

Convention: .css.styl|stylus

docpad install stylus

The default configuration for this plugin is the equivalant of adding the following to your DocPad configuration file.

plugins:
	stylus:
		stylusLibraries:
			nib: true
		stylusOptions:
			compress: true
			'include css': true

# Disable compression on the development environment
environments:
	development:
		stylusOptions:
			compress: false

You can customise the options sent to stylus using the stylusOptions object. See the available options here.

By default we include the Nib Stylus Library.

Nib is a small and powerful library for the Stylus CSS language, providing robust cross-browser CSS3 mixins to make your life as a designer easier. By default nib support is enabled, but it can be disabled by setting the useNib option to false.

To use Nib, add the following to your main stylus file:

@import 'nib'

Alternatively, if you would prefer to use individual parts like gradient support, you can do this by using:

@import 'nib/gradients'

You can also turn off the inclusion of the Nib by setting the following:

plugins:
	stylus:
		stylusLibraries:
			nib: false

You can include your own custom libraries, providing you npm install them yourself.

To use the Axis Stylus Library instead of Nib, you first first install axis by doing:

npm install --save axis-css

Then update our DocPad configuration file with:

plugins:
	stylus:
		stylusLibraries:
			nib: false
			'axis-css': true

You can also customise the configuration sent to the library by doing the following, in this case, we set the axis implicit property to false:

plugins:
	stylus:
		stylusLibraries:
			nib: false
			'axis-css':
				implicit: false

You can discover the history inside the History.md file

You can discover the contributing instructions inside the Contributing.md file

Licensed under the incredibly permissive MIT License
Copyright © 2012+ Bevry Pty Ltd [email protected]
Copyright © 2011 Benjamin Lupton [email protected]