Go to file
Maïeul 98485f5140 Fix #2
Ne pas recalculer si _VAR_MODE défini mais vide (cas des POST).
Note : pas de possibilité d'utiliser les sucres syntaxiques PHP7,
puisque compatible PHP 5.6.
2021-02-01 15:11:19 +01:00
demo 1.3.3 2016-12-14 08:23:29 +00:00
inc Mise a jour de ScssPHP et refactoring utilisation du compiler pour definir find-in-path() de maniere plus perenne 2020-11-11 12:21:34 +01:00
lang [Salvatore] [source:lang/ paquet-scssphp] Export depuis https://trad.spip.net de la langue en 2020-01-29 17:29:17 +00:00
lib/scssphp Mise a jour de la lib ScssPHP pour correction du bug sur le reparsing de selecteurs 2020-12-07 15:49:20 +01:00
prive/bouton oups : pas besoin du bouton avec minibando 2017-02-09 10:12:17 +00:00
spip-cli Oups, donc : il manquait le spip-cli dans 0ee4fe7 2020-08-19 16:24:26 +02:00
.gitattributes [Salvatore] [source:lang/ paquet-scssphp] Export depuis https://trad.spip.net de la langue fr 2020-01-20 13:49:15 +00:00
paquet.xml Mise a jour de la lib ScssPHP pour correction du bug sur le reparsing de selecteurs 2020-12-07 15:49:20 +01:00
readme.md Complement de doc 2020-08-19 17:18:40 +02:00
scssphp-32.png Logo SVG et suppression du PNG grand format du coup 2019-11-27 16:09:15 +00:00
scssphp-64.png Logo SVG et suppression du PNG grand format du coup 2019-11-27 16:09:15 +00:00
scssphp-xx.svg Logo SVG et suppression du PNG grand format du coup 2019-11-27 16:09:15 +00:00
scssphp_fonctions.php Fix #2 2021-02-01 15:11:19 +01:00
scssphp_options.php Version 2.0 du plugin : 2019-05-10 08:52:43 +00:00

readme.md

SCSSPHP pour SPIP 3.1+

Compile en CSS et mets en cache un fichier SCSS (https://sass-lang.com/) grace au compilateur ScssPHP https://scssphp.github.io/scssphp/

Le plugin requiert PHP 5.6 ou plus

Permet d'utiliser des feuilles de style scss dans ses squelettes et thèmes, et permet d'utiliser notamment le plugin BootStrap4 https://git.spip.net/spip-contrib-extensions/bootstrap4

Exemple

Inclusion du fichier css/scss_demo.scss dans un squelette SPIP

[<link rel="stylesheet" href="(#CSS{css/scss_demo.css})" type="text/css" />]

La balise #CSS

  • gère le mélange des feuilles .css et .scss : on peut surcharger une feuille .css d'un squelette par une feuille .scss
  • compile les feuilles .scss à la volée automatiquement
  • applique automatiquement les filtres |direction_css|timestamp

Exemple complet d'utilisation dans un squelette : https://git.spip.net/spip-contrib-squelettes/spipr-dist/src/branch/master/inclure/head.html

Demo

Appel de la démo via ./?page=demo/test_scss (logé administrateur)

Utilisation sur poste de développement avec xDebug

Si l'extension PHP xDebug est activée, la compilation des SCSS est très lente car le compilateur demande beaucoup de calcul. Il est alors possible d'échapper à cette lenteur en compilant en cli pour utiliser une instance PHP sans xdebug.

Pour cela

  • il faut avoir installé spip-cli https://contrib.spip.net/SPIP-Cli
  • il faut que la commande exec() soit autorisée
  • il faut ajouter dans son fichier mes_options.php la ligne
define('_SCSSPHP_SPIP_CLI_COMPILE', true);

Si besoin il est possible de definir le path de spip-cli via une seconde ligne (par défaut c'est /usr/local/bin/spip)

define('_SCSSPHP_SPIP_CLI_BIN', '/path/to/spip');

Cette fonctionnalité permet aussi d'executer la compilation SCssPHP sur une version PHP plus récente que celle utilisée pour afficher le site

define('_SCSSPHP_SPIP_CLI_BIN', '/path/to/php /path/to/spip');

Par ailleurs, on exclus ainsi la compilation PHP des profilage PHP quand on veut faire une analyse de performance avec le profileur xdebug.

Références