JarCastingOfficial LESS CSS Maven Plugin
Latest release 1.7.0.1.1 - The 1.1 release that is compatible with less 1.7.0
Usage
Declare the plugin and its goals. The process-sources phase is bound to by default:
<plugin>
<groupId>org.lesscss</groupId>
<artifactId>lesscss-maven-plugin</artifactId>
<version>1.7.0.1.1</version>
<executions>
<execution>
<goals>
<goal>compile</goal>
</goals>
</execution>
</executions>
</plugin>
To run the compiler manually just execute: mvn lesscss:compile
Example configuration for web project
<plugin>
<groupId>org.lesscss</groupId>
<artifactId>lesscss-maven-plugin</artifactId>
<version>1.7.0.1.1</version>
<configuration>
<sourceDirectory>${project.basedir}/src/main/webapp/less</sourceDirectory>
<outputDirectory>${project.build.directory}/${project.build.finalName}/css</outputDirectory>
<compress>true</compress>
<includes>
<include>main.less</include>
</includes>
</configuration>
<executions>
<execution>
<goals>
<goal>compile</goal>
</goals>
</execution>
</executions>
</plugin>
All configuration options
-
outputDirectory
File- The directory for compiled CSS stylesheets. Default value is: ${project.build.directory}. -
sourceDirectory
File- The source directory containing the LESS sources. Default value is: ${project.basedir}/src/main/less. -
compress
boolean- When true the LESS compiler will compress the CSS stylesheets. Default value is: false. -
encoding
StringThe character encoding the LESS compiler will use for writing the CSS stylesheets. Default value is: ${project.build.sourceEncoding}. -
excludes
String[]- List of files to exclude. Specified as fileset patterns which are relative to the source directory. -
force
boolean- When true forces the LESS compiler to always compile the LESS sources. By default LESS sources are only compiled when modified (including imports) or the CSS stylesheet does not exists. Default value is: false. -
includes
String[]- List of files to include. Specified as fileset patterns which are relative to the source directory. Default value is: { "**/*.less" } -
lessJs
String- The location of the LESS JavaScript file. -
watch
boolean- When true the plugin watches the sourceDirectory and recompiles the included files after they changed. Instead of configuring it in the pom you can use that option at the command line like this "mvn lesscss:compile -Dlesscss.watch=true". Then it doesn't interfere with other maven lifecycle phases and you can just kill the watch process e.g. with crtl-c. Default value is: false. -
watchInterval
int- The interval in milliseconds the plugin waits between the check for file changes. Default value is: 1000 ms. -
outputFileFormat
String- The format of the output files. Default is: '{fileName}.css'. examples: '{fileName}.min.css', 'min-{fileName}.css', '{fileName}.anything'.
List sources
To list the LESS sources in your project the lesscss:list goal can be used. It lists the LESS sources and it's imports based on sourceDirectory and optionally includes and excludes configuration options.
Support
Have a question, or found an issue? Just create a issue: https://github.com/marceloverdijk/lesscss-maven-plugin/issues
Authors
Marcel Overdijk
Christophe Popov
Copyright and License
Copyright 2012 Marcel Overdijk
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.