SPIP-Contrib

SPIP-Contrib

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

286 Plugins, 197 contribs sur SPIP-Zone, 373 visiteurs en ce moment

Accueil > Squelettes > Outils pour squelettes > Assistant de Conception de Site (ACS) > Wiki avec ACS

Wiki avec ACS

20 juillet 2011 – par Daniel FAIVRE

11 votes

Tutoriel : comment faire un wiki avec SPIP et le plugin ACS. Suivi des révisions d’un article, affichage des différences, composant Versions, liens de type wiki vers la page si elle existe et proposant de la créer sinon.

Pour ACS version 0.8.5 et ultérieures.

Introduction

ACS, l’Assistant de Conception de Site, est avant tout un outil qui permet de fabriquer des composants, des « noisettes », des bouts de squelettes SPIP, puis de les configurer par une interface web, un « clickodrome ».

Puisqu’il sert à en fabriquer, ACS contient un jeu de composants configurables comprenant des pages entièrement configurables par interface web, pouvant s’utiliser soit seul soit comme composants d’un jeu de squelettes personnalisés.

Certains de ces composants permettent de faire un wiki avec SPIP.

La gestion des versions d’articles dans SPIP

Dans un wiki, on garde la mémoire de toutes les modifications successives d’une page. La fonction existe dans SPIP pour les articles (pas pour les autres objets). Il suffit de l’activer : c’est dans la partie privée de SPIP, et il suffit de cliquer sur l’icône « Configuration » puis sur l’onglet « Fonctions avancées » pour pouvoir y sélectionner « Activer le suivi des révisions » et valider ce changement.

L’interface privée de SPIP permet déjà d’explorer les différentes versions d’un article, ou de faire un revert [1].

Versions d’articles avec Cat

Si le plugin Crayons est installé, on peut déjà éditer la dernière version d’un article directement dans la partie publique du site web. Le jeu de composants « Cat » d’ACS permet en plus d’afficher les différentes versions d’un article sur le site public :

Version antérieure d'un article

Le titre de l’article est ici surmonté de deux onglets :
-  « Article » : dernière version, éditable depuis le site public avec les crayons [2].
-  « Version : nn » : version n° nn de l’article, avec affichage des différences entre version n et version n-1. Les versions antérieures d’un article NE sont PAS (pour l’instant) éditables depuis le site public, mais un clic sur le lien « Version : nn » ouvre la version n° nn de l’article en édition dans la partie privée, permettant ainsi de faire facilement un revert.

Le composant Versions

Composant VersionsPour voir les versions successives d’un article sur le site public, le jeu de composants inclus avec ACS (nommé « Cat ») comprend un composant nommé Versions qui affiche un bloc avec les dates des révisions successives d’un article et leurs auteurs.

Son interface d’administration [3] permet de configurer son apparence : couleur et/ou image de fond du titre, couleur de fond du bloc, bordure, ombrage, ...
La taille des caractère est celle définie dans le composant « Fond » pour tous les blocs de navigation semblables.

Pour qui utilise ACS avec ses pages configurables par interface web, il suffit de glisser le composant Versions dans le cadre que vous voulez de la page article. Vous pouvez utiliser l’explorateur des pages du site d’ACS (dans la partie privée) ou le bouton « afficher les inclusions » (depuis le site public) pour repérer le numéro d’instance du Cadre où vous voulez ajouter le bloc « versions ».

Le composant Versions dans n’importe quel squelette

Pour un webmestre qui utilise ACS comme librairie de composants à insérer dans ses squelettes, il faut inclure le composant Versions dans le squelette de la page article.html. C’est facile, il suffit du code :

[(#MODELE{composant}{c=composants/versions/versions})]

Appelé depuis une boucle ARTICLES, comme c’est le cas depuis la page d’un article, le composant Versions récupère automatiquement l’identifiant de l’article pour afficher la liste de ses versions successives.

Toutefois, il faut également que la page article.html et les styles CSS associés permettent d’afficher proprement les versions antérieures et les modifications entre versions lorsqu’elle est appelé par un clic sur l’une des versions affichées dans le composant Versions. C’est le cas des squelettes de la distribution SPIP et du jeu de composants « Cat » inclus dans le plugin ACS, mais ça n’est pas forcément le cas de tous les squelettes SPIP.

Le modèle wiki

Enfin, dans un wiki, on veut pouvoir mettre des liens entre pages du wiki qui vont afficher soit le lien vers ladite page si elle existe, soit un lien proposant de la créer si elle n’existe pas encore.

Le jeu de composants Cat du plugin ACS comprend un modèle SPIP pour celà : le modèle wiki. Dès lors qu’ACS est installé et le jeu de composants « Cat » actif, dans n’importe quel objet de SPIP (article, rubrique, mot-clé, ...), il suffit d’écrire <wiki|titre=truc> pour créer un lien de type wiki vers la page « truc », c’est à dire vers la page de l’article ayant pour titre « truc ».

Si un article avec le titre « truc » existe, <wiki|titre=truc> affiche un lien hypertexte vers cet article, avec la classe CSS « wiki ». Et si l’article « truc » n’existe pas, <wiki|titre=truc> affiche un lien proposant de créer un nouvel article, avec la classe CSS « wikinew ». La possibilité effective de créer un article en cliquant sur ce lien dépend des droits d’accès de l’utilisateur. Les classes CSS « wiki » et « wikinew » peuvent être personnalisées (dans un composant ou dans la feuille de style CSS de la page) pour donner à ces liens wiki une couleur et une apparence particulière.

S la page « truc » est ensuite supprimée ou crée, le lien crée par <wiki|titre=truc> est mis à jour automatiquement [4], contrairement au code spip classique pour afficher un lien vers un article (<artnnn>).

Notes

[1revert : dans un wiki, c’est l’action de remplacer la version actuelle d’un article par une version antérieure.

[2Crayons : le plugin Crayons permet l’édition directe d’objets SPIP depuis le site public.

[3L’interface d’administration d’un composant est accessible :
-  dans la partie privée, menu Configuration, sous-menu Conception du site, onglet Composants ;
-  depuis le site public (pour les utilisateurs autorisés à modifier les composants avec ACS), à l’aide des pinceaux ACS, si le plugin Crayons est installé (les pinceaux sont une extension des crayons fournie par ACS pour éditer des composants aussi facilement que les crayons permettent d’éditer du texte).

[4La mise à jour des liens wiki sur le site public se fait automatiquement lors d’un recalcul de la page. Ce recalcul peut être déclenché manuellement par le webmestre avec le bouton « Recalculer la page », ou par l’expiration de la page dans le cache SPIP.

Dernière modification de cette page le 20 juillet 2011

Retour en haut de la page

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

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2062 commentaires

    Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs. Introduction L’objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins (...)

  • Réservation d’événements

    16 mars 2015 – 209 commentaires

    Ce plugin permet d’offrir aux visiteurs de s’inscrire pour un évènement du plugin Agenda et de gérer les réservations enregistrées. Installation Le plugin s’installe comme n’importe quel plugin. il nécessite : Agenda API de vérification (...)

  • Court-circuit 2

    17 octobre 2011 – 61 commentaires

    Court-circuit 2 permet de rediriger certaines rubriques vers un article particulier. Vous pouvez configurer, dans l’espace privé, les règles de redirection à appliquer. Historique Court-circuit 2 est une évolution de Court-circuit 1, reprenant (...)

  • Une licence pour un article

    18 avril 2007 – 44 commentaires

    Sur une idée originale de erational, voici un plugin permettant de lier une licence à un article.

  • cisf : plugin « saisie facile » pour SPIP 3

    27 mai 2015 – 126 commentaires

    Cette nouvelle version est compatible avec SPIP 3.0, SPIP 3.1 (tout en restant compatible avec SPIP 2.1). Ce plugin « saisie facile » permet de créer ou de modifier facilement un article directement depuis le site public. Ce plugin : Diminue (...)