SPIP-Contrib

SPIP-Contrib

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

286 Plugins, 197 contribs sur SPIP-Zone, 208 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 ?
  • [Se connecter]

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

  • Acces Restreint 3.0

    11 décembre 2008 – 784 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 (...)

  • Champs Extras 3

    16 janvier 2012 – 538 commentaires

    Ce plugin permet de créer et/ou de gérer des champs supplémentaires dans les objets éditoriaux de SPIP. Il permet donc de prendre en compte et d’afficher de nouveaux éléments dans n’importe quel objet éditorial de SPIP. Screencast Vous n’aimez pas (...)

  • Réservation d’événements

    16 mars 2015 – 190 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 (...)

  • Les crayons

    23 avril 2008 – 815 commentaires

    Ce plugin permet d’éditer les contenus sur les pages publiques du site, sans passer par l’espace privé de SPIP.

  • LESS pour SPIP : Less-CSS (anciennement LESSpip)

    5 novembre 2010 – 43 commentaires

    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 (...)

Ça spipe par là