Cours sur l'utilisation de YesWiki

Applicable à la version Doryphore 4.

Le principe "Wiki"

Wiki Wiki signifie rapide, en Hawaïen.
N'importe qui peut modifier la page

Les Wiki sont des dispositifs permettant la modification de pages Web de façon simple, rapide et interactive.
YesWiki fait partie de la famille des wiki. Il a la particularité d'être très facile à installer.

Mettre du contenu

écrire ou coller du texte

  • Dans chaque page du site, un double clic sur la page ou un clic sur le lien "éditer cette page" en bas de page permet de passer en mode "édition".
  • On peut alors écrire ou coller du texte
  • On peut voir un aperçu des modifications ou sauver directement la page modifiée en cliquant sur les boutons en bas de page.

écrire un commentaire (optionnel)

Si la configuration de la page permet d'ajouter des commentaires, on peut cliquer sur : Afficher commentaires/formulaire en bas de chaque page.
Un formulaire apparaîtra et vous permettra de rajouter votre commentaire.


Mise en forme : Titres et traits

--> Voir la page ReglesDeFormatage

Faire un titre

Très gros titre

s'écrit en syntaxe wiki : 
======Très gros titre======

Petit titre
s'écrit en syntaxe wiki : 
===Petit titre===

On peut mettre entre 2 et 6 = de chaque coté du titre pour qu'il soit plus petit ou plus grand

Faire un trait de séparation

Pour faire apparaître un trait de séparation
s'écrit en syntaxe wiki : 
----

Mise en forme : formatage texte

Mettre le texte en gras

texte en gras
s'écrit en syntaxe wiki : 
**texte en gras**

Mettre le texte en italique

texte en italique
s'écrit en syntaxe wiki : 
//texte en italique//

Mettre le texte en souligné

texte en souligné
s'écrit en syntaxe wiki : 
__texte en souligné__

Mise en forme : listes

Faire une liste à puce

  • point 1
  • point 2

s'écrit en syntaxe wiki :
Syntaxe pour liste à puces :
 - point 1
 - point 2

Attention : de bien mettre un espace devant le tiret pour que l'élément soit reconnu comme liste


Faire une liste numérotée

  1. point 1
  2. point 2

s'écrit en syntaxe wiki :
Syntaxe pour liste numérotée :
 1) point 1
 2) point 2

Les syntaxes utilisables

Comparer les syntaxes entre YesWiki et Markdown.

Les liens : le concept des ChatMots

Créer une page YesWiki :

La caractéristique qui permet de reconnaître un lien dans un wiki : son nom avec un mot contenant au moins deux majuscules non consécutives (un ChatMot, un mot avec deux bosses).

Lien interne

  • On écrit le ChatMot de la page YesWiki vers laquelle on veut pointer.
    • Si la page existe, un lien est automatiquement créé
    • Si la page n'existe pas, apparaît un lien avec crayon. En cliquant dessus on arrive vers la nouvelle page en mode "édition".

Les liens : personnaliser le texte

Personnaliser le texte du lien internet

selon la syntaxe wiki suivante : 
[aller à la page d'accueil](PagePrincipale)
apparaîtra ainsi : aller à la page d'accueil.

Liens vers d'autres sites Internet

selon la syntaxe wiki suivante : 
[aller sur le site d'Outils-Réseaux]([http://outils-reseaux.org)
apparaîtra ainsi : aller sur le site d'Outils-Réseaux.


Télécharger une image, un document

On dispose d'un lien vers l'image ou le fichier

selon la syntaxe wiki suivante :
  • pour l'image à télécharger : 
    [texte de remplacement de l'image](http://mondomaine.ext/image.jpg)
  • pour le document à télécharger : 
    [texte du lien vers le téléchargement](http://mondomaine.ext/document.pdf)

L'action "attach"

En cliquant sur le pictogramme Fichier, on voit une fenêtre de sélection de fichiers. Ensuite, une fenêtre de paramétrage du fichier est proposé. On appuie sur le bouton "Insérer". Cette action ajoute la ligne suivante :
{{attach file=" " desc=" " size=" " class=" " }}

Entre les premières guillemets, on indique le nom du document (ne pas oublier son extension (.jpg, .pdf, .zip).
Entre les secondes, on donne quelques éléments de description qui deviendront le texte du lien vers le document
Les troisièmes guillemets permettent de définir la taille d'affichage de l'image.
Les quatrièmes guillemets permettent, pour les images, de positionner l'image à gauche (left), ou à droite (right) ou au centre (center)
{{attach file="nom-document.doc" desc="mon document" size="original" class="left" }}

Quand on sauve la page, un lien en point d'interrogation apparaît. En cliquant dessus, on arrive sur une page avec un système pour aller chercher le document sur sa machine (bouton "parcourir"), le sélectionner et le télécharger.

Intégrer des composants

Ajout un composant

On clique sur Composants et on choisit le type de composant. Une fenêtre affiche les paramètres à choisir pour configurer son apparence et son action.
Une fois configuré, on clique sur le bouton "insérer dans la page". Enfin on sauve la page.

Modifier un composant

En mode édition, on clique sur la ligne correspondant au code du composant (Par exemple pour le bouton, texte commençant par {{button}})=> un petit crayon apparaît dans la marge. On clique sur le petit crayon et on change les paramètres du composant. Une fois paramétré, on clique sur "mettre à jour le code". Enfin on sauve la page.

Intégrer du html

Si on veut faire une mise en page plus compliquée, ou intégrer un widget, il faut écrire en html. Pour cela, il faut mettre notre code html entre double guillemets.
Par exemple : 
<span style="color:#0000EE;">texte coloré</span>

donnera :
texte coloré

Les pages spéciales

  • PageHeader
  • PageFooter
  • PageMenuHaut
  • PageMenu
  • PageRapideHaut

  • TableauDeBord (affichant notamment les pages orphelines)


Les actions disponibles

Voir la page spéciale : ListeDesActionsWikini sur wikini.net (cf. l'histoire de YesWiki)

les actions à ajouter dans la barre d'adresse:
rajouter dans la barre d'adresse :
/edit : pour passer en mode Edition
/slide_show : pour transformer la texte en diaporama
(cf. la documentation officielle sur l'ensemble des actions "handlers")

La barre du bas de page permet d'effectuer diverses action sur la page

  • voir l'historique
  • partager sur les réseaux sociaux
  • restaurer une version de la page précédente
...

Suivre la vie du site

  • Dans chaque page, en cliquant sur la date en bas de page on accède à l'historique et on peut comparer les différentes versions de la page.

  • Le TableauDeBord : pointe vers toutes les pages utiles à l'analyse et à l'animation du site :
    • les derniers modifications permet de visualiser les dernières modifications apportées sur l'ensemble du site. Pour l'avoir en flux RSS DerniersChangementsRSS.
    • l'index des pages affichent la liste des pages orphelines, les fiches des formulaires, les pages du site

  • Les lecteurs de flux RSS : offrent une façon simple, de produire et lire, de façon standardisée (via des fichiers XML), des fils d'actualité sur internet. On récupère les dernières informations publiées. On peut ainsi s'abonner à différents fils pour mener une veille technologique par exemple.
Différents lecteurs de flux RSS



L'identification

Première identification = création d'un compte YesWiki

  • aller sur la page spéciale PageLogin,
  • choisir un nom YesWiki qui comprend 2 majuscules. Exemple : JamesBond
  • choisir un mot de passe et donner un mail
  • cliquer sur s'inscrire

Identifications suivantes

  • aller sur PageLogin,
  • remplir le formulaire avec son nom YesWiki et son mot de passe
  • cliquer sur "connexion"



Gérer les droits d'accès aux pages

  • Chaque page possède trois niveaux de contrôle d'accès :
    • lecture de la page
    • écriture/modification de la page
    • commentaire de la page

  • Les contrôles d'accès ne peuvent être modifiés que par le propriétaire de la page
On est propriétaire des pages que l'ont créent en étant identifié. Pour devenir "propriétaire" d'une page, il faut cliquer sur Appropriation.

  • Le propriétaire d'une page voit apparaître, dans la page dont il est propriétaire, l'option "éditer permissions" : cette option lui permet de modifier les contrôles d'accès.
Ces contrôles sont matérialisés par des colonnes où le propriétaire va ajouter ou supprimer des informations.
Le propriétaire peut compléter ces colonnes par les informations suivantes, séparées par des espaces :
  • le nom d'un ou plusieurs utilisateurs : par exemple JamesBond
  • le caractère * désignant tous les utilisateurices
  • le caractère + désignant les utilisateurices enregistrés
  • le caractère ! signifiant la négation : par exemple !JamesBond signifie que JamesBond ne doit pas avoir accès à cette page

  • Droits d'accès par défaut : pour toute nouvelle page créée, YesWiki applique des droits d'accès par défaut.

  • Configuration de plusieurs pages : GererDroits permet de configurer plusieurs pages en même temps. Cette page est uniquement accessible aux administrateurs.

Supprimer une page


  • 2 conditions :
    • on doit être propriétaire de la page et identifié (voir plus haut),
    • la page doit être "orpheline", c'est-à-dire qu'aucune page ne pointe vers elle (pas de lien vers cette page sur le YesWiki), on peut voir toutes les pages orphelines en visitant la page : TableauDeBord

  • On peut alors cliquer sur l''option "Supprimer" en bas de page.



Changer le look et la disposition

En mode édition, si on est propriétaire de la page, ou que les droits sont ouverts, on peut changer la structure et la présentation du site, en jouant avec les listes déroulantes en bas de page : Thème, Squelette, Style.
La page GererThemes permet de modifier le thème pour plusieurs pages en même temps.
La page LookWiki permet de modifier le thème du site.