BliP 3, documentation du webmestre

Cet article contient la documentation technique sur BliP 3. Si vous souhaitez installer SPIP & BliP, puis paramétrer et personnaliser BliP alors il vous suffit de lire la documentation.

Avant propos

La version 3.x de BliP ne fonctionnera QUE sur une version 2.X de SPIP.

BliP est développé pour répondre au besoin de son auteur, et il est developpé en général sur la version SVN de SPIP (Version de développement de SPIP, instable en théorie).

C’est pour cette raison, que BliP est distribué sous forme d’un ZIP incluant toutes les versions "qui vont bien" de SPIP et des plugins indispensables.

Pré requis pour utiliser SPIP & BliP

Pour créer votre propre son propre site web avec SPIP et BliP, il faut vérifier que vous disposez bien des ressources techniques nécessaires :

• un hébergement web dynamique vous autorisant à programmer en PHP et vous proposant une base MySQL, comme par exemple un 60GP chez OVH ;
• un bon logiciel FTP, de préférence un logiciel libre (FileZilla recommandé) ;
• quelques connaissances en informatique, une bonne maîtrise du transfert ftp notamment.

SPIP et BliP sont deux logiciels libres, gratuits, diffusés sous licence GNU / GPL. Le seul coût à supporter correspond à l’hébergement du site internet et à l’éventuel dépôt d’un nom de domaine. Ce qui donne, à titre indicatif :

• 0 €/an si l’hébergeur est free.fr, mais ça risque d’être lent et pas toujours opérationnel… (Choisir Free est fortement déconseillé, vous risquez de rencontrer certains jours des erreurs sans queue ni tête, et le débugage sera impossible !!!) ;
• Moins de 20€ si l’hébergeur est OVH (sur un 60GP) avec un nom de domaine, un vrai ;
• vous pouvez aussi consulter la liste des hébergeurs acceptant Spip.

Installer un nouveau site sous SPIP

Cette section détaille explique en détail l’installation de SPIP. Si vous souhaitez installer SPIP + BliP, alors une méthode simplifié existe.

L’opération se déroule en quatre étapes :

1. récupérer l’archive compressée contenant le logiciel libre SPIP. Il est impératif de récupérer une version de SPIP compatible avec BliP 3, c’est à dire une version 2.X de SPIP. Les versions de SPIP compatibles avec BliP sont également télécheargeable depuis le site de développement de BliP.
2. décompresser cette archive en local, sur votre ordinateur ;
3. installer le logiciel SPIP en suivant la procédure décrite en ligne (voir les liens ci-dessous) ;
4. vérifier que SPIP est bien installé.

Liens utiles vers la documentation de référence :

• installer SPIP ;
• effectuer une mise à jour ;

En cas de problème pendant l’installation de SPIP

Premières mesures à prendre avant d’appeler à l’aide la communauté SPIP :

1. Vérifier que votre hébergeur accepte bien le logiciel SPIP ;
2. Recommencer l’installation en téléchargeant à nouveau les fichiers vers le serveur par ftp;
3. Si votre problème ne se résout pas encore, alors vous avez besoin d’aide :
   1. Google sera votre ami, il vous suffira en général de taper comme mots-clefs "spip" et quelques mots significatifs du message d’erreur ou, mieux, le nom de votre hébergeur ;
   2. Si vous n’avez pas trouvé de réponse pertinente avec Google, vous pouvez alors poser vos questions en envoyant un message sur la liste de diffusion de SPIP. Mais avant de poster votre message, lisez attentivement ceci :

Cette liste est destinée à toutes les questions autour de l’utilisation de SPIP. C’est la liste sur laquelle vous aurez le plus de chances d’obtenir de l’aide.

Il s’agit donc de notre liste principale : si vous êtes webmestre d’un site SPIP, rédacteur d’un site SPIP, et que vous voulez discuter de différents problèmes liés à l’utilisation de SPIP, c’est là qu’il faut vous rendre…

Si vous débutez avec SPIP, nous vous conseillons vivement de vous abonner à cette liste des utilisateurs (tout cela est évidemment gratuit). Cette liste est désormais très animée, réactive, et vous y obtiendrez rapidement de nombreux conseils et des réponses à toutes sortes de questions.

Extrait de la page d’accueil de SPIP.

Résumons :

• Avant de poster une question, assurez-vous d’avoir lu un minimum la documentation de SPIP : il est très désagréable de voir des messages dont la réponse est contenue en toutes lettres dans la documentation du logiciel ;
• Toujours avant de poster, faites donc une petite recherche sur Google en choisissant judicieusement vos mots-clefs ;
• En postant, soyez précis (pas de message du style “ça marche pas”), poli, courtois et, surtout, patient ;
• Et n’hésitez pas à vous inscrire / désinscrire à la liste de diffusion de SPIP : c’est simple, rapide, convivial et surtout efficace.

Une fois l’installation réussie

Une fois que tout c’est bien déroulé et que tout semble fonctionner, vous pouvez utiliser SPIP :

• Soit avec le squelette par défaut qui est d’une sobriété (et donc d’une tristesse) totale, mais qui ne nécessite aucune manipulation supplémentaire ;
• Soit avec le squelette BliP, que vous devez alors installer ;
• Soit avec un autre squelette au choix :
  • voir la liste des squelettes pour SPIP.
• Soit en développant vos propres squelettes :
  • Pensez alors à les télécharger sur SpipContrib pour les partager avec la communauté.

Installer un nouveau site sous BliP 3

Cette section détaille explique en détail l’installation de BliP. Si vous souhaitez installer SPIP + BliP, alors une méthode simplifié existe.

Une version de SPIP compatible avec BliP 3, c’est à dire une version 2.X de SPIP doit préalablement avoir été installée.

Une version de CFG compatible avec BliP 3, c’est à dire une version 1.3.6 de CFG doit préalablement avoir été installée.

Installer par ftp les fichiers du squelette BliP

Une opération vite accomplie :

1. Télécharger l’archive compressée contenant les fichiers du squelette BliP ;
2. Décompresser cette archive en local sur votre ordinateur ;
3. Créer un dossier nommé « plugins » à la racine de votre installation de SPIP
4. Télécharger par ftp [1] le dossier nommé « blip3 » sur votre serveur web, dans le dossier « plugins » préalablement crée. [2].

L’arborescence de vos dossiers sur votre ftp devrait ressembler à ceci :

• racine de votre site
  • config
  • dist
  • ecrire
  • IMG
  • local
  • plugins
    • cfg
    • blip3
  • prive
  • tmp

Installation propre ou installation existante

Si vous installez BliP sur une nouvelle installation de SPIP ou si vous utilisiez les squelettes par défaut, cette section ne vous concerne pas.

Si vous aviez déjà des squelettes personnalisés en fonction sur votre site, il va vous falloir les désactiver pour que BliP fonctionne.

Cas 1 : Si votre squelette est installé dans le dossier « squelettes » à la racine de votre hébergement, il vous suffit de le renommer (en « squel », par exemple) pour le désactiver.

Cas 2 : Si votre squelette est installé dans un dossier autre que « squelettes », vous devez alors soit supprimer le fichier mesoptions.php, soit supprimer le fichier mesfonctions.php (n’oubliez pas d’en garder une copie sur votre ordinateur).

Cas 3 : Si vous avez déjà une version de BliP installée, vous pouvez effacer le dossier « blip » qui se trouve dans le répertoire « plugins », après avoir désactivé le plugin BliP 2.x

Finaliser l’installation du squelette BliP en quelques clics

 Connectez vous à la partie privée de votre site depuis un compte administrateur [3] :

1. Pointez votre souris sur l’onglet « Configuration » et cliquez sur le sous-onglet « Gestion des plugins » ;
2. Cochez la case intitulée « Activer le plugin » située sur la ligne « Squelette BLiP 3 pour spip 2.X » ;
3. Cliquez sur le bouton « Valider » ;

Voilà, l’installation du squelette est terminée. L’onglet « visiter » vous affichera le résultat. (vous devrez peut-être « recalculer la page » ou vider le cache de spip.)

Et maintenant ? Il ne vous reste plus qu’à écrire et publier des articles.

Désinstaller le squelette BliP en quelques clics

A tout moment, vous pouvez désinstaller le squelette BliP. Pour ce faire, connectez-vous à la partie privée de votre site depuis un compte administrateur :

1. Pointez votre souris sur l’onglet « Configuration » et cliquez sur le sous-onglet « Gestion des plugins » ;
2. décochez la case intitulée « Activer le plugin » située sur la ligne « Squelette BLiP 3 pour spip 2.X » ;
3. cliquez sur le bouton « Valider ».

Le squelette est alors désactivé. Vous pouvez aussi supprimer par ftp le dossier nommé « blip3 » précédemment installé dans le dossier « plugins ».

Installer un nouveau site sous SPIP + BliP 3

Cette section détaille explique en détail l’installation de SPIP et de BliP en même temps, il s’agit de la procédure la plus simple suggérée aux débutants.

L’opération se déroule en cinq étapes :

1. Récupérer l’archive compressée contenant SPIP BLIP CFG et THICKBOX, cette archive est téléchargeable depuis le site de développement de BliP et se nomme de la manière suivante : SPIP_BLIP_CFG_THICKBOX_vx.zip.

2. Décompresser cette archive en local, sur votre ordinateur.

3. Envoyer par ftp [4] le contenu du dossier nommé « spip » sur votre serveur web.

L’arborescence de vos dossiers sur votre ftp devrait ressembler à ceci :

• racine de votre site
  • config
  • dist
  • ecrire
  • IMG
  • local
  • plugins
    • cfg
    • blip3
    • thickbox
  • prive
  • tmp

4. Procéder à l’installation de SPIP :

Se connecter avec le navigateur sur le site, dans un dossier intitulé « ecrire », adresse du type : http://adresse_du_site/ecrire puis suivre les instructions d’installation.

Lors de la première connexion à cette adresse, une procédure d’installation pas-à-pas démarre. L’interface est très simple, il suffit d’entrer les informations demandées (essentiellement les informations concernant la base de données mySQL indiquées au début). Une fois que c’est terminé, le système vous demande l’identification que vous avez indiquée et vous pouvez commencer à gérer votre site. Par la suite, c’est toujours dans ce dossier « /ecrire » que vous irez travailler, muni de vos codes d’identification.

Si vous rencontrez des difficultés :

• Installer SPIP
• Comment résoudre mon problème.

5. Procéder à l’installation de BliP et des autres plugins

 Connectez vous à la partie privée de votre site depuis un compte administrateur [5] ;

1. Pointez votre souris sur l’onglet « Configuration » et cliquez sur le sous-onglet « Gestion des plugins » ;
2. Cochez toutes les cases situées devant :
   1. Squelette BLiP 3 pour spip 2.X
   2. Activer le plugincfg : moteur de configuration
   3. Thickbox v2
3. Cliquez sur le bouton « Valider » ;

Voilà, l’installation de SPIP et du squelette BliP est terminée.

L’onglet « visiter » vous affichera le résultat. (vous devrez peut-être « recalculer la page » ou vider le cache de spip.)

Publier avec SPIP & BliP, le B-A BA

Pour afficher du contenu sur votre site : /ecrire > À suivre

1. Créer une rubrique,
2. Publier un article dans cette rubrique.

Les articles publiées s’affichent sur la page « actualités », sur la page « articles » et sur les pages relatives aux mots clés attachées à l’article.

Pour créer le menu de droite de votre site : /ecrire > Édition > Mots-clés

1. Créer un groupe de mots clés,
2. Créer un mot clé dans ce groupe de mots clés,
3. Attacher ce mot clé à un ou plusieurs articles déjà publiés.

Le menu de droite est composé des titres des groupes de mots clés numérotés (lire ci dessous).

Comprendre le fonctionnement de BliP 3

Avant de continuer la lecture et le paramétrage, je vous invite à lire ces deux articles, qui explique rapidement le fonctionnement et les spécificités du squelette BliP.

SPIP : Abandonner les rubriques au profit des mots clés ...

puis

BliP 3, les concepts clés à comprendre ...

Gérer les groupes de mots clés

Pour gérer les groupes de mots clés : Édition > Mots-clés

Nom des groupes de mots-clés :

Si vous créez un groupe de mots clés dont le nom commence par un numéro, alors ce nom apparaitra dans un menu de navigation du site.

Le nom d’un groupe de mots clés non numéroté ne s’affichera dans aucun menu de navigation.

Comprendre le tableau :

J’ai crée le groupe de mots clés "Thématiques" dans lequel je vais mettre tous les thèmes que je vais traiter sur mon site.

Si je renomme ce groupe en "6. Thématiques" ou "61. Thématiques" ou "625. Thématiques", alors dans les trois cas il s’affichera sur le menu horizontal et dans la dernière colonne du menu horizontal.

Si je renomme ce groupe en "1. Thématiques" ou "12. Thématiques" ou "189. Thématiques", alors dans les trois cas il affichera la listes des mots clés attachés à thématiques en haut à gauche.

Si je renomme ce groupe en "7. Thématiques", il ne s’affichera que dans la dernière colonne du menu horizontal, sans arborescence.

Si je renomme ce groupe en "9. Thématiques" ou "92. Thématiques" ou "989. Thématiques", alors dans les trois cas il affichera la listes des mots clés attachés à thématiques dans le pied de page ...

Astuce : Le numéro permet de choisir l’ordre d’affichage dans le menu (620 sera affiché avant 650 ...)

* Fonctionnalité pas encore codée

Descriptif rapide des groupes de mots-clés :

Le descriptif est affiché en ligne, et il est également utilisé pour le référencement.

Texte explicatif des groupes de mots-clés :

Le texte explicatif n’est pas affiché en ligne, vous pouvez l’utiliser pour expliquer comment utiliser tel ou tel groupe de mots clés.

Espace de développement de BliP

BliP est developpé sur un espace Google Code, sous SVN.

BliP sous SVN, comment ça marche ?

SVN (de son petit nom « subversion ») est un système permettant de gérer le développement d’un programme et d’en suivre l’évolution pas à pas.

A lire :

• Sur Wikipédia : Subversion (logiciel)
• Sur cent20.net : Tutoriel Le B-A BA de l’utilisation de SVN sur windows
• Sur spipzine : Utiliser SVN sous Mac OS X avec svnX

Adresse du site de développement de BliP : http://code.google.com/p/blip3/

Téléchargements de SPIP, BliP etc

Vous pouvez télécharger BliP de deux manières différentes :

1. Des archives zip sont compilées et mise en ligne régulièrement, vous pourrez ainsi obtenir facilement BliP mais aussi SPIP, CFG, Thickbox ...

Les paquets nommés SPIP_BLIP_CFG_THICKBOX incluent le logiciel SPIP et les trois plugins conseillés : BLiP, CFG, THICKBOX.

Adresse de téléchargement : http://code.google.com/p/blip3/down...

2. Grâce à votre client SVN, vous pourrez récupérer la version de développement SVN de BliP.

L’adresse est : http://blip3.googlecode.com/svn/trunk/

En ligne de commande cela donne :

Bien entendu, il est rappelé qu’une version de développement ne doit pas être utilisée en production. (ce message concerne d’ailleurs les versions de dev de SPIP comme de BliP)

Signaler un BUG

Si vous rencontrez un problème, c’est sur ce site que vous devez le signaler.

• Voir toutes les issues
• Déclarer une nouvelle issue

Liste de discussion

Aucun support par courriel n’est assuré pour ces squelettes qui sont distribués gracieusement.

En cas de difficulté, faites appel aux autres utilisateurs et utilisatrices de ces squelettes, via la liste de discussion. Entr’aidez-vous !

Adresse de la liste de discussion : http://groups.google.com/group/blip

Les pages de configuration du squelette

/ecrire > Configuration > Squelette BliP

Vous pouvez personnaliser les copyright du bas de page, comme par exemple en mettant : Copyright © 2005-2008, Vincent ROBERT.

Vous pouvez également indiquer l’identifiant (le numéro) de l’article qui contient vos mentions légales, un lien nommé « Mentions légales » vers cet article sera alors crée en bas de page.

Configurer les services Google

/ecrire > Configuration > Squelette BliP > BliP 3 Google API

Vous pouvez désactiver les publicités et le moteur de recherche de google.

Pour le moteur de recherche, veuillez saisir une l’adresse de votre site sous la forme www.cent20.net (sans http://)

Pour les publicités, vous pouvez Votre saisir votre propre code Google AdSense, par défaut le code est pub-4097812111303206

Parce que vous l’utilisez ou que vous l’appréciez, vous pouvez si vous le souhaitez soutenir le développement du squelette BliP en laissant tel que le « code Google AdSense » de cette page et les publicités affichées sur votre site rémunèreront alors l’auteur du squelette.

Pour les statistiques, vous pouvez Votre saisir votre propre code Google Analytics, il s’agit d’un code ressemblant à UA-94666-1

Configurer les couleurs du site

/ecrire > Configuration > Squelette BliP > BliP 3 Couleurs

Pour changer une couleur, il vous suffit de cliquer sur l’un des codes dans la colonne couleur actuelle, et vous pourrez alors soit cliquer sur le cercle chromatique, soit saisir manuellement votre code.

Pour toutes questions, lire Support et liste de discussion sur BliP.

Notes :

[1] À l’aide de FileZilla, par exemple, ou de tout autre logiciel de transfert ftp.

[2] Attention, pour que l’installation fonctionne, il faut que le dossier « blip3 » soit un sous-dossier du dossier « plugins ».

[3] le compte avec lequel vous avez installé SPIP est un compte administrateur

[4] À l’aide de FileZilla, par exemple, ou de tout autre logiciel de transfert ftp.

[5] le compte avec lequel vous avez installé SPIP est un compte administrateur