====== Comment faire une (belle) page DokuWiki ======
===== Le markdown =====
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 : {{:groupe-dfo-bbo:icone.png?30|}}
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 [[https://www.dokuwiki.org/fr:wiki:syntax|ici]].
===== La création de page et l'arborescence =====
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 : {{:groupe-dfo-bbo:chemin-page.png?150|}}
Il est possible de voir la structure du site à l'aide du menu suivant, onglet "plan du site" :
{{:groupe-dfo-bbo:plan-du-site.png?200|}}
Sur la page [[groupe-dfo-bbo:acteurs:students | É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 [[groupe-dfo-bbo:acteurs:students | É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 [[https://www.dokuwiki.org/fr%3Anamespaces|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 :
- 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 [[groupe-dfo-bbo:acteurs:students | Étudiants]]),
- 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 ;)
===== Ajouter votre photo sur la page des étudiants =====
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.
=====Référencer des fichiers sur une page=====
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.
===== Construire une page dédiée aux retours =====
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
===== Créer une annonce pour une réunion =====
Voir cette [[groupe-dfo-bbo:reunions:template-reunion |page]].