What is jPhpsass ?
This is a plugin of CSSprepro which is itself an htmlresponse plugin for Jelix.
Under Jelix default configuration, create (if missing) a "CSSprepro" directory in your project's "plugins" directory. Clone this repository in that directory with :
git clone --recursive email@example.com:brice-t/jPhpsass.git
Note that you should have your app plugin directory in your modulesPath (defaultconfig.ini.php or entry point's config.ini.php) to get it working. The value should be at least :
When including a CSS file (e.g. with addCSSLink()) you should set 'sass'=>true as a param.
Another way of having a file compiled with Sass is including as file with .scss or .sass extension. You can set expected extensions in the comma-separated value of CSSprepro_jPhpsass_extensions under the jResponseHtml section.
E.g. in your response :
$this->addCSSLink($gJConfig->urlengine['basePath'].'themes/'.$gJConfig->theme.'/Css/style.sassFile', array( 'sass' => true ));
Your config file must activate jPhpsass plugin :
N.B. : the directories containing Sass files should be writable by your web server ! Indeed, compiled files will be written in that very same directory so that relative urls go on working ...
You can configure jPhpsass's behviour regarding compilation:
[jResponseHtml] ;... ; always|onchange|once CSSprepro_jPhpsass_compile=always
If CSSprepro_jPhpsass_compile's value is not valid or empty, its default value is onchange.
- always : compile Sass file on all requests
- onchange : compile Sass file only if it has changed
- once : compile Sass file once and never compile it again (until compiled file is removed)