SPIP. Système de Publication pour l’Internet
SPIP, la conception de sites Web à la portée de tous.
Si vous avez déjà conçu des sites Web, vous avez pu constater que la tâche n’était pas aussi simple que vous pouviez la penser.
Avec SPIP, la création de sites est vraiment à la portée de tous.
Destiné à être utilisé de façon collaborative afin de partager les compétences de plusieurs webmasters, rédacteurs et graphistes, cet environnement de développement s’installe et s’emploie très facilement.
La mise en page des information saisies est automatique et la mise en place de forums de discution des plus simples…
Une description de SPIP, L’INTRO, cet excellent ouvrage de référence.
Je ne vais pas reprendre la présentation de cet ouvrage, déjà présenté par Boomtchak ici et ici et par Graphiland ici.
Cette description se déroule comme suit :
L’aperçu de la table des matières ;
Les chapitres du livre représentés par la première page de chacun de ces chapitres.
D’aucun diront que ce livre est une daube, mais si je l’avais eu à disposition, il m’aurait évité bien des galères, même si l’excellent site d’uZine nous est d’une aide précieuse, bien des interrogations subsistent.
Pour preuve le forum de SPIP.
Table des matières
Introduction 1
Les conventions de l’ouvrage 2
1. Installation 3
Travailler connecté ou hors connexion 3
Le choix de l’hébergeur 3
La préparation du terrain avant l’installation 5
L’installation de SPIP 6
– Installer automatiquement SPIP 6
– Installer manuellement SPIP 12
– Installer localement SPIP 16
2. Interface de développement 31
Espace privé et espace public 31
Les personnes qui participent à vie d’un site SPIP 32
– Les administrateurs 32
– Les auteurs 32
– Les graphistes 33
– Les visiteurs 33
L’espace de développement 33
Interface simplifiée et interface complète 35
Administration du site 39
Caractéristiques principales 39
Contenu de votre site 42
Fonctionnalités de SPIP 46
Obtenir de l’aide 49
– L’aide en ligne 49
– Les foires aux questions 52
– Les listes de diffusion 52
– Le forum 56
3. Mise en forme des contenus 59
Paragraphes et caractères 60
– Justification des paragraphes 60
– Alignement d’un texte 61
– Attributs de caractères 62
– Taille et couleur des caractères 63
– Les caractères spéciaux 66
– Titres et sous-titres 71
– Traits de séparation horizontaux 71
– Listes et énumérations 74
– Notes de bas de page 76
Liens hypertexte 77
– Liens à l’intérieur du site 78
– Liens vers un objet extérieur 79
Tableaux 79
Images 83
– Insérer des images via SPIP 84
– Votre hébergeur n’autorise pas la copie de fichiers via le Web 85
– Insérer des images via HTML 88
– Le format des images GIF 91
– Les images réactives 93
– Réaliser un lien au travers d’une image 97
Résumé des raccourcis typographiques 100
4. Premiers pas avec SPIP 103
Espace privé et espace public 103
Les rubriques 104
– Choisir le logo d’une rubrique 105
– Supprimer une rubrique 107
Les articles 107
– Statut d’un article 111
– Supprimer un article 113
– Rediriger un article 113
– Date de publication 114
– Choisir le logo d’un article 114
Les brèves 116
– Ajouter une brève 116
– Choisir le logo d’une brève 118
– Supprimer une brève 119
– Date de publication d’une brève 120
Faciliter la rédaction des articles et des brèves 120
Gestion des auteurs 124
– Informations sur les auteurs existants 124
– Définir un nouvel auteur 127
– Désactiver un auteur existant 127
– Changer le nom de l’auteur d’un article 128
Présentation des rubriques, des articles et des brèves dans SPIP 129
Les mots clés 134
– Activer et désactiver les mots clés 134
– Définir un mot clé 135
– Exemple d’utilisation de mots clés 138
Mise en oeuvre d’un moteur de recherche 138
– Activer le moteur de recherche intégré 140
– Afficher le formulaire de recherche 141
– Utiliser le moteur de recherche intégré 141
– Le moteur de recherche externe Dig 142
– Sites syndiqués
5. Les feuilles de styles 149
Avant de commencer 149
– Définir un style 150
– Redéfinir des marqueurs au coup par coup 150
– Utiliser un marqueur 151
– Utiliser une feuille de styles 152
– Passage à la pratique 152
Les styles des raccourcis typographiques 154
Les attributs redéfinissables dans un style 159
– Polices 160
– Couleurs et arrière-plans 160
– Textes 161
Pour aller plus loin 161
6. Créer sa propre mise en page 163
Les principaux squelettes d’un site SPIP 164
Utilisation de plusieurs squelettes 165
Le langage de mise en page des squelettes 165
– Boucles 166
– Balises SPIP 168
– Les variables de personnalisation 194
– Les formulaires 195
– Utiliser une feuille de styles pour modifier l’aspect d’un formulaire 200
– Le formulaire de recherche 200
7. Squelettes types 201
Un premier squelette 201
Un même squelette pour plusieurs articles 206
Un squelette pour tous les articles d’une rubrique 207
Deux boucles imbriquées 209
Quelques squelettes simples pris en exemple dans SPIP 211
– Sommaire.html 211
– Rubrique.html 217
– Article html 223
– Breves_toutes.html 223
– Forum.html 236
– Plan.html 240
– Recherche.html 244
Les squelettes par défaut de SPIP 249
– Sommaire.html 249
– Rubrique.html 259
– Article.html 271
8. Un projet SPIP de A à Z 283
Première étape : structure de la base 283
Deuxième étape : premiers squelettes 290
Troisième étape : communication avec les utilisateurs 297
– Insérer un nouveau xxxWare 297
– Mettre en place un forum public 301
Quatrième étape : la charte graphique 304
– Définir et incorporer le titre 305
– Répartir les informations 306
9. Les bases du langage PHP 311
Le langage PHP 311
– Avant de commencer 312
– Commentaires 312
– Variables 313
– Opérateurs 316
– Instructions de contrôle if…else et switch 318
– Instructions répétitives 320
– Tableaux 323
Débuter en MySQL 328
– Créer une base de données avec EasyPHP 329
– Créer une table avec EasyPHP 330
– Saisir des données avec EasyPHP 333
– Importer des données avec EasyPHP 333
– Interroger une base de données avec EasyPHP 334
Exemples types 336
– Afficher la date en français 336
– Communiquer des variables à une page PHP 338
– Une page multilingue 338
– Passer des données via un formulaire 339
– Rediriger vers une autre page 340
– Envoyer un email 340
– Compteur de visites 342
– Utiliser une base de données MySQL en PHP 343
Pour aller plus loin 347
1O. Référence PHP 349
Apache 350
Tableaux 350
Dates 352
Gestion des erreurs 353
Système de fichiers 354
Communication FTP 357
Images 358
Email 360
Bases de données MySQL 361
Réseau 362
Chaînes de caractères 363
Entrées/sorties 365
Index 367
Introduction
SPIP est un magnifique outil dédié à la gestion et à la conception de sites en ligne ou hors connexion. Il a été développé par le minirézo, collectif informel et ouvert d’acteurs du Web indépendant, pour la gestion du site uZine (http:I/www .uzine.net). Il est disponible gratuitement sous licence GPL La version 1.4.2, dernière en date alors que nous écrivons ces lignes, a été utilisée pour réaliser cet ouvrage. SPIP est particulièrement bien adapté à la création d’un site structuré à la manière d’un magazine papier, c’est-à-dire composé de rubriques et de sous- rubriques dans lesquelles sont insérés des articles et des brèves, éventuellement complété par un ou plusieurs forums de discussion.
SPIP a été conçu pour permettre la répartition des tâches entre plusieurs personnes:
– La gestion éditoriale, qui comprend la création et l’organisation des rubriques et la validation des articles proposés.
– La rédaction d’articles et de brèves.
– L’élaboration de la charte graphique, qui donne un aspect personnel à un site. Si l’administrateur du site joue un rôle prépondérant, le travail des rédacteurs et des graphistes ne doit pas être sous-estimé. Car ce sont eux, pour une grande part, qui fidéliseront les visiteurs du site, par la régularité et la qualité de leur travail.
Cet ouvrage s’adresse essentiellement aux administrateurs de sites créés sous SPIP.
Il représente une référence facile à consulter. Il donne les arcanes de cette puissante machinerie qu’est SPIP et permet d’aller plus loin à l’aide de code PHP/MySQL.
Les auteurs d’articles et de brèves sont également concernés par ce livre. Ils appréhenderont ainsi rapidement et d’une façon plus globale le fonctionnement de cet outil de conception de sites et auront une idée précise des tâches qui peuvent être demandées à l’administrateur pour améliorer la qualité de leur site.
Chapitre 1
Installation
Ce chapitre présente les différentes techniques d’installation de SPIP. Vous y apprendrez à travailler en ligne si vous possédez une connexion permanente à Internet, et à installer SPIP sur votre ordinateur pour travailler de façon locale.
Travailler connecté ou hors connexion
Si vous faites partie des privilégiés qui disposent d’une connexion permanente au Net, vous allez pouvoir effectuer vos développements SPIP en ligne. Dans le cas contraire, le plus simple consiste à installer un serveur PHP/MySQL local, par exemple en faisant appel à l’excellent outil EasyPHP. Vous trouverez toutes les informations nécessaires pour vous procurer et installer EasyPHP dans la section » locale de SPIP », plus loin dans ce chapitre.
Le choix de l’hébergeur
La plupart des hébergeurs acceptant PHP3/MySQL ou PHP4/MySQL sont compatibles avec SPIP. Les auteurs de SPIP ont dressé une liste d’hébergeurs compatibles:
Hébergeurs « gratuits »
– Multimania
– Free
– Le Village
– Maxi
Chapitre 2
Interface de développement
Ce chapitre présente l’environnement de développement de SPIR Après sa lecture, vous saurez faire la différence entre l’espace public et l’espace privé, vous connaîtrez les tâches qui incombent aux personnes qui participent à la vie d’un site développé sous SPIP et saurez utiliser les différentes pages Web qui constituent l’environnement de développement de SPIP.
Espace privé et espace public
Il est important de bien différencier l’espace privé de l’espace public. Nous utiliserons en effet fréquemment ces deux appellations dans la suite de l’ouvrage.
L’espace privé correspond à un ensemble de pages accessibles par vous et par les administrateurs. Ces pages sont utilisées pour créer des rubriques, rédiger des articles et des brèves, participer au forum interne et/ou au forum des administrateurs (si vous êtes administrateur), régler le fonctionnement de votre interface de développement SPIP, etc.
L’espace public correspond à l’ensemble des pages ouvertes à tous les internautes. Ces pages sont composées de rubriques, d’articles, de brèves et de liens vers des sites externes. Elles peuvent également donner accès à un ou plusieurs forums publics. Les informations accessibles depuis le site public doivent obligatoirement avoir été validées par un administrateur avant leur publication.
Chapitre 3
Mise en forme des contenus
Pour faciliter la mise en page des documents publiés avec SPIP, vous pouvez utiliser un certain nombre de raccourcis typographiques. Cette technique est très pratique, car elle évite l’utilisation de balises HTML. Cependant, il est toujours possible d’utiliser des marqueurs de mise en forme HTML, voire de faire appel à des langages plus évolués, tels que JavaScript, Java ou PHP. Il suffit pour cela d’insérer le code dans le corps texte, à l’endroit même où vous souhaitez qu’il soit utilisé.
Sachez tout d’abord que SPIP implémente de façon transparente les règles d’espacement de la typographie française:
– Des espaces insécables sont automatiquement ajoutés devant les caractères : ; ! et ?
– Des espaces insécables sont ajoutés automatiquement de part et d’autre des guillemets à la française.
Dans les pages qui suivent, nous allons passer en revue les raccourcis typographiques et les marqueurs HTML les plus courants qui permettront d’effectuer une mise en forme de vos contenus (articles et brèves).
Chapitre 4
Premiers pas avec SPIP
Avec SPIP, vous allez pouvoir gérer un site Web de type magazine. Ce site sera composé d’articles et de brèves insérés dans un ensemble de rubriques imbriquées. Les tâches effectuées pour maintenir le site (rédaction, validation des articles, composition graphique) peuvent être attribuées à différents intervenants, totalement indépendants les uns des autres. Dans les pages suivantes, vous allez faire vos premiers pas avec SPIP. Pour cela, vous ferez connaissance avec les éléments qui composent les pages créées avec cet outil.
Espace privé et espace public
Les auteurs d’articles SPIP ont accès à un espace privé, seulement visible par eux-mêmes et par l’administrateur du site. Cet espace est une sorte de « mémoire tampon » dans laquelle les auteurs stockent leurs articles en cours de rédaction. Lorsqu’un article est entièrement rédigé, son auteur le propose à l’évaluation. Après avoir été examiné par l’un des administrateurs du site et éventuellement commenté par les autres auteurs, l’article est publié ou rejeté. Dans le premier cas, il devient accessible à tous les visiteurs du site. On dit qu’il fait partie du site public.
Chapitre 5
Les feuilles de styles
Nous avons vu au Chapitre 3, il est possible d’utiliser des raccourcis typographiques pour facilité la mise en page des articles et des brèves. Ces raccourcis sont convertis par SPIP en code HTML selon la feuille de styles spip_styles.css. En éditant cette feuille de styles, il est possible de personnaliser une ou plusieurs de ces conversions. Pour cela, un simple éditeur de texte (comme le programme WordPad, livré avec Windows suffit. De plus, rien ne vous empêche de compléter la feuille de styles spip_styles.css en définissant les caractéristiques de styles non SPIP. Ces styles s’appliquent aux éléments concernés lorsqu’ils ils sont spécifiés entre les marqueurs et
Avant de commencer
Il y a fort à parier que vous avez déjà utilisé un traitement de texte évolué, tel que Word ou WordPerfect. Dans ce cas, vous savez certainement ce qu’est un style. Cette entité permet de regrouper plusieurs attributs de formatage d un texte (comme la police, la taille, la graisse, la couleur et le type d’alignement) sous un même nom. Lorsque vous appliquez un style à un bloc de texte, tous les attributs qu’il renferme y sont affectés en une seule opération. Si votre expérience des traitements de texte s’étend jusqu’aux logiciels professionnels de PAO (programmation assisté par ordinateur), vous connaissez bien les feuilles de styles. Ces documents sont utilisés pour définir le nom et les caractéristiques d’un plusieurs styles. Lorsqu’un nouveau document reposant sur une feuille de style est défini, il donne immédiatement accès à tous les styles correspondants.
Chapitre 6
Créer sa propre mise en page
Toutes les informations qui constituent un site SPIP sont stockées dans une base de données MySQL. Pour afficher ces informations dans le site public, il faut extraire puis convertir les éléments adéquats au format HTML. Cette opération est réalisée par l’intermédiaire de pages HTML spécialisées, appelées « squelettes ». Ces pages contiennent des instructions qui indiquent quelles informations récupérer et comment les agencer. Les pages visitées ainsi reconstituées sont stockées temporairement dans le dossier /cache de SPIP, afin d’éviter l’exécution du squelette à chaque consultation de la même page. Cette technique réduit le temps d’occupation du serveur et accélère la vitesse d’affichage des pages déjà visitées. Lorsqu’un visiteur demande l’affichage d’une page, le dossier /cache est parcouru. S’il contient les données correspondantes et que le délai de péremption n’est pas dépassé, ces données sont directement retournées au visiteur. Dans le cas contraire, la base de données MySQL du site est interrogée. Le résultat est stocké dans le dossier /cache et renvoyé au visiteur.
Chapitre 7
Squelettes types
Ce chapitre montre comment aller plus loin dans la personnalisation de votre site SPIP en utilisant un ou plusieurs squelettes. Pour vous aider à faire vos premiers pas, nous analyserons quelques squelettes élémentaires. Cette première étape franchie, nous passerons en revue les principaux squelettes élémentaires pris en exemple sur le site de SPIP. Enfin, nous examinerons les squelettes par défaut de SPIP, bien plus complexes que les précédents, mais aussi plus complets. Leur compréhension vous permettra de concevoir sans difficulté vos propres squelettes.
Un premier squelette
Pour faire vos premiers pas, nous vous proposons un squelette élémentaire qui se contente d’afficher la valeur d’un ou plusieurs champs dans un article. Nous supposons ici que votre base de données SPIP contient au moins un article dont voici le contenu:
Titre : Essai de tableau HTML
Descriptif rapide : Tableau écrit en HTML
Chapeau : Ce tableau est trop complexe pour être généré par les codes typographiques de SPIP.
Chapitre 8
Un projet SPIP de A à Z
A titre d’exemple, nous allons vous montrer, étape par étape, comment le mini site « Le meilleur du freeware francophone » a été réalisé.
Les principales fonctions de ce site sont les suivantes:
– présentation d’une sélection de freeware/shareware francophones, triés par genre : bureautique, éducation, graphisme, Internet, jeux, programmation et utilitaires
– possibilité d’enregistrer un nouveau freeware/shareware par son auteur;
– forum de discussion;
– lien vers le site externe non SPIP » 1 0 000 sites Web francophones »
– recherches à l’intérieur du site.
Première étape : structure de la base
Dans un premier temps, nous allons mettre en place la structure des rubriques/sous rubriques/articles/brèves. Mais auparavant, il est nécessaire d’installer SPIP chez l’hébergeur de votre choix. Pour cela, consultez la section « Installer SPIP », au Chapitre 1.
Annexe A
Les bases du langage PHP
Le langage PHP
Vous avez pu le voir tout au long de cet ouvrage, il n’est pas nécessaire d’être un programmeur PHP pour utiliser SPIP. Avec quelques rudiments de HTML et grâce au « sur langage » PHP intégré à SPIP, il est tout à fait possible de créer des sites de bonne qualité. Cependant, certains lecteurs voudront certainement aller plus loin et manipuler la base de données SPIP en utilisant PHP et MySQL. Ces deux annexes sont faites pour eux. L’Annexe A donne les bases d’utilisation des langages PHP et MySQL. L’Annexe B référence les fonctions les plus courantes du langage PHP.
Les moindres parcelles du langage PHP ne peuvent pas être passées en revue dans cette annexe. Par contre, vous y trouverez le minimum requis pour commencer à programmer en PHP.
Pour savoir comment est organisée la base de données SPIP, nous vous conseillons vivement de consulter la documentation en ligne à ce sujet. Rendez-vous sur le site http://www.spip.org/. Vous obtiendrez tous les renseignements nécessaires pour sélectionner puis extraire les données que vous souhaitez afficher dans votre site.
Annexe B
Référence PHP
PHP dispose de bibliothèques de fonctions très complètes. Dans cette annexe figurent les fonctions les plus courantes. Pour en savoir plus sur les fonctions accessibles en PHP, rendez-vous sur le site www.php.net.
Index
SYMBOLES
71
73