Comment faire une (belle) page DokuWiki

DokuWiki utilise une syntaxe markdown qui est interprété pour donner le rendu affiché.

Lorsqu'on est sur une page, l'icône suivante s'affiche sur la gauche :

Il suffit de cliquer sur le crayon pour afficher le code source de la page ou le modifier si on a les droits.

Une aide sur la syntaxe DokuWiki est disponible ici.

Pour créer une page, rien de plus facile : il suffit d'écrire :

[[chemin:vers:la:page | nom de la page ]]

puis de suivre le lien affiché pour aller remplir cette nouvelle page. Par exemple,pour créer la page que vous êtes en train de lire en ce moment, j'ai écrit :

[[ groupe-dfo-bbo:gerer-sa-page |Comment faire une (belle) page DokuWiki]]

sur la page d'accueil, j'ai suivi le lien et j'ai commencé à écrire.

Dans l'arborescence, cette page a donc pour nom “gerer-sa-page”, et le nom affiché est “Comment faire une (belle page DokuWiki)”

Lorsqu'on est sur une page, le chemin de la page courante est donné en bleu en haut à gauche, par exemple ici :

Il est possible de voir la structure du site à l'aide du menu suivant, onglet “plan du site” :

Sur la page Étudiants, j'ai créé un lien pour chaque étudiant. Pour ma part, cela donne :

[[ groupe-dfo-bbo:acteurs:students:master:guillaume-lameynardie:main-page | {{groupe-dfo-bbo:acteurs:students:master:guillaume-lameynardie:portrait.jpg }}?150 ]]

Ainsi quand vous cliquez sur mon image affichée sur la page Étudiants, cela vous renvoit vers la page “main-page” dont le chemin dans l'arborescence est

 groupe-dfo-bbo:acteurs:students:master:guillaume-lameynardie:main-page 

.

ATTENTION

 groupe-dfo-bbo:acteurs:students:master:guillaume-lameynardie 

ne pointe pas vers une page mais vers une catégorie (l'équivalent d'un dossier), vous avez tous les droits sur votre catégorie, vous pouvez donc y créer/supprimer des pages et ajouter/supprimer des fichiers multimédia

Comme on l'a vu plus haut, pour créer une page, il faut faire deux choses :

1. un chemin qui pointe le futur emplacement de cette nouvelle page sur une page déjà existante ( chemin vers votre page perso sur la page Étudiants),
2. mettre du contenu sur la nouvelle page en l'éditant (sinon on a le message “cette page n'existe pas encore”, pour qu'elle existe il suffit de commencer à écrire).

J'ai fait la première étape, à vous de jouer pour la suite ! Remplissez votre main-page pour qu'elle prenne vie ;)

Pour ajouter votre photo sur la page des étudiants, il vous suffit d'utiliser le gestionnaire multimedia (menu en haut à droite) pour envoyer une photo dans votre catégorie et de la nommer portrait.jpg. L'affichage se fera tout seul car un lien pointe déjà vers ce nom de fichier.

Pour référencer du contenu il faut avoir du contenu à référencer, jusque là rien de surprenant me direz vous. C'est à ça que sert le gestionnaire multimédia (dans le menu en haut à droite, icône en forme de clé). Il vous permettra d'ajouter fichiers multimédia dans votre catégorie.

Seul problème, lorsque votre catégorie est vide, elle n’apparaît pas dans l'arborescence du gestionnaire multimédia. En fait, une catégorie existe uniquement si elle contient quelquechose. Ainsi, si vous êtes à votre racine, et que vous voulez envoyer test.pdf dans le dossier :retours, qui pour l'instant n'existe pas, il suffit de changer le nom du fichier en

 retours:test.pdf 

au moment de l'envoi.

Après ce premier envoi, vous pourrez utiliser le gestionnaire multimédia pour ajouter du contenu à votre catégorie sans ajouter de préfixe : la catégorie apparaît dans l'arborescence.

Note sur le plan du site : Seul les catégories contenant des pages dokuwiki apparaissent.

Note sur le gestionnaire multimedia : Seul les catégories contenant des fichiers multimédia apparaissent.

Pour une bonne gestion des retours, il faut :

• Une catégorie qui contienne les retours en question : .pdf annotés (je recommande de les nommer retour-aa-mm-jj.pdf, avec la date du jour du retour )
• une page qui met en relation le suivi des retours via une section commentaire

Pour faire référence à un fichier .pdf contenu dans retours via un commentaire, il suffit d'ajouter la ligne

 {{chemin:vers:retours:retour-aa-mm-jj.pdf| nom à afficher }} 

Un exemple d'arborescence pour les retours :

 
guillaume-lameynardie (categorie)
         |-main-page (page)
         |-version-a-commenter.pdf (fichier) <-dernière version du document
         |-retours (categorie)
         |    |-retour-20-01-01.pdf (fichier) <-retour le 1er janvier
         |    |-retour-20-01-02.pdf (fichier) <-retour le 2 janvier
         |    |-retour-20-01-03.pdf (fichier) <-retour le 3 janvier tous mentionné en commentaire
         |-suivi-redaction (page) <-c'est ici que la dernière version du document est rendu disponible et que la section commentaire est instanciée.

Le groupe @professeur a les droits en envoi sur la catégorie :students, les professeurs peuvent donc envoyer le pdf annoté dans la catégorie :retours de l'étudiant visé et le mentionner en commentaire à l'aide de la référence à un fichier

Voir cette page.