Utilisation du Wiki sur AtikTeam

Le système wiki est une façon de créer et de mettre en relation du contenu en ligne. Son fonctionnement repose sur deux principes simples :

  • une syntaxe wiki simple à utiliser permet de faire de la mise en page rapide et cohérente

  • les pages ne sont pas accédées de façon hiérarchique mais de façon relationnelle. Autrement dit, la navigation sur un wiki ne se fait pas par un menu principal, mais de liens en liens. Ainsi, il faut toujours faire le plus de liens possibles vers les autres ressources du wiki lorsqu'on crée une nouvelle page. Une page qui n'est référencée par aucune autre page est dite orpheline, et devient théoriquement inaccessible

La syntaxe Wiki sur AtikTeam

La syntaxe utilisée est proche de textile. Dans la plupart des boites de texte de l'interface, vous pourrez utiliser cette syntaxe pour mettre en valeur les différents éléments de votre texte.

Vous disposez, au dessus de la boite de texte, d'une barre d'outil permettant d'insérer la syntaxe Wiki automatiquement. Vous pouvez également consulter l'aide mémoire accessible par le lien "Formatage du texte : Aide" en haut à droite de la boite de texte.

Cette syntaxe a été conçue pour être très rapide à l'usage tout en restant suffisamment simple d'apprentissage. Ainsi, les débutants vont avoir recours à l'aide mémoire et aux boutons de la barre d'outil pour insérer les marques de mise en page, puis une fois la syntaxe appropriée, ils pourront l'utiliser directement au clavier au fil de la saisie de leur contenu.

N'oubliez pas, avant de sauvegarder une page Wiki, vous pouvez avoir un aperçu de son rendu en cliquant au préalable sur le lien Visualiser. Son utilisation régulière permet d'éviter un nombre d'enregistrements excessivement élevé pour causes de corrections mineures de syntaxe. :::

Comment créer une nouvelle page Wiki ?

Vous pouvez créer une page wiki en cliquant sur le bouton prévu à cet effet. Après avoir créé la page, pensez à en copier le lien wiki pour le coller dans d'autres pages. En référençant ainsi votre page, vous la rendrez facilement accessible et maintiendrez un réseau de liens wiki cohérent.

Utiliser les liens pour mettre les ressources en relation

Pour qu’un Wiki soit efficace, vous devez lier les ressources entre elles dès que possible.

Les liens automatiques

Une ressource qui peut être liée dans une page Wiki propose un lien « Copier le lien Wiki » sur lequel vous pouvez cliquer à tout moment.

Ensuite, vous pourrez insérer ce lien dans votre document en cliquant sur le bouton de la barre d’outil « Coller le lien Wiki ».

Lors de la rédaction d’un long document Wiki dans lequel vous souhaitez utiliser beaucoup de liens, vous pouvez donc ouvrir deux fenêtres de navigateur, et utiliser l’une pour parcourir les ressources et copier les liens Wiki, et l’autre pour la rédaction du document en collant les liens copiés.

Texte du lien

Lorsque vous créez un nouveau lien, le texte qui s’affichera sera automatiquement extrait de la ressource ciblée. Il s’agira par exemple du sujet de l’action, du titre de la page wiki ou encore du nom du fichier.

Prenons le cas d’une page wiki de titre « Cahier des charges ». Vous en copiez le lien wiki, et vous le collez dans un autre document. Vous verrez s’afficher dans la source {{wiki_page#6}}, alors que le rendu de la page affichera un lien « Cahier des charges ».

Vous pouvez choisir de spécifier vous-même ce texte, afin de mieux intégrer le lien dans son environnement. Pour cela, il faut séparer le lien du texte avec « || ». Par exemple, si vous écrivez :

{{wiki_page#6 || le cahier des charges de la mission}}

alors le lien rendu affichera « le cahier des charges de la mission »

Notez que le caractère de séparation « | » est accessible sur les claviers de PC par la pression simultanée de AltGr et de la touche 6. Sur les claviers Apple, il faut presser Maj, Alt et L.

Les images

La barre d’outil wiki permet l’insertion d’images, depuis votre ordinateur ou depuis une base de données d’images du projet. Vous pouvez si vous le souhaitez faire un lien sur l’image avec la propriété link, par exemple :

{{image#34 || size=original || link=https://www.atikteam.com}}

Trouver une page

Comme expliqué ci dessus, le moyen habituel de se rendre sur une page wiki est la navigation de lien en lien pour atteindre la ressource souhaitée. Vous pouvez également utiliser les liens Index par titre et Index par date dans la colonne à droite pour afficher ces listes. Enfin, vous pouvez faire une recherche par mot clef en utilisant le moteur de recherche.