SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 217 visiteurs en ce moment

Accueil > Squelettes > Outils pour squelettes > BootStrap pour SPIP > BootStrap pour SPIP

BootStrap pour SPIP

18 mars 2015 – par Cerdic – 37 commentaires

Toutes les versions de cet article : [English] [français]

19 votes

Documentation source http://spipr.nursit.com/bootstrap

Présentation

PNG - 39.6 ko

BootStrap est un framework qui facilite et accélère le développement Front-End. Il inclue

  • une base CSS très complète (au format LESS) configurée à partir d’un fichier de variables
  • un ensemble de conventions de structure HTML et de nommage de classes
  • des librairies javascripts simples pour les fonctions les plus courantes

BootStrap dispose d’une documentation détaillée qui facilite sa prise en main.

BootStrap pour SPIP

Un plugin BootStrap pour SPIP facilite l’intégration de BootStrap v2. Le plugin intègre toutes les CSS de BootStrap (v2.3.2) et y ajoute une couche d’adaptation à SPIP.

Adaptation au markup de SPIP

Le plugin intègre les CSS de BootStrap sans modification, mais y ajoute une couche d’adaptation au HTML générée par SPIP. Ainsi, les formulaires de SPIP qui utilisent un markup HTML différent de celui proposé par BootStrap bénéficient tout de même des styles de BootStrap. Si vous ajoutez vos propres formulaires, vous pouvez aussi bien utiliser le markup de BootStrap ou celui de SPIP, selon vos habitudes.

Les tableaux générés par SPIP à partir du contenu éditorial héritent aussi des styles de BootStrap.

De plus le plugin adapte le markup de la pagination de SPIP pour qu’elle bénéficie des styles de BootStrap.

Typographie

La typographie proposée nativement par SPIP dans son squelette par défaut est de meilleure facture que celle de BootStrap. Elle est également plus accessible car implémentée en em et non en px.
Le plugin BootStrap pour SPIP reprend donc la partie typographie de SPIP pour ces raisons.

#grid
PNG - 8.3 ko

Le plugin BootStrap pour SPIP intègre également l’outil de visualisation de la grille #grid. Il permet aux webmestres d’afficher la grille utilisée. Il est configuré pour se caler par défaut sur les 3 grilles de BootStrap (en fonction de la largeur de l’écran) et vous pouvez donc directement l’utiliser.

LESS
PNG - 12.5 ko

Pour permettre de travailler directement dans les feuilles de styles au format LESS sans passer par une étape de compilation manuelle, le plugin BootStrap nécessite le plugin LessCSS pour SPIP qui se charge de compiler automatiquement à la volée les feuilles LESS au format CSS.

BootStrap dans SPIPr

Tous les styles de BootStrap sont inclus dans les pages du squelette SPIPr, et il est donc possible d’utiliser l’ensemble du markup proposé dans la documentation de BootStrap et de bénéficier des styles et affichages prévus.
Dans le cas des formulaires, il est possible aussi d’utiliser la convention de balisage proposée dans SPIP, qui est intégralement prise en charge par l’adaptation de BootStrap à SPIP.

En revanche, la plupart des javascripts de BootStrap ne sont pas intégrés par défaut et vous devrez donc les ajouter dans vos squelettes pour utiliser les fonctionnalités correspondantes de BootStrap.

Page de démonstration

Le plugin BootStrap pour SPIP intègre plusieurs pages de démonstration dans le dossier demo/.

La page principale de démonstration est visible à l’adresse spip.php?page=demo/bootstrap [1]. Cette page reprend tous les éléments d’interface pris en charge par BootStrap, ainsi qu’une charte typographique qui permet de vérifier l’affichage de tous les enrichissements typographiques usuels.

PNG - 68.2 ko
Page de démonstration du plugin BootStrap

Organisation des fichiers

Le plugin BootStrap pour SPIP est organisé en deux sous dossiers bootstrap/ et bootstrap2spip/ :

 bootstrap/
 	 bootstrap/
 	 	 css/
 	 	 	 fichiers LESS de BootStrap
 	 	 img/
 	 	 	 images glyphicons de BootStrap
 	 	 js/
 	 	 	 fichiers javascripts de BootStrap
 	 bootstrap2spip/
 	 	 css/
 	 	 	 surcharges des fichiers LESS de BootStrap
 	 	 	 boot-theme.less feuille vide dispo pour la personnalisation
 	 	 	 bootswatch.less feuille vide dispo pour la personnalisation
 	 	 	 spip.css quelques styles spécifiques au code généré par SPIP
 	 	 	 spip.list.less styles du module de liste
 	 	 	 spip.comment.less styles des commentaires
 	 	 formulaires/
 	 	 	 charter.html formulaire SPIP de démonstration
 	 	 	 recherche.html formulaire de recherche SPIP adapté à BootStrap
 	 	 js/
 	 	 	 hashgrid.js #grid
 	 	 	 html5.js support de HTML5 pour les vieux navigateurs
 	 	 modeles/
 	 	 	 modèles de pagination SPIP adaptés à BootStrap

Surcharges des feuilles LESS

Le dossier bootstrap2spip/ contient des feuilles de style LESS qui surchargent celles de BootStrap. Voyons un exemple concret avec la feuille alerts.less :

Ici on voit que la surcharge pour SPIP utilise complètement le fichier natif de BootStrap en lui ajoutant simplement quelques définitions qui héritent de BootStrap. C’est le cas de la plupart des surcharges du dossier bootstrap2spip/ à l’exception de la typographie complètement reprise de SPIP.

Utiliser la surcharge

Lors de la compilation des fichiers LESS, le plugin LessCSS interprète chaque directive @import en recherchant le fichier demandé dans le chemin de SPIP, incluant les plugins et le dossier squelettes/.

Ainsi, si vous écrivez @import "css/alerts.less", SPIP va rechercher le fichier css/alerts.less dans squelettes/ puis dans tous les dossiers déclarés par les plugins.
Dans le plugin BootStrap, la recherche se fera d’abord dans le dossier bootstrap2spip/ pour voir si une surcharge spécifique à SPIP existe, puis dans bootstrap/ pour prendre le fichier natif de BootStrap sinon.

Vous pouvez donc personnaliser finement les surcharges de BootStrap de la façon suivante :
Par exemple

  • vous pouvez annuler l’adaptation à SPIP pour le fichier css/alerts.css en mettant le contenu suivant dans squelettes/css/alerts.css :
  • vous pouvez compléter l’adaptation à SPIP avec vos propres compléments. Pour le fichier css/alerts.css, en mettant le contenu suivant dans squelettes/css/alerts.css :

De manière générale, il faut éviter de surcharger des fichiers LESS de BootStrap pour bénéficier des mises à jour de ces fichiers lors de la mise à jour du plugin.

Pour la personnalisation de son site, il est préférable d’utiliser les 2 fichiers css/boot-theme.less et css/bootswatch.less qui ont été ajoutés et sont par défaut vides. Ils permettent d’ajouter des personnalisations CSS de BootStrap, qui seront compilées avec l’ensemble des feuilles de BootStrap (ce qui permet d’utiliser tous les mixins de BootStrap).

Images dans les feuilles LESS

Un point auquel il faut faire attention avec les feuilles LESS concerne les chemins relatifs vers les images de décoration : le fonctionnement est différent de ce qu’on peut avoir l’habitude dans les feuilles CSS.

Dans une feuille CSS, si on utilie le code url(../img/deco.png) le chemin relatif ../img/deco.png s’interprète par rapport à l’emplacement du fichier CSS.

Dans une feuille LESS, avec le même code, le chemin relatif s’interprète par rapport à l’emplacement du fichier LESS principal compilé. Cela fait une différence importante lorsque la directive @import est utilisée.
En effet, dans ce cas c’est toujours l’emplacement du fichier principal, celui qui fait les @import, qui est pris en référence, et non l’emplacement du fichiers inclus, même si c’est lui qui référence l’image.

Dans le cas de BootStrap, cela veut dire que c’est l’emplacement du fichier bootstrap.less qui est pris en compte. Ainsi, pour utiliser une image dans un fichier LESS personalisé de BootStrap, il convient de donner un chemin relatif par rapport au fichier bootstrap.less.

La solution consiste alors à copier le fichier bootstrap.less dans votre dossier squelettes/, à côté de votre fichier personnalisé, sans oublier d’y copier aussi le dossier img/ avec les glyphicons. C’est assez peu pratique, et de manière générale c’est évitable en ajoutant les images de décoration dans un fichier LESS qui n’est pas inclus par bootstrap.less mais directement par le squelette SPIPr.

Notes

[1il faut avoir le statut de webmestre pour voir cette page

[2Attention à la version de BootStrap que les outils supportent : lorsque c’est une version plus ancienne que celle utilisée par SPIPr, certaines variables peuvent manquer dans les feuilles générées

Dernière modification de cette page le 18 mars 2015

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 27 juin à 16:02, par En réponse à : BootStrap pour SPIP

    J’ai cette erreur avec le plugin Bootstrap 3 (en version=« 3.0.9 »)

    LESS : Echec compilation fichier plugins/bootstrap3/bootstrap2spip/css/grid.less
    .make-grid-columns is undefined in /www/plugins/bootstrap3/bootstrap/css/grid.less

    Comment la corriger svp ?

    Répondre à ce message

  • Le 13 mai à 00:20, par Amire En réponse à : BootStrap pour SPIP

    Bonjour,

    Je ne sais pas par où commencer. Est ce qu’il y a un tuto pour les Novis ?

    • Le 5 juin à 15:38, par jpcrea En réponse à : BootStrap pour SPIP

      Bonjour,

      Les 2 plugins installés (Bootstrap et scssphp) et activés, aller dans plugins/auto/bootstrap3_sass/demo/bootstrap.html qui vous fait découvrir toutes les possibilités du plugin. Recopier le code bootstrap.html, pour tester dans la page sommaire.html, par exemple, dans ../squelettes/sommaire.html, à la racine de votre site, et appeler ensuite sommaire.html.
      Vous avez là un modèle de structure des squelettes de votre site.

    • Le 8 juin à 00:03, par Amire En réponse à : BootStrap pour SPIP

      Bonjour,

      après l’activation du scssphp, j’ai eu ça comme erreur :

      Fatal error : Cannot redeclare balise_CSS() (previously declared in /homepages/.../plugins/auto/lesscss/v1.0.11/lesscss_fonctions.php:246) in /homepages/..../plugins/auto/scssphp/scssphp_fonctions.php on line 230

      Donc je ne sais pas quoi faire de ça :
      Dans scssphp_fonctions.php :

      1. function balise_CSS($p) {
      2. $_css = interprete_argument_balise(1,$p);
      3. $p->code = "timestamp(direction_css(scss_select_css($_css)))";
      4. $p->interdire_scripts = false;
      5. return $p;
      6. }

      Télécharger

      et ça dans
      lessscss_fonctions.php :

      1. function balise_CSS($p) {
      2. $_css = interprete_argument_balise(1,$p);
      3. $p->code = "timestamp(direction_css(lesscss_select_css($_css)))";
      4. $p->interdire_scripts = false;
      5. return $p;
      6. }

      Télécharger

      Merci.

    • Le 9 juin à 14:29, par jpcrea En réponse à : BootStrap pour SPIP

      Je ne sais pas non plus.
      Que se passe-t-il en désactivant le plugin lesscss ?

    • Le 9 juin à 18:13, par Amire En réponse à : BootStrap pour SPIP

      Bonjour,

      En désactivant le plugin lesscss, Bootstrap se désactive aussi avec !!

    • Le 10 juin à 09:39, par jpcrea En réponse à : BootStrap pour SPIP

      Je travaille actuellement sur un site avec ce plugin, j’ai donc :

      • Un SPIP 3.1.4
      • Bootstrap 3-SASS
      • SCSS PHP

      C’est tout ce que j’ai comme plugins pour faire fonctionner Bootstrap avec SPIP.
      Vous pouvez télécharger et valider Bootstrap 3 de votre site, si vous avez un fichier /auto
      et Bootstrap 3-SASS et SCSS PHP seront téléchargés et installés au même instant.

    • Le 10 juin à 11:46, par Amire En réponse à : BootStrap pour SPIP

      Effectivement c’est la version de Bootstrap qui dépends de Lesscss qui a tout bloqué.
      J’ai utilisé la version que vous m’avez conseillé et ça fonctionne.
      Donc maintenant j’utilise le dossier squelettes pour personnaliser mon site en utilisant Bootstrap ? Est ce que vous avez d’autre conseils ?

      Merci jpcrea

    • Le 10 juin à 13:25, par jpcrea En réponse à : BootStrap pour SPIP

      Dans vos différentes pages html ,Vous devrez respecter les différents liens du « head » de la page demo.html placés dans le plugin afin d’activer le css et javascript de bootstrap.
      Bonne continuation !

    Répondre à ce message

  • Le 12 février à 12:41, par beno En réponse à : BootStrap pour SPIP

    Bonjour,

    Je voulais signaler qu’a priori GIS4 (dernière version) avec Bootstrap 3 (intégré via le « TRUNK ») sur un SPIP 3.1.3. semble ne pas afficher les icônes de placement...

    • Le 14 février à 09:53, par beno En réponse à : BootStrap pour SPIP

      Sur ce post, erreur venant d’entre la chaise et le clavier, désolé pour le bruit.

    Répondre à ce message

  • Le 12 février à 13:51, par beno En réponse à : BootStrap pour SPIP

    Re-bonjour,

    Autre soucis, celui-là est moins trivial. Voilà le code, qui fonctionne parfaitement sous Wamp :

    1. <img src="[(#FICHIER|image_passe_partout{600,300}|image_recadre{600,300,center}|extraire_attribut{src})]" class="img-fluid img-thumbnail">

    Or, en ligne, je n’arrive pas à cumuler passe_partout et recadre. C’est soit l’un, soit l’autre, mais pas les deux à la suite... pour info, la class=« » n’influe pas sur les résultats...

    Quelqu’un aurait-il une idée d’où cela peut venir ?

    • Le 14 février à 09:36, par beno En réponse à : BootStrap pour SPIP

      Réponse :
      lors du transfert de BDD (du développement en local au serveur distant), certains paramètres sautent. Dont la gestion des images. Il fallait donc recocher la gestion GD2 et la production de vignettes.

    Répondre à ce message

  • Le 7 août 2016 à 19:58, par Michel En réponse à : BootStrap pour SPIP

    Bonjour,
    je viens d’installer le plugin bootstrap et je voudrais partir de ceci :
    http ://getbootstrap.com/examples/jumbotron/

    Ça ne fonctionne pas chez moi. La navbar s’affiche correctement, mais pas les trois colonnes qui s’affichent les unes en-dessous des autres, de même que le jumbotron qui ne fonctionne pas. Y a-t-il quelque chose à ajouter au plugin ou dans mes css ou javascript ?

    Merci

    Michel.

    • Le 4 octobre 2016 à 14:06, par Michelle En réponse à : BootStrap pour SPIP

      Ce plugin BootStrap pour SPIP utilise une version obsolète de Bootstrap, alors que la page que tu cites http://getbootstrap.com est sur la version actuelle.

      BootStrap pour SPIP est sur le vieux Bootstrap v2 tandis que Bootstrap est en train de passer en v4.

      Probablement la cause de tes ennuis

    Répondre à ce message

  • Le 29 juin 2016 à 20:22, par Thomas En réponse à : BootStrap pour SPIP

    Bonjour,

    J’ai un problème avec mon formulaire d’envoi de mail avec le plugin Formulaire de contact avancé 0.15.8.. la génération du bloc de prévisualisation (à l’issue de la rédaction du mail -> OK) semble rentrer en conflit avec autre chose.. Cela se traduit par une disparition du formulaire, l’apparition des textes dans toutes leur langues (idem dans le menu)...
    Le formulaire est dans une flex-box dans un col-lg-6...

    -  > Spip 3.1.0
    -  > Bootstrap 3.0.6
    -  > Less css 1.0.7
    -  > Menu de langues avec liens 1.2.4
    ( > FullPages.js.. mais bon..)

    Un avis ? Une idée ? M’aider....?
    Merci

    Répondre à ce message

  • Le 19 juin 2016 à 16:04, par Thomas En réponse à : BootStrap pour SPIP

    Bonjour,

    En travaillant sur un site en local (wamp) avec Spip 3.1, bootstrap3 et Lesscss v1.0.7, je remarque que les recalculs de pages prennent un temps fou...
    L’onglet ’réseau’ de Firebug me montre en effet que le systeme fait se charger 12 fois le « GET ?var_mode=recalcul » et qu’à chaque fois cela prend dans les 11s.... Donc plus de 2mn au total..
    Et je vois que c’est exactement la même chose sur la page démo du plugin : voir la capture jointe.

    Je découvre Bootstrap et Less adapté à Spip et je ne vois pas où corriger cela... Wamp est-il en cause ?

    Bref auriez-vous une idée ?

    Merci beaucoup

    Répondre à ce message

  • Le 19 mars 2015 à 18:53, par Pierrox En réponse à : BootStrap pour SPIP

    Bonjour,

    Génial, Je l’utilise depuis quelques temps avec vos méthodes d’écriture de squelette « spipR/zcore » et c’est vraiment un plaisir d’écrire et de maintenir les templates spip. Ce que je prefère avec ce plugin c’est la typographie qui est tout simplement parfaite.
    Le seul bémol, c’est le système de grille responsive qui est un peu moins pratique que sur la version 3 de bootstrap.

    A ce propos, Y a t’il un chantier ou des réflexions pour l’intégration de la version 3 de Boostrap en plugin ?

    Merci beaucoup, Pierre

    • Le 20 mars 2015 à 08:13, par Cerdic En réponse à : BootStrap pour SPIP

      Je prévois de préparer une version BootStrap3, avec une couche de compatibilité pour les sites qui auront été développés avec cette version du plugin qui repose sur BS2, mais je n’ai pas encore commencé ce chantier, à venir dans les prochains mois certainement.

    • Le 27 avril 2016 à 18:50, par Marc En réponse à : BootStrap pour SPIP

      Bonjour,

      Je vais sûrement me faire enguirlander, mais Mars 2015 c’est loin maintenant ? non ?

      un bootstrap + récent ?

    • Le 27 avril 2016 à 21:14, par Cerdic En réponse à : BootStrap pour SPIP

      En effet, la dernière version du plugin est en BootStrap 3 http://zone.spip.org/trac/spip-zone/browser/_plugins_/bootstrap/trunk
      Le zip ne va pas tarder, mais la doc est à mettre à jour, ce que je n’ai pas encore fait. C’est utilisable cependant.

    • Le 29 avril 2016 à 11:05, par Marc En réponse à : BootStrap pour SPIP

      merci je m’en vais mettre en oeuvre çà au + vite !

    Répondre à ce message

  • Le 29 mars 2016 à 23:29, par RastaPopoulos En réponse à : BootStrap pour SPIP

    Yo,
    les citations de Bootstrap 2 et 3 sont pas compatibles avec le plugin Orthotypo.

    Ce dernier ajoute des <small class="fine"> pour gérer les espaces fines. Sauf que Bootstrap fout un display block et un gros tiret devant tous les small… (pour gérer la source). Dans le 3 ils ont ajouté footer… mais laissé small quand même.

    Et dans tous les cas : même si c’est pas Orthotypo qui le rajoute, dans une longue citation (ce à quoi sert blockquote), il peut tout à fait y avoir des trucs en « small » utilisés.

    Donc il faudrait sûrement laissé footer mais virer complètement ce small dans notre adaptation « bootstrap2spip ».

    (Et sinon j’ai pas pigé les dossiers : j’ai bien compris que tu as ajouté un préfixe différent pour B3, mais… la version avec préfixe « bootstrap3 » a DEUX trunk : bootstrap/trunk + bootstrap3/trunk sont tous les deux « bootstrap3 ».)

    Répondre à ce message

  • Le 26 février 2016 à 08:30, par Patrick En réponse à : BootStrap pour SPIP

    Bonjour,
    quelle est la classe css à utiliser dans la déclaration du plugin menu pour déclancher l’appartion du menu bootstrap ?
    navbar-responsive ?
    navbar ?
    rien ?
    autre chose ?
    Pour le moment je n’arrive pas à l’afficher correctement.
    Spip3.1 et les bootstrap installés.
    Je n’ai pas non plus d’affichage de la demo . Est ce que j’ai manqué une étape ?
    Bonne journée et merci

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • LinkCheck : vérificateur de liens

    13 février 2015 – 94 commentaires

    Ce plugin permet de chercher et tester l’ensemble des liens présents dans les objets. Vous pourrez donc en quelques clics connaître les liens brisés ou défectueux qui se sont immiscés dans le contenu de votre site SPIP. La vérification s’effectue en (...)

  • Serveur HTTP abstrait

    25 novembre 2013 – commentaires

    Un plugin-outil pour aider les développeurs à implémenter des API orientées REST, basées sur les méthodes HTTP (get, post, put, delete). Ce plugin a pour but premier de normaliser des URL que l’on pourra appeler pour manipuler les données du site. À (...)

  • Agenda Fullcalendar facile

    29 octobre 2016 – 33 commentaires

    Dans un précédent article, nous expliquions comment afficher un agenda Fullcalendar sur son site avec le plugin agenda. Cependant, ceci nécessite des manipulation de squelettes, ce qui n’est pas toujours évident lorsqu’on débute. La présente (...)

  • Acces Restreint 3.0

    11 décembre 2008 – 804 commentaires

    Le plugin accès restreint permet de définir et de gérer des zones de l’espace public en accès restreint. Cette version du plugin a été redévelopée et optimisée tout spécialement pour SPIP 2.0. Il en découle une amélioration des performances sur les gros (...)

  • Abonnements

    31 janvier 2015 – 18 commentaires

    Gérer des abonnements à des offres, et uniquement cela. Ce plugin a pour but de regrouper tout ce qui est commun aux différents types d’abonnements possibles (à des zones restreintes, à des contenus précis, à une version papier pourquoi pas (...)

Ça spipe par là