Unmaintained

this project is no longer maintained but a fork is: https://gitlab.com/haynes/libsass-maven-plugin

Libsass Maven Plugin

Libsass Maven Plugin uses libsass to compile sass files. Uses jsass to interface with C-library.

Changelog:

0.2.10 - upgraded libsass to 3.5.3
0.2.9 - upgraded libsass to 3.4.7
- refreshed output files for eclipse
- enhanced error output with failing files - thanks to @VsevolodGolovanov
0.2.8 - upgraded libsass to 3.4.4
- used compilation classpath for including webjars
- fixed issue with os-dependent path-separator (using ';' for every OS)
- plugin now aware of incremental builds
0.2.7 - upgraded libsass to 3.4.3
- added webjar support - thanks to @flipp5b
0.2.6 - upgraded libsass to 3.4.0
- added libsass:watch goal to watch and recompile include directory - thansk to @lorenzodee
0.2.5 - added copySourceToOutput, changed default outputstyle to 'nested', upgraded libsass to 3.3.6
0.2.4 - fixed bug with empty spaces in path
0.2.3 - upgrade to libsass 3.3.4
0.2.2 - minor bugfixes, readded m2e lifecycle mapping
0.2.1 - updated libsass to 3.3.3
0.2.0 - switched native bindings to bit3 bindings (using libsass 3.3.2), java8-only
0.1.7 - UTF8 encoding issue, used wrong file extension for sass style
0.1.6 - added m2e eclipse intergation, thanks @dashorst
0.1.5 - readded macOs binaries, thanks @tommix1987
0.1.4 - added contained libsass-version to artifact-version (e.g. 0.1.4-libsass_3.2.4-SNAPSHOT).
- switched to new libsass API (sass_context.h)
- removed image_path option (because of #420)
- added failOnError flag to skip errors and continue the build, if wanted
0.1.3 - fixed #10 - multi-module projects
0.1.2 - added PR #4, updated to libsass version 3.1 for windows, linux, macos - thanks to @npiguet, @ogolberg
0.1.1 - scss files can now be placed in inputpath/ directly
0.1.0 - changed artefact group to com.github.warmuuh

Installation

libsass-maven-plugin is available on central-repository since version 0.1.2

Usage

Configure plugin in your pom.xml:

<build>
   <plugins>
      <plugin>
         <groupId>com.github.warmuuh</groupId>
         <artifactId>libsass-maven-plugin</artifactId>
         <version><VERSION>-libsass_3.4.4</version>
         <executions>
            <execution>
               <phase>generate-resources</phase>
               <goals>
                  <goal>compile</goal>
               </goals>
            </execution>
         </executions>
         <configuration>
            <inputPath>${basedir}/src/main/sass/</inputPath>
            <outputPath>${basedir}/target/</outputPath>
            <includePath>${basedir}/src/main/sass/plugins/</includePath>
         </configuration>
      </plugin>
   </plugins>
</build>

Alternatively, you can use the watch goal to have the plugin watch your files and recompile on change:

mvn com.github.warmuuh:libsass-maven-plugin:<version>-libsass_3.4.4:watch

Configuration Elements

Element	Default value	Documentation
outputPath	`${project.build.directory}`	The directory in which the compiled CSS files will be placed.
inputPath	`src/main/sass`	The directory from which the source `.scss` files will be read. This directory will be traversed recursively, and all `.scss` files found in this directory or subdirectories will be compiled.
includePath	`null`	Additional include path, ';'-separated
outputStyle	`nested`	Output style for the generated css code. One of `nested`, `expanded`, `compact`, `compressed`. Note that as of libsass 3.1, `expanded` and `compact` result in the same output as `nested`.
generateSourceComments	`false`	Emit comments in the compiled CSS indicating the corresponding source line. The default value is `false`.
generateSourceMap	`true`	Generate source map files. The generated source map files will be placed in the directory specified by `sourceMapOutputPath`.
sourceMapOutputPath	`${project.build.directory}`	The directory in which the source map files that correspond to the compiled CSS will be placed
omitSourceMapingURL	`false`	Prevents the generation of the `sourceMappingURL` special comment as the last line of the compiled CSS.
embedSourceMapInCSS	`false`	Embeds the whole source map data directly into the compiled CSS file by transforming `sourceMappingURL` into a data URI.
embedSourceContentsInSourceMap	`false`	Embeds the contents of the source `.scss` files in the source map file instead of the paths to those files
inputSyntax	`scss`	Switches the input syntax used by the files to either `sass` or `scss`.
precision	`5`	Precision for fractional numbers
enableClasspathAwareImporter	`false`	Enables classpath aware importer which make possible to `@import` files from classpath and WebJars. For classpath resources use `@import 'path/to/resource/in/classpath';`. For WebJar resources a shortcut can be used: `@import '{package}/{path}';` imports resource `META-INF/resources/webjars/{package}/{version}/{path}`.
failOnError	`true`	should fail the build in case of compilation errors.
copySourceToOutput	`false`	copies all files from source directory to output directory

License

MIT License.