Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eyedouble/erlsass
Compile Sass/Scss implemented as Erlang NIF using libsass.
https://github.com/eyedouble/erlsass
c erlang library nif sass scss
Last synced: about 1 month ago
JSON representation
Compile Sass/Scss implemented as Erlang NIF using libsass.
- Host: GitHub
- URL: https://github.com/eyedouble/erlsass
- Owner: eyedouble
- License: mit
- Created: 2018-03-30T11:28:56.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-07-17T17:51:24.000Z (over 6 years ago)
- Last Synced: 2024-09-29T03:42:10.408Z (about 2 months ago)
- Topics: c, erlang, library, nif, sass, scss
- Language: C++
- Size: 1.47 MB
- Stars: 1
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# erlsass
Compile Sass/Scss implemented as Erlang NIF using **libsass 3.5.1**.
## Known to work on:
- Ubuntu 17.10
- Ubuntu 16.04
- Fedora 27
- Windows 10 x64 (Compile via MinGW gcc) *See usage on Windows section below*
## Prerequisites
- gcc
- g++
*Please note that that Windows is only supported with Erlang/OTP 21.0 and higher. Since this release the folder containing the nif's dll is automatically added to the dll search path (OTP-14666). Erlsass uses this functionality to load it's depencency. Should you require Erlsass on Windows with a Erlang version lower than 21 feel free to use release 1.1.0.*
*Please note on fedora and possibly other linux distro's that use yum as package manger the g++ compiler is called gcc-c++*
## Install
Simply add `erlsass` to the `rebar.config` file of your application and add to your `application.src` file.
## API
### compile/2
#### Compile a file and return result as string
Default compilation style is compressed see compile/4 for options.
```erlang
erlsass:compile ( file, "foo/bar/style.scss" ).
>> {ok, "body{color:#000;}"}
```
### compile/3
#### Compile a file and return result as string and specify comilation style
Style options:
- Compact
- Compressed
- Expanded
- Nested
```erlang
erlsass:compile ( file, "foo/bar/style.scss", "compressed" ).
>> {ok, "body{color:#000;}"}
````
### compile_write/3 & compile_write/4
#### Compile a file and write result to a file
```erlang
erlsass:compile_write ( file, "foo/bar/style.scss", "foo/bar/style.css", "compressed" ).
>> ok
erlsass:compile_write ( file, "foo/bar/style.scss", "foo/bar/style.css").
>> ok
```
### version/0
#### Retrieve version info
```erlang
erlsass:version().
>> {ok, "Erlsass:x.x.x;Libsass:x.x.x"}
```
## Usage on Windows
To build erlsass on Windows 64bit you need to provide GNU gcc and g++ compilers.
Follow the steps below:
1. Download [MinGW64 for Windows 64bit](http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/4.9.2/threads-win32/seh/x86_64-4.9.2-release-win32-seh-rt_v3-rev0.7z/download) , and unzip to `C:\mingw64`.
2. Add `C:\mingw64\bin` to your Path environment variable. ( On Windows 10: Open the Start menu, type `environment` in the results click on `Edit environment variables for your account`. Select the `Path` entry and click on `Edit`. )
3. Open CMD or Powershell and execute `gcc --version`. It should show you the gcc version that is present. Do the same for g++. You are now done, please see the section **Install** to continue.
4. Note that the latest version of Erlsass on Windows is only compatible with Erlang/OTP 21 or higher.