Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gabrysbiz/lesscss-compiler
A Java library which compiles Less source files to the CSS code.
https://github.com/gabrysbiz/lesscss-compiler
compiler java-library less lesscss
Last synced: about 1 month ago
JSON representation
A Java library which compiles Less source files to the CSS code.
- Host: GitHub
- URL: https://github.com/gabrysbiz/lesscss-compiler
- Owner: gabrysbiz
- License: other
- Archived: true
- Created: 2015-02-15T01:32:23.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-12-26T12:11:01.000Z (almost 6 years ago)
- Last Synced: 2024-09-25T19:41:30.508Z (about 1 month ago)
- Topics: compiler, java-library, less, lesscss
- Language: Java
- Homepage: http://lesscss-compiler.projects.gabrys.biz/
- Size: 15.7 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# About
[](http://lesscss-compiler.projects.gabrys.biz/license.txt)
[](https://travis-ci.org/gabrysbiz/lesscss-compiler)
The LessCSS Compiler is a Java library which compiles [Less](http://lesscss.org/) source files to [CSS](http://www.w3.org/Style/CSS/) code.
From [Less](http://lesscss.org/) website:
> Less is a CSS pre-processor, meaning that it extends the CSS language, adding features that allow variables,
> mixins, functions and many other techniques that allow you to make CSS that is more maintainable, themable
> and extendable.
# Compatibility
The compiler is compatible with version [1.7.5](https://github.com/less/less.js/releases/tag/v1.7.5).
The library is based on the official [Less](http://lesscss.org/) JavaScript compiler adapted to the
[Rhino](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino) engine.
It supports sources located at:
* local drives
* protocols:
* [HTTP](https://www.w3.org/Protocols/) and HTTPS
* [FTP](https://www.w3.org/Protocols/rfc959/) (requires [Apache Commons Net](https://commons.apache.org/proper/commons-net/) library in the class path)
* class path (prefix `classpath://`)
* custom - defined by programmers (see [FileSystem](http://lesscss-compiler.projects.gabrys.biz/2.0.1/apidocs/index.html?biz/gabrys/lesscss/compiler2/filesystem/FileSystem.html))
# Requirements
The compiler to run requires:
* Java 8 or higher
* Third-Party Dependencies ([see list](http://lesscss-compiler.projects.gabrys.biz/2.0.1/dependencies.html))
# Download
You can download the library from [this page](http://lesscss-compiler.projects.gabrys.biz/2.0.1/download.html)
or using various [dependency management tools](http://lesscss-compiler.projects.gabrys.biz/2.0.1/dependency-info.html).
# Concept
The library contains two compilers:
* [NativeLessCompiler](http://lesscss-compiler.projects.gabrys.biz/2.0.1/apidocs/index.html?biz/gabrys/lesscss/compiler2/NativeLessCompiler.html) is a compiler with a shell-type API
* [LessCompiler](http://lesscss-compiler.projects.gabrys.biz/2.0.1/apidocs/index.html?biz/gabrys/lesscss/compiler2/LessCompiler.html) is a facade for the `NativeLessCompiler` with a developer-friendly API
The idea for the `NativeLessCompiler` class was based on the [lesscss-java](https://github.com/marceloverdijk/lesscss-java)
library by [Marcel Overdijk](https://github.com/marceloverdijk).
# Usage
The `LessCompiler` contains 32 methods. Below is an example of how to use some of them:
```java
String cssCode = null;
LessOptions options = null;
// create compiler
LessCompiler compiler = new LessCompiler();
// compile source code
cssCode = compiler.compileCode(".basic { display: block; }");
// compile source code with custom options
options = new LessOptionsBuilder().ieCompatibilityOff().build();
cssCode = compiler.compileCode(".basic { display: block; }", options);
// compile source file specified by path
cssCode = compiler.compile("http://www.example.org/style.less");
// compile source file
cssCode = compiler.compile(new File("source.less"));
// compile source file specified by path and save CSS code in an output file
compiler.compile("http://www.example.org/style.less", new File("output.css"));
// compile source file and save CSS code in an output file
compiler.compile(new File("source.less"), new File("output.css"));
// compile source file and compress CSS code
cssCode = compiler.compileAndCompress(new File("source.less"));
// compile source file specified by path and compress CSS code using custom encoding
cssCode = compiler.compileAndCompress("http://www.example.org/style.less", Charset.forName("UTF-8"));
// compile source code and generate inline source map
cssCode = compiler.compileCodeWithInlineSourceMap(".basic { display: block; }", new LessOptions());
// compile source file and generate source map (save it in output.map file)
options = new LessOptionsBuilder().sourceMapBasePath("basePath").build();
compiler.compileWithSourceMap(new File("source.less"), new File("output.css"), new File("output.map"), options);
// compile source file specified by path and generate source map (save it in output.css.map file)
compiler.compileWithSourceMap("http://www.example.org/style.less", new File("output.css"), options);
```