Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/warmuuh/libsass-maven-plugin
libsass wrapper for maven
https://github.com/warmuuh/libsass-maven-plugin
java libsass maven sass
Last synced: 10 days ago
JSON representation
libsass wrapper for maven
- Host: GitHub
- URL: https://github.com/warmuuh/libsass-maven-plugin
- Owner: warmuuh
- Created: 2014-03-21T13:56:19.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2023-08-15T17:42:52.000Z (over 1 year ago)
- Last Synced: 2025-01-16T12:32:57.110Z (17 days ago)
- Topics: java, libsass, maven, sass
- Language: Java
- Size: 6.15 MB
- Stars: 115
- Watchers: 8
- Forks: 41
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Unmaintained
this project is no longer maintained but a fork is: https://gitlab.com/haynes/libsass-maven-plugin
Libsass Maven Plugin [](https://travis-ci.org/warmuuh/libsass-maven-plugin) [](https://mvnrepository.com/artifact/com.github.warmuuh/libsass-maven-plugin)
==========
Libsass Maven Plugin uses [libsass](http://github.com/hcatlin/libsass) to compile sass files.
Uses [jsass](https://github.com/bit3/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](https://github.com/sass/libsass/issues/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:
```
com.github.warmuuh
libsass-maven-plugin
-libsass_3.4.4
generate-resources
compile
${basedir}/src/main/sass/
${basedir}/target/
${basedir}/src/main/sass/plugins/
```
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:-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.