Table des matières

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

Simple navigation

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

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 :

Se connecter

Voir la page dédiée

Pour les auteurs

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 :

Langage Wiki

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 Wiki1), dont les principales caractéristiques sont :

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.

Page 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

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.

Créer des pages

Si vous en avez le privilège2), 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.

Catégories

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.

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

Plugins

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.

Médias et documents joints

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 :

La boîte de dialogue de media

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.

Attention, ne peuvent être uploadés que des fichiers dont le type mime est déclaré dans la configuration du Wiki ; contactez l'administrateur si le vôtre est bloqué.

Note importante : la plupart des sites de pays-gallo.net stockent leur média (images, PDF et musique) sur la Gallerie partagée à laquelle les différents wikis ont un accès direct ; ils utilisent donc peu la mécanique de téléchargement décrite ci-dessus. Voir le mode d'emploi de gallery2.

1)
En fait, malgré les efforts de standardisation, il existe de nombreuses formes de ces langages tous issus du «structured text» mis au point pour la documentation embarquée du langage Python.
2)
la création est un privilège plus fort que la modification, vous pouvez être habilité à modifier une page, mais pas à en créer de nouvelles