Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fgiannesini/libsassgradleplugin
A gradle plugin to compile scss/sass with jsass (libsass wrapper for java)
https://github.com/fgiannesini/libsassgradleplugin
compass gradle libsass scss-files
Last synced: 3 months ago
JSON representation
A gradle plugin to compile scss/sass with jsass (libsass wrapper for java)
- Host: GitHub
- URL: https://github.com/fgiannesini/libsassgradleplugin
- Owner: fgiannesini
- License: unlicense
- Archived: true
- Created: 2016-03-28T15:52:53.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-03-16T14:58:36.000Z (almost 6 years ago)
- Last Synced: 2024-09-26T00:42:09.520Z (3 months ago)
- Topics: compass, gradle, libsass, scss-files
- Language: Java
- Size: 104 KB
- Stars: 8
- Watchers: 3
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# LibSassGradlePlugin
A gradle plugin to compile scss/sass with jsass (libsass wrapper for java)
- _Need Gradle Version >= 2.12_
- _Need Java Version >= 8_
## Available tasks
_1.0_
- **compileLibSass** : Compile sass/scss files to css (with optional source map) with LibSass
- **compileLibSassWithWatch** : Continuous compilation of sass/scss files to css (with optional source map) with LibSass
_1.1_
- **installBourbon** : import bourbon scss source files in current project
- **installCompass** : import compass scss source files in current project
_1.2_
- **compileLibSassProductionTask** : Compile sass/scss files to css (with optional source map) with LibSass and production configuration
## Next
- Maintenance
- Finding a better way to manage background process on task CompileLibSassWatcher
## Limitations
- **installCompass** : Source modifications are applied by the plugin to avoir compilation errors:
* Correct import path, compass uses absolute path, libsass needs relative path.
* Compass calls "prefix-usage", a ruby function from compass gem. An error is thrown by Libsass on compilation.
This function is used to make stats to avoid deprecated browser prefixes.
The choice here is to replace this function by a constant to always add prefixes even if they are deprecated.
(workaround: https://github.com/sass/libsass/issues/1936)
## Configuration
```groovy
apply plugin: 'java'
apply plugin: 'com.github.fgiannesini.libsass.gradle.plugin'
buildscript {
repositories {
mavenLocal()
mavenCentral()
}
dependencies {
classpath 'com.github.fgiannesini.libsass.gradle.plugin:libsass-gradle-plugin:+'
}
}
//Relative paths from resources can be used if target directory already exists, otherwise absolute path from project root should be used.
libSassParameters {
//Type: String Mandatory
//File path to compile (normally import other scss files)
//Can be overridden for production task
inputFilePath = "scss/input.scss"
//Type: String Mandatory
//Compiled file path
//Can be overridden for production task
outputFilePath = "css/output.css"
//Directory to watch for continuous compilation
watchedDirectoryPath = "scss"
//Type: Boolean Default: false
//'true' embeds the source map as a data URI
//Can be overridden for production task
sourceMapEmbed = true
//Type: Boolean Default: false
//'true' enables additional debugging information in the output file as CSS comments
//Can be overridden for production task
//sourceComments = false
//Type: Boolean Default: false
//'true' values disable the inclusion of source map information in the output file
//Can be overridden for production task
//omitSourceMappingURL = false
//Type: Boolean Default: false
//'true' includes the contents in the source map information
//Can be overridden for production task
//sourceMapContents = false
//Type: String Default: 'scss'
//Input syntax 'scss' or 'sass'
//Can be overridden for production task
//inputSyntax "scss"
//Type: Integer Default: 5
//Used to determine how many digits after the decimal will be allowed. For instance, if you had a decimal number of 1.23456789 and a precision of 5, the result will be 1.23457 in the final CSS.
//Can be overridden for production task
//precision 5
//Type: String
//Path of source file to generate if not embedded
//Can be overridden for production task
//sourceMapFilePath "css/output.css.map"
//Type: String Default: nested Values: nested, expanded, compact, compressed
//Determines the output format of the final CSS style.
//Can be overridden for production task
//outputStyle "nested"
//Type: String Default: ""
//Paths that LibSass can look in to attempt to resolve your @import declarations. When using data, it is recommended that you use this.
//';' is the path separator for Windows
//':' is the path separator for Linux
//Can be overridden for production task
//includePaths "scss-lib"
//Type: String
//Installation folder for bourbon sources
bourbonInstallationPath "scss"
//Type: String
//If a specific version of bourbon is necessary
//bourbonVersion "4.2.6"
//Type: String
//Installation folder for compass sources
compassInstallationPath "src/main/resources/scss"
//Type: String
//If a specific version of compass is necessary
//compassVersion "1.0.3"
//Override parameters for task "compileLibSassProduction"
libSassProductionParameters {
outputStyle "compressed"
outputFilePath = "src/main/resources/css/production/output.css"
}
}
```