LESS pour SPIP: Less-CSS (anciennement LESSpip)

Less-CSS (Anciennement LESSpip) est un plugin intégrant facilement le logiciel LESS dans SPIP.

LESS est une extension de CSS ajoutant les variables, les classes, les opérations, les imbrications au langage. Facilitant ainsi l’écriture de feuilles de style complexes.

Il utilise le compilateur LESS pour PHP LessPhp

Utilisation du plugin

Ce plugin compile à la volée tous les fichiers .less.css ou .less du squelette qui contient #INSERT_HEAD. Vous pouvez aussi forcer la compilation d’un fichier ou d’une feuille de style calculée à l’aide du filtre |less_css.

Les fichiers générés sont mis en cache dans /local/cache-less

Le langage LESS

LESS est une extension de CSS ajoutant les variables, les classes, les opérations, les imbrications au langage. Facilitant ainsi l’écriture de feuilles de style complexes.

La documentation officielle (http://lesscss.org) offre de bons exemples de ce qu’il est possible de faire avec LESS :

Variables:

@brand_color: #4D926F;
 
#header {
  color: @brand_color;
}
 
h2 {
  color: @brand_color;
}

Mixins

.rounded_corners (@radius: 5px) {
  -moz-border-radius: @radius;
  -webkit-border-radius: @radius;
  border-radius: @radius;
}
 
#header {
  .rounded_corners;
}
 
#footer {
  .rounded_corners(10px);
}

Nested rules:

#header {
  color: red;
  a {
    font-weight: bold;
    text-decoration: none;
  }
}

Operations

@the-border: 1px;
@base-color: #111;
 
#header {
  color: @base-color * 3;
  border-left: @the-border;
  border-right: @the-border * 2;
}
 
#footer { 
  color: (@base-color + #111) * 1.5;
}

La balise #CSS

Le plugin introduit une nouvelle balise #CSS qui cherche les fichiers .css ou .less du même nom pour les compiler en fichier .css statique.

Exemple d’utilisation

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

La balise va chercher un fichier css/style.less ou css/style.css ou css/style.css.html pour retourner un fichier css classique interprétable.

Depuis la version 1.2.3 du plugin (Octobre 2018), le plugin permet d’activer une nouvelle valeur css pour forcer le recalcul des squelettes CSS,
en affichant un bouton d’administration supplémentaire pour &var_mode=css.

updated on 2 October 2019

Discussion

21 discussions

  • 2

    La dernière mise à jour de Lesscss provoquait le message d’erreur
    « parse error unexpected [ in .../lesscss_fonctions.php ligne 154 »
    Je n’ai pas su trouver l’erreur en examinant le fichier (rev 117659) mais j’ai fini par le remplacer par sa version précédente (rev 114181) ce qui fait disparaître le problème.
    Comme je ne disposais pas de la version précédente de lesscss, j’ai simplement remplacé le fichier php, les autres fichiers restant ceux de la dernière distribution.
    A ce sujet, pouvoir télécharger la version n-1 de chaque plugin serait un avantage.

    • C’est une syntaxe utilisée dans les dernières versions de PHP.

      J’ai corrigé sur la version 1.4.4 du plugin.

      Pour les versions n-1 des plugins: ca attendra la fin du travail / reflexion sur les outils de dev communautaires de SPIP.

    • La version 1.4.4 fonctionne sans problème pour moi.
      Merci pour la réactivité ainsi que pour tout ce que vous faites (sans oublier les autres développeurs de la communauté SPIP).

    Reply to this message

  • Au niveau du compilateur, il nous a été conseillé de désactiver la ligne suivante :

    $out = "/*\n#@".implode("\n#@",$files)."\n*"."/\n" . $out;

    En effet, cette ligne provoque l’affichage des chemins absolus dans les fichiers générés, par exemple :

    /*
    #@/home/monsiteweb/www/plugins/bootstrap3/bootstrap2spip/css/variables.less
    #@/home/monsiteweb/www/plugins/bootstrap3/bootstrap/css/mixins.less
    #@/home/monsiteweb/www/plugins/bootstrap3/bootstrap/css/mixins/hide-text.less
    #@/home/monsiteweb/www/plugins/bootstrap3/bootstrap/css/mixins/opacity.less
    #@/home/monsiteweb/www/plugins/bootstrap3/bootstrap/css/mixins/image.less
    .....

    ce qui permet d’identifier le chemin absolu du serveur.
    Serait-il possible de rendre cet affichage paramétrable dans la configuration du plugin svp ?

    Reply to this message

  • 2

    Bonjour à tous

    J’ai créé un plugin qui se base sur SPIPr en y ajoutant des fonctionnalités qui me sont propres.

    Le squelette de SPIPr prévoie la possibilité à d’autres plugins de pouvoir injecter du CSS grâce à la balise #INSERT_HEAD_CSS. Pour cela, on doit utiliser le pipeline correspondant pour s’insérer dans le flux.

    Sauf que mon plugin utilise du LESS. Comment injecter du LESS dans le flux ?

    J’ai codé ça :

    function monplugin_insert_head_css($flux)
    {
            $css = find_in_path('css/monplugin.less');
            $flux .= "[<link rel='stylesheet' type='text/css' media='all' href='(#CSS{$css})]' />\n";
    
            return $flux;
    }

    mais ça sort mal dans le HTML. Le compilateur LESS n’est pas appelé évidemment :

    [<link
    rel='stylesheet' type='text/css' media='all' href='(#CSSplugins/auto/monplugin/css/monplugin.less)]' />

    En fait, il faut compiler le LESS et injecter le CSS résultant.
    Peut-on le faire dans le pipeline ?

    • j’ai fait un essai : il est inutile de mettre la syntaxe des balises spip : manifestement, quand on cherche à inclure un fichier .less, SPIP cherche automatiquement à le compiler.
      Donc il faut écrire simplement :

       $flux .= "<link rel='stylesheet' type='text/css' media='all' href='.$css.' />\n";
    • Et bien ça alors ! ça marche !

      Et cela me mets bien le résultat de la compilation dans le flux des css comprimés.

      Gros MERCI Mikha.

    Reply to this message

  • 1

    Bonjour,

    J’utilise cette syntaxe dans une feuille CSS dynamique qui appelle une feuille less elle aussi dynamique :

    [(#PRODUIRE{fond=feuille.less,format=less}
    	|appliquer_filtre{less_css}
    	|file_get_contents
    )]

    En SPIP 3.1, ça marchait sans problème.

    En SPIP 3.2, même avec une feuille less vide, ça donne :
    LESS : Echec compilation

    ParseError: Unexpected input in anonymous-file-0.less on line 1, column 5 1| local/cache-less/lessdyn-feuille_less-da2c787c.less?1507482488

    Et le fichier en question n’a que ça ligne 1 :

    /* #PRODUIRE{fond=images/stylessoyezcreateurs_perso.less}
       md5:6a58a392d8734677136be268f6089153 */
    • J’ai trouvé : il fallait supprimer le timestamp avant de faire le filtre less :

      [(#PRODUIRE{fond=feuille.less,format=less}
      	|supprimer_timestamp	
      	|appliquer_filtre{less_css}
      	|file_get_contents
      )]

    Reply to this message

  • 1

    Hello :-)
    Bon, je ne suis pas sûr qu’il s’agit du bon forum, mais bo...
    php 5.6.30 sur mutu chez ovh
    J’ai un méchant bug, qui plante complètement SPIP 3.2.0-beta3 [23683] :-D

    En faite, au départ, je voulais mettre en route le squelette spipR https://plugins.spip.net/spipr_dist.html mais avec bootstrap3 sass https://zone.spip.org/trac/spip-zone/browser/_plugins_/bootstrap3_sass/trunk/paquet.xml

    Donc pour ce faire, j’ai télécharger et activer bootstrap3_sass puis, j’ai télécharger et activer spipr
    Le problème, c’est que spipr necessite spip-less
    Si bien que “svp” m’indique:
    Actions demandées :

    • Activer le plugin « SPIPr-dist » (version : 0.4.16)

    Les actions supplémentaires suivantes seront effectuées :

    • Activer le plugin « Z-core » (version : 2.6.3)
    • Activer le plugin « LESS CSS » (version : 1.0.11)
    • Activer le plugin « Comments » (version : 3.4.1)
    • Mise à jour du plugin « Bootstrap 3 - SASS » (de la version 1.0.0 à )
    Alors il y a sans doute un bug de “svp” car il n’est pas logique qu’il s’apprête à faire une mise à jour de bootstrap 3 - sass ( qui n’existe pas sur la zone) mais bon, peu importe, le problème, c’est surtout que après, cela me plante complètement spip en affichant comme message:

    Fatal error: Cannot redeclare balise_CSS() (previously declared in /home/.../auto/scssphp/v1.3.6/scssphp_fonctions.php:232) in /home/.../auto/lesscss/v1.0.11/lesscss_fonctions.php on line 251

    Je me doute que less css et scssphp sont incompatible, mais je pensais pas que spip planterait complètement non plus :-D

    • Effectivement, “Less CSS” et “ScssPhp” utilisent des fonctions qui ont le même nom, donc ça ne peut que planter.
      Il faut que tu supprimes “ScssPhp” par FTP.

    Reply to this message

  • 3

    J’aurais aimé utiliser des variables de configuration de spip dans mes fichiers less mais il ne me semble pas que cela fonctionne. Quelqu’un a t-il une idée de comment faire?
    par exemple j’aurais aimé pouvoir configurer certaines couleurs directement sur spip par un plugin.
    Merci pour votre aide

    • Bonjour, tombant juste sur ton message, une réponse très tardive qui peut servir à d’autres : oui c’est possible.

      Imaginons dans le dossier de squelettes un fichier styles.less où tu voudrais placer des balises SPIP.
      Il faut le renommer en styles.css.html, et ajouter ces 2 lignes au tout début :

      #HTTP_HEADER{Content-Type: text/css; charset=utf-8}
      #HTTP_HEADER{Vary: Accept-Encoding}

      Ensuite, il faut référencer la feuille de style au moyen de la balise #PRODUIRE et appliquer le filtre less_css :

      1. [<link rel="stylesheet" href="(#PRODUIRE{fond=styles.css}|less_css)" type="text/css" />]
    • Ah, et si au lieu de xxx.css.html on veut nommer ses fichiers xxx.less.html (plus logique), il faut ajouter l’option format=less à la balise #PRODUIRE:

      1. #PRODUIRE{fond=xxx.less, format=less}
    • Et comme j’ai eu le besoin d’inclure le résultat dans une autre CSS dynamique, voici la syntaxe :

      [(#PRODUIRE{fond=images/feuille.less,format=less}
      	|appliquer_filtre{less_css}
      	|file_get_contents
      )]

    Reply to this message

  • Hello,

    Pas de soucis de message d’erreur de mon coté, mais un très long temps de calcul à chaque modification des feuilles de style due aux nombreux css imbriqués.

    évidement, cela ne se produit que lorsque la variable var_mode=recalcul est passée. Mais c’est très handicapant pendant les périodes de développement.

    Quelqu’un a t’il des bonnes pratiques pour éviter ces temps de latence ? Peut-être une modification de la config du serveur pour accélérer les calculs ?

    Reply to this message

  • 2

    Bonjour,
    J’essaye d’installer SPIPr sur le site de mon établissement.
    Cependant, le menu de navigation ne s’affiche pas, et j’ai le message d’erreur suivant :

    Warning: Missing argument 1 for lesscss_select_css(), called in /web/l/e/lyc-rolland-goussainville/http/tmp/cache/skel/html_c5ebbd0ba795fd9c392eb1a859072bf5.php on line 182 and defined in /web/l/e/lyc-rolland-goussainville/http/plugins/auto/lesscss/v1.0.5/lesscss_fonctions.php on line 245

    La ligne 245 du fichier lesscss_fonctions.php correspond à :

    1. function lesscss_select_css($css_file){

    Je copie également le paragraphe avec les quelques lignes au-dessus et en dessous :

    /**
     * Selectionner de preference la feuille .less (en la compilant)
     * et sinon garder la .css classiquement
     *
     * @param string $css_file
     * @return string
     */
    function lesscss_select_css($css_file){
    	if (function_exists('less_css')
    	  AND substr($css_file,-4)==".css"){
    		$less_file = substr($css_file,0,-4).".less";
    		$less_or_css = lesscss_find_less_or_css_in_path($less_file, $css_file);
    		if (substr($less_or_css,-5)==".less")
    			return less_css($less_or_css);
    		else
    			return $less_or_css;
    	}
    	return find_in_path($css_file);
    }

    Quelqu’un aurait-il la solution à ce problème ?
    Merci par avance.

    • fred02840

      Alors ? SPIPr a-t-il pu être installé ? Car je bloque sur le même problème…

    • Bonjour,
      Oui le problème est résolu, j’avais posté la réponse sur le forum mais je n’avais plus pensé à le faire ici...
      Pour résoudre le problème j’avais fait deux modifications :

      • j’avais effacé le cache du site ;
      • j’avais vidé le dossier squelettes situé à la racine.

      Je crois que c’est surtout la seconde solution qui avait été décisive.

    Reply to this message

  • 4

    J’ai mis à jour un site de spip 3.0.17 en 3.0.20 et au passage j’ai aussi mis à jour less-css qui était en 0.7.11 avec la dernière version.
    Cependant mon site bug et je me retrouve avec un message d’erreur sur le site public:

    Warning: Missing argument 2 for Less_Functions::lighten() in /home/casptdkw/www/plugins/auto/less-css/less.php/Less.php on line 3166

    Fatal error: Call to undefined method Less_Tree_Expression::toHSL() in /home/casptdkw/www/plugins/auto/less-css/less.php/Less.php on line 3167

    J’ai été obligé de revenir en 0.7.11 pour faire fonctionner à nouveau mon site.
    Une idée de comment corriger le problème ?

    • Soucis similaire : site fonctionne avec 0.7.11 m’ais l’update en 1.0.5 ssuscite des erreurs de compilation de LESS.

    • Il semble que dans mon cas la nouvelle version soit simplement moins tolérante envers les erreurs de syntaxe (variables manquantes, etc.)

    • Et quels étaient tes erreurs ? car pour moi impossible de trouver d’ou viens le problème.

      Autant si je fais une faute de syntaxe, alors mon site apparait avec un erreur SPIP de compilation.
      Mis dès que je n’ai plus d’erreur pour moi; le site n’apparaît plus et j’ai à la place ces messages d’erreurs :(

    • Ok trouvé, il n’aimait pas les double opérations.
      Style: lighten(saturate(@lien,30%)10%;

    Reply to this message

  • Bonjour,

    Je débute en LESS.
    Doit-on passer toutes les feuilles de style de la dist en .less ou peut-on se contenter de créer une perso.less appellée dans l’inclure/head.html par :

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

    Si je ne me trompe pas, j’aurais donc dans squelettes/css/
    layout.css, style.css, typo.css, etc. et perso.less

    Est-ce bien cela?

    Merci d’avance.

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom