Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/paginagmbh/lesscss-java

LESS CSS Compiler for Java
https://github.com/paginagmbh/lesscss-java

css java less lesscss

Last synced: 4 months ago
JSON representation

LESS CSS Compiler for Java

Awesome Lists containing this project

README 

        
----



> This is a fork of https://github.com/marceloverdijk/lesscss-java/ which doesn't seem to be maintained anymore.

> We updated the lesscss library to 1.7.5 and fixed some small bugs.

> Feel free to use this fork but be aware that it is neither published on maven.org nor do we actively support this fork! Issues are closed.



----



Official LESS CSS Compiler for Java

===================================



**Latest release**  1.7.5.0 - The release is compatible with less 1.7.5 



LESS CSS Compiler for Java is a library to compile LESS sources to CSS stylesheets.



The compiler uses Rhino, Envjs (simulated browser environment written in JavaScript), and the official LESS JavaScript compiler.



Look at the simple example below to compile LESS to CSS:

 

    // Instantiate the LESS compiler

    LessCompiler lessCompiler = new LessCompiler();



    // Instantiate the LESS compiler with some compiler options

    LessCompiler lessCompiler = new LessCompiler(Arrays.asList("--relative-urls", "--strict-math=on"));

    

    // Compile LESS input string to CSS output string

    String css = lessCompiler.compile("@color: #4D926F; #header { color: @color; }");

    

    // Or compile LESS input file to CSS output file

    lessCompiler.compile(new File("main.less"), new File("main.css"));



LessCompiler is thread safe. In other words, an application only needs one LessCompiler that it can reuse whenever necessary.



To learn more about LESS, please see http://lesscss.org/.



Getting Started

---------------



Download the latest version and add it to the project's classpath. Also the following dependencies are required:



+ Apache Commons IO 2.4

+ Apache Commons Lang 3.1

+ Rhino: JavaScript for Java 1.7R4



If [SLF4J](http://www.slf4j.org/) is present in the classpath, it will be used for logging.



Compatibility

-------------



The LESS CSS Compiler for Java contains all LESS compatibility tests. All tests pass, except the @import test case which fails partially as the compiler does not support the media query import feature (yet).



The project also contains integration tests for compiling the Twitter Bootstrap (http://twitter.github.com/bootstrap/) library. If you are using another 3th party LESS library you want to be added to the integration tests, just create a issue and provide a link to the library.



Building From Source

--------------------



Can be built with [Maven 2.2.x](http://maven.apache.org) (or later?) by using the following commands:



    mvn package



or, to install into your local Maven repository:



    mvn install

    

You may also wish to build API Documentation:



    mvn javadoc:javadoc



Release an update (in a forked repo)

------------------------------------



For this reason, in this fork the *maven-gpg-sign* process is set to skip during `mvn release:prepare` and the produced JARs aren't signed!



Run the following from a Git Bash where GitHub login via SSH key is enabled:



    mvn release:prepare

	mvn release:perform



This will create JAR bundles, a git version tag and commit and push itself to this repo.



Authors

-------



**Marcel Overdijk**

+ [email protected]

+ http://twitter.com/marceloverdijk

+ http://github.com/marceloverdijk



**Craig Andrews**

+ [email protected]

+ http://candrews.integralblue.com



**Christophe Popov**

+ http://twitter.com/chpopov

+ http://uk.linkedin.com/in/hpopov/



**Tobias Fischer** (pagina GmbH)

+ https://github.com/tofi86

+ https://github.com/paginagmbh



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.