Contents
Tuleap offre un service Wiki à chaque projet. Le wiki utilisé dans Tuleap s’appuie sur l’outil phpWiki.
Un Wiki est un site Web qui permet à ses utilisateurs d’ajouter très facilement du contenu ou de modifier le contenu déjà en place.
Un Wiki permet de rédiger un document de façon collaborative à l’aide d’un langage de balises simple et en utilisant uniquement un navigateur Web. Une page d’un wiki est appelée “page wiki” alors que l’ensemble des pages interconnectées par le biais d’hyperliens sont collectivement baptisées “le wiki”. Tuleap offre en complément la notion de “Document Wiki” : il s’agit d’une page wiki directement accessible depuis la page d’accueil du service Wiki du projet.
Une propriété caractéristique de la technologie Wiki est la facilité avec laquelle des pages peuvent être créées ou modifiées. Il n’y pas de mécanisme de revue ou d’approbation des modifications effectuées et les Wikis Tuleap sont ouverts à tous les utilisateurs enregistrés.
Dans les Wikis de Tuleap, une page possède trois représentations : le code HTML, la page résultant du rendu par le navigateur et le code source de la page éditable par l’utilisateur à partir duquel la version HTML est générée. Le format du code source, connu sous le nom de “wikitext”, est un langage de marquage simplifié.
Le langage de marquage “wikitext” est né de la constatation que HTML, avec sa longue liste de balises imbriquées, est trop complexe pour permettre l’édition simple et rapide de documents et empêche l’utilisateur de se concentrer sur le contenu de la page. Le fait que l’utilisateur ne puisse pas utiliser toutes les fonctionnalités de HTML, telles que JavaScript et les feuilles de styles est aussi bénéfique car cela permet d’assurer une cohérence dans le style des pages et d’éviter les failles de sécurité.
Les Wikis sont de vrais documents hypertextes avec une structure de navigation non linéaire. Chaque page contient des liens vers d’autres pages. Les liens sont automatiquement créés en utilisant une syntaxe particulière appelée “patron de lien”.
Les wikis Tuleap utilisent le “patron de lien” appelé CasseChameau (CamelCase en anglais), qui consiste à considérer comme hyperlien une série de mots collés ensemble dont la première lettre est une majuscule (les mots “CamelCase”, “RéférencesBibliographiques” en sont des exemples). Le terme CasseChameau vient de l’allure des mots composés dont les majuscules ressemblent à des bosses de chameau.
A noter qu’il existe aussi une autre façon de créer des liens wikis en incluant une portion de texte entre crochets. Cela permet par exemple de créer des pages dont le titre doit comporter des espaces.
Dans un Wiki, une nouvelle page est créée simplement en tapant un lien dans une page existante. Si la page cible n’existe pas le lien est marqué comme étant nouveau. En cliquant sur ce lien, une nouvelle fenêtre d’édition apparaît et permet à l’utilisateur de taper son texte. Ce mécanisme permet d’éviter les pages orphelines qui ne seraient référencées nulle part dans le Wiki.
Important
Si vous souhaitez créer une référence à une page wiki d’un autre projet et si le nom de celle-ci est écrit en CasseChameau, contient des espaces ou des caractères spéciaux, vous devrez utiliser un lien à la place de la syntaxe habituelle.
Exemple : Utiliser “[http://yourserver/wiki/index.php?group_id=N&pagename=WiKiPageName]” à la place de “wiki #N:WikiPageName”
Les Wikis Tuleap permettent d’effectuer des recherches par mots-clés aussi bien dans le titre que dans le contenu des pages.
Les Wikis de Tuleap sont spécifiques à chaque projet. Ainsi deux projets distincts peuvent utiliser les mêmes noms de pages sans risque de conflit.
Pour être utilisable, le Wiki doit d’abord être initialisé par l’administrateur du projet. Pour ce faire, cliquez sur le lien “wiki” dans la barre des services, sélectionnez la langue d’utilisation de votre Wiki, cliquez sur ‘Créer’ et attendez la fin du processus de création.
Veuillez noter que la langue d’utilisation du Wiki est définie une fois pour toute à la création du Wiki. Le Wiki s’affichera dans la langue choisie quelles que soient les préférences de langues exprimées par chaque utilisateur.
La création du Wiki donne naissance à un certain nombre de pages très utiles : une page d’accueil, une “sandbox” où faire des tests, la documentation PhpWiki, etc…
Par défaut, les Wikis de Tuleap sont lisibles et modifiables par n’importe quel utilisateur enregistré.
Bien que cette politique d’accès soit en général la meilleure, certains Wikis ne doivent pas être publics. Pour répondre à ce besoin, Tuleap offre un mécanisme de gestion des permissions basés sur les groupes d’utilisateurs comme pour le gestionnaire de fichiers (voir ? et ?). Les droits d’accès peuvent être définis au niveau du Wiki et s’appliquer à toutes les pages, ou bien au niveau de la page permettant ainsi de protéger uniquement certaines pages bien choisies.
Les Wikis de projets hébergés sur Tuleap peuvent être utilisés de maintes façons. Les exemples qui suivent sont juste des suggestions :
Tous les Wikis de Tuleap sont initialisés avec un jeu de pages par défaut dont la documentation PhpWiki. Consultez la page PhpWikiDocumentation pour une description de toutes les fonctionnalités de PhpWiki : syntaxe du langage de marquage, plugins, etc…