Comment employer les Wikis de «pays-gallo.net»

En mode simple lecture, ce site s'utilise comme n'importe quel autre, les liens sont mis en valeur par une couleur :

• couleur contrastée pour une destination qui existe,
• rouge clair pour une destination qui n'existe pas encore

En outre, les liens hors du wiki sont préfixés par une petite icône, comme ceci http://assembllees-galezes.bzh (liens externes).

Le wiki apporte en outre quelques facilités de navigation et autres informations :

• en cliquant sur le titre principal (en général en haut à gauche), vous revenez sur la racine du Wiki ;
• la ligne «Piste:» située juste au-dessous du cadre titre vous donne des liens sur les dix dernières pages visitées ;
• le bouton «Rechercher» (en haut du menu latéral) vous permet de faire de la recherche par mots-clés dans le texte des pages du Wiki ;
• le bouton «Index» (dans la barre d'outils) fabrique un plan du site ;
• la date et l'auteur de la dernière modification de la page courante sont indiqués en bas de la zone de texte à droite, juste au dessus de la barre d'outils du bas ;
• une file RSS recense les dernières modifications de pages faites sur le wiki, il suffit pour l'afficher de cliquer sur le bouton , vous pouvez également vous y abonner (dans votre lecteur de courriels ou un concentrateur de flux comme http://netvibes.com par exemple) pour être informé en temps réel des évolutions du site.

Voir la page dédiée

Lorsque vous êtes identifié, suivant les droits de votre groupe, vous pouvez modifier des pages existantes ou créer de nouvelles pages ; ceci se visualise par :

• l'apparition d'un bouton d'édition ou de création dans le menu d'outillage ;
• la présence de boutons «Modifier» à la fin de chaque section qui vous permettent de modifier le détail d'une section sans prendre toute la page en édition.

Les pages du wiki sont stockées sous forme de fichiers de texte. La mise en forme n'est pas directement représetée en langage XHTML mais à l'aide d'un langage structuré, nommé langage Wiki¹⁾, dont les principales caractéristiques sont :

• pas de balises à la XML, mais des formes structurelles simples et détectables sans ambiguité par un parseur à expressions régulière ;
• le texte source est facile à éditer dans une simple fenêtre textarea et reste facilement lisible ;
• le moteur de Wiki génère à chaque lecture de la page la représentation en XHTML, l'usage de templates et des CSS donne de larges possibilité de représentation.

La page «syntaxe» donne une description du langage Wiki de DokuWiki ; il est évidemment recommandé de lire cette page avant toute opération d'édition.

Quand vous cliquez sur un bouton d'édition, vous ouvrez une page d'édition sur la page ou le paragraphe courant. Cette page contient essentiellement une zone de saisie (textarea) contenant le texte actuel de la page ou du paragraphe. Au dessus de cette zone de saisie, une série de boutons permet de prendre en charge la majorité des structures syntaxiques du langage Wiki, à la façon de tous les éditeurs WYSIWYG (enrichissements typographiques, gestion des titres, liens, structures de listes, insertion de médias ou d'émoticons).

En bas trois boutons permettent de sauver, d'avoir un aperçu ou d'annuler l'édition en cours. Il est conseillé aussi de compléter le cadre «Résumé» et la case à cocher «Mineur» (si par exemple il s'agit d'une simple correction de faute d'orthographe) qui sont utiles pour la gestion de l'historique.

Lors de l'édition, un mécanisme de lock prévient la modification simultanée de la même page par deux auteurs. Si vous oubliez votre page en mode édition, le verrou sera levé au bout d'un quart d'heure. Il faut faire un aperçu pour renouveler le verrou lors d'une longue édition.

Le bac à sable est une page particulière du wiki que tous les usagers peuvent modifier pour faire des essais. Il est vivement conseillé aux nouveaux usagers d'y faire leurs premiers essais avant de créer ou modifier des pages importantes du site.

Le bac à sable est également un lieu intéressant pour créer de nouvelles pages qui ne sont pas directement connectées à des pages existantes ou à des menus.

Si vous en avez le privilège²⁾, rien n'est plus facile : il suffit, dans une page existante de créer un lien sur une page inexistante ; après sauvegarde de la page, le lien apparaît en rouge clair, si vous le cliquez, le moteur de wiki vous signalera que cette page n'existe pas encore et vous proposera de la créer.

Si la page que vous créez n'est rattachée à aucune page existante, vous pouvez faire cette opération depuis le bac à sable, ou bien saisir directement l'URL de la nouvelle page dans le cadre de saisie de votre navigateur.

Elles sont le moyen d'organiser les pages du wiki, elles permettent également de gérer plus facilement le contrôle d'accès permis aux différentes classes d'usagers.

• au niveau syntaxique, elles se traduisent par une notation hiérarchique qui utilise le caractère ':' comme séparateur ; par exemple, cette page est dans la catégorie «wiki:aide» et son nom complet est «wiki:aide:mode_d_emploi» ;
• au niveau structurel les catégories sont représentées par des répertoires et peuvent être accédées par des URL directes ; par exemple, l'URL de cette page est http://_base_du_site/wiki/aide/mode_d_emploi

Lors de la définition des liens, un nom de page simple, sans catégorie est réputé appartenir à la même catégorie que la page courante (par exemple la page seconnecter qui est saisi [[seconnecter]]) ; si on veut pointer une page dans une autre catégorie, il faut en indiquer l'identification complète (comme dans mention_legale qui est saisi [[:wiki:mention_legale]]).

L'environnement DokuWiki dispose de nombreux plugins qui permettent d'en enrichir la syntaxe et les fonctionnalités. Plusieurs plugins sont déjà installés dans ce wiki, vous pouvez en avoir une démonstration plus complète dans la page d'exemples.

Si vous jugez qu'un plugin pourrait être intéressant, demandez-en l'installation aux administrateurs.

Il est très facile d'associer des documents ou media à des pages du wiki ; là encore, il suffit de créer un lien avec la bonne syntaxe ({{lien}}). Les media sont classés avec les même catégories que les pages, dans une arborescence parallèle ; les droits d'accès appliqués aux catégories s'appliquent également aux médias.

L'insertion d'un media est simple : au moment de l'édition de la page dans la barre d'outil choisisez “Ajouter des images ou d'autres fichiers” (bouton au dessus de la fenêtre de saisie). Si le fichier n'est pas déjà dans la liste qui apparaît alors, faîtes un “téléchargement” dans la boîte de dialogue qui se présente comme cela :

Pour faire le téléchargement, il faut d'abord cliquer le bouton “Sélection de fichiers” pour choisir le fichier à envoyer sur le disque local, puis activer le bouton “Télécharger” ; il est possible de choisir plusieurs fichiers avant de lancer le téléchargement. Quand le téléchargement est terminé, apparaît le bouton “Terminer” qu'il suffit de cliquer pour réactualiser la liste des média disponibles.