SPIP-Contrib

SPIP-Contrib

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

288 Plugins, 197 contribs sur SPIP-Zone, 188 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 Versions
Pour 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

  • Plugin Modèles media

    25 avril 2011 – 169 commentaires

    Les modèles , et produisent chacun un résultat différent et ce résultat, pour les images, dépend du fait qu’elle soit dans le portfolio ou non. Ce plugin propose une nouvelle série de modèles ayant un comportement unifié et indépendant du mode des (...)

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2230 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 (...)

  • Einsteiniumist (Squelette)

    23 avril 2013 – 81 commentaires

    Un squelette principalement conçu pour les sites de type blog et portfolio. Présentation : Adaptation pour Zpip du thème Wordpress Einsteiniumist conçu par Padd Solutions. Voir une démo du thème et du squelette Einsteiniumist. Ce squelette (...)

  • Plugin séances

    10 octobre 2010 – 85 commentaires

    Dans la gestion d’événements, il arrive d’avoir à mettre en rapport un spectacle (film, concert ou autre), un lieu et une date. Il est alors possible d’envisager plusieurs modes de présentation : pour un spectacle donné, les dates et lieux de celui-ci, (...)

  • Champs Extras 3

    16 janvier 2012 – 588 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 (...)

Ça spipe par là