Wiki du DRT

Outils d'utilisateurs

Outils du Site


playground:aide_a_la_syntaxe
Syntaxe de mise en page


Ce cours est largement inspiré du très bon wiki : http://dokuwiki.fr/

Tout utilisateur ayant des droits d'écriture sur une page peut la modifier en cliquant sur le bouton “Editer cette page”.

  • Les modifications sont prises en compte quand on clique sur le bouton “Enregistrer”.
  • Le bouton “Apercu” permet de visualiser la page comme elle sera affichée. A utiliser absolument afin de ne pas surcharger l'historique des modifications par de multiples corrections successives.
  • Le petit résumé facultatif permet de mieux suivre l’historique des modifs.
  • La case à cocher “Mineur” force à ne pas créer un historique (inutile de conserver 50 versions lorqu’on corrige juste un caractère !).


Un utilisateur non autorisé à modifier une page peut visualiser le code source avec le bouton “Afficher le texte source”. Très pratique pour visualiser des syntaxes qu'on ne connait pas.


—-

DokuWiki utilise un langage de balises simples, qui essaie de rendre les fichiers sources aussi lisibles et simples à écrire que possible. Les balises les plus simples sont facilement accessibles depuis les boutons d'accès rapide à la mise en page.

Création d'une nouvelle page

Pour créer une nouvelle page, il faut créer un lien interne en utilisant les crochets ou le bouton “lien interne” dans les boutons d'accès rapide à la mise en page.

Exemple : je suis une nouvelle page

Exemple : [[je suis une nouvelle page]]

Si la page n'existe pas encore, c'est à dire si aucun utilisateur n'a déjà créé une page ayant exactement le même nom dans le même répertoire, Dokuwiki affiche le message :

Ce sujet n'existe pas encore !
Vous avez suivi un lien vers un sujet qui n’existe pas encore. Si vos droits sont suffisants, vous pouvez utiliser le bouton ''Créer cette page''.

… si la page existe déjà … elle s'affichera lors du clic sur le lien !

Pour supprimer une page, il faut éditer la page, effacer tout le texte et enregistrer.

Avec le wiki, rien n'est jamais perdu. Le bouton “Anciennes révisions” permet de voir l'historique des modifications, visualiser les anciennes versions, les restaurer, etc…

Mise en forme de texte basique

DokuWiki supporte les textes en gras, italique, souligné et à espace fixe. Bien sûr, vous pouvez tous les combiner.

DokuWiki supporte les textes en **gras**, //italique//, __souligné__ et ''à espace fixe''. 
Bien sûr, vous pouvez tous les **__//''combiner''//__**.

Vous pouvez aussi utiliser indice et exposant.

Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.

De plus, vous pouvez marquer du contenu comme supprimé.

De plus, vous pouvez marquer du contenu comme <del>supprimé</del>.

Les paragraphes sont créés depuis les lignes vides. Si vous souhaitez forcer un saut de ligne sans paragraphe, vous pouvez utiliser deux antislashes suivis par un espace ou une fin de ligne.

Voilà du texte avec des sauts de ligne
remarquez que les deux antislashes sont seulement reconnus en fin de ligne
ou suivis par
un espace ; \\cela arrive sinon.

Voilà du texte avec des sauts de ligne\\ remarquez que les
deux antislashes sont seulement reconnus en fin de ligne\\
ou suivis par\\ un espace ; \\cela arrive sinon.\\

Exercice3


Découpage en sections ou titres

Vous pouvez utiliser jusqu'à cinq différents niveaux de titres afin de structurer votre contenu. Bouton H1 à H5. Si vous avez plus de trois titres, une table des matières (masquable) est générée automatiquement pour les trois premiers niveaux.

Titre niveau 2

Titre niveau 3

Titre niveau 4

Titre niveau 5
===== Titre niveau 2 =====
==== Titre niveau 3 ====
=== Titre niveau 4 ===
== Titre niveau 5 ==

Créer des titres permet de construire un sommaire mais permet aussi d'éditer une page par section.

En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : A utiliser avec modération


Exercice4


Listes

DokuWiki supporte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte par deux espaces et utilisez une * pour une liste non ordonnée ou un - pour une liste ordonnée.

  • Ceci est une liste
  • Le second élément
    • Vous pouvez avoir plusieurs niveaux
  • Un autre élément
  1. La même liste mais ordonnée
  2. Un autre élément
    1. Utilisez simplement l'indentation pour des niveaux plus profonds
  3. Et voilà
  * Ceci est une liste
  * Le second élément
    * Vous pouvez avoir plusieurs niveaux
  * Un autre élément

  - La même liste mais ordonnée
  - Un autre élément
    - Utilisez simplement l'indentation pour des niveaux plus profonds
  - Et voilà

Exercice5


Images et autres fichiers

Vous pouvez inclure des images externes et internes avec des accolades. Vous pouvez spécifier leur taille en pixel (facultatif).

Image externe :

Il est peu recommandé d'utiliser une image externe. Si l'image est supprimée du serveur le lien sera mort.

Il est préférable d'utiliser des images internes. L'image devra être

  1. déposée sur le wiki par le bouton “Ajouter des images et autres fichiers”
  2. Insérer l'image dans la page en cliquant dessus.

Image interne : Taille réelle : Redimension à une largeur donnée : Redimension à une largeur et une hauteur données :

Taille réelle :                                    {{wiki:dokuwiki-128.png}}
Redimension à une largeur donnée :                 {{wiki:dokuwiki-128.png?50}}
Redimension à une largeur et une hauteur données : {{wiki:dokuwiki-128.png?200x50}}

En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Bien sûr, vous pouvez aussi ajouter un titre (affiché comme une bulle d'info par la plupart des navigateurs).

Ceci est le titre

{{ wiki:dokuwiki-128.png |Ceci est le titre}}

De la même façon, vous pouvez spécifier un nom de fichier (externe ou interne) qui n'est pas une image (gif,jpeg,png), alors il sera affiché comme un lien et non comme une image. Un fichier interne devra avoir été déposé sur le wiki avec le bouton “Ajouter des images et autres fichiers”.

Tableau prévisionnel des migrations Scribe

{{scribe:deploiement-2007.xls|Tableau prévisionnel des migrations Scribe}}

Exercice6


Liens

DokuWiki propose plusieurs moyens de créer des liens.

Externes

Les liens externes sont reconnus automagiquement : http://www.google.fr ou simplement www.google.fr - Vous pouvez aussi donner des noms aux liens : Ce lien pointe vers google. Les adresses email telles que celle-ci : andi@splitbrain.org sont également reconnues.

Les liens externes sont reconnus automagiquement : http://www.google.fr 
ou simplement www.google.fr - Vous pouvez aussi donner des noms aux 
liens : [[http://www.google.fr|Ce lien pointe vers google]]. Les adresses 
email telles que celle-ci : <andi@splitbrain.org> sont également reconnues. 

Internes

Les liens internes sont créés en utilisant les crochets (bouton “lien interne”). Vous pouvez soit juste donner un nom de page ou utiliser un texte a afficher. Les noms de pages wiki sont convertis automatiquement en minuscules, les caractères spéciaux ne sont pas autorisés.

Les liens vers une section spécifique sont également possibles. Ajoutez simplement le nom de la section après un caractère dièse (#).

Ce lien renvoie vers cette section. Attention : si vous modifiez le titre de la section le lien de section ne marchera plus.

Ce lien renvoie vers [[Aide à la syntaxe#internes|cette section]]

Afin de gérer les droits des utilisateurs et structurer les pages, il peut être nécessaire de créer un lien dans un autre répertoire que le répertoire de la page courante

[[repertoire:nom de page|lien dans un autre répertoire que le répertoire de la page courante]]

Liens images

Vous pouvez aussi utiliser une image afin de créer un lien vers une autre page interne ou externe en combinant les syntaxes des liens et des images comme ceci :

[[http://www2.ac-lyon.fr/serv_ress/mission_tice/wiki/|{{wiki:dokuwiki-128.png}}]]

Exercice7


Notes de pied de page

Vous pouvez ajouter des notes de pied de page 1) en utilisant 2 doubles parenthèses.

Vous pouvez ajouter des notes de pied de page ((Ceci est une note de pied de page)) en utilisant 2 doubles parenthèses.

Tableaux

DokuWiki propose une syntaxe simple pour créer des tableaux.

Titre 1 Titre 2 Titre 3
Ligne 1 Col 1 Ligne 1 Col 2 Ligne 1 Col 3
Ligne 2 Col 1 colonnes fusionnées (notez la double barre verticale)
Ligne 3 Col 1 Ligne 2 Col 2 Ligne 2 Col 3

Les lignes de tableau doivent commencer et terminer avec un pipe | pour des lignes normales ou avec un ^ pour les titres.

^ Titre 1         ^ Titre 2           ^ Titre 3                             ^
| Ligne 1 Col 1   | Ligne 1 Col 2     | Ligne 1 Col 3                       |
| Ligne 2 Col 1   | colonnes fusionnées (notez la double barre verticale)  ||
| Ligne 3 Col 1   | Ligne 2 Col 2     | Ligne 2 Col 3                       |

Pour fusionner des cellules horizontalement (colspan), rendez simplement la cellule suivante complètement vide comme montré ci-dessus. Assurez-vous d'avoir toujours le même nombre de séparateurs de cellules !

Les titres de tableau verticaux sont également possibles.

Titre 1 Titre 2
Titre 3 Ligne 1 Col 2 Ligne 1 Col 3
Titre 4 pas de fusion cette fois
Titre 5 Ligne 2 Col 2 Ligne 2 Col 3

Comme vous pouvez le constater, c'est le séparateur ('|' ou '^') précédant une cellule qui détermine le format :

|              ^ Titre 1                  ^ Titre 2          ^
^ Titre 3      | Ligne 1 Col 2            | Ligne 1 Col 3    |
^ Titre 4      | pas de fusion cette fois |                  |
^ Titre 5      | Ligne 2 Col 2            | Ligne 2 Col 3    |

Note : les fusions verticales (rowspan) ne sont pas possibles.

Vous pouvez également aligner le contenu du tableau. Ajoutez simplement au moins deux espaces blancs à l'extrémité opposée à votre texte : ajoutez deux espaces sur la gauche pour aligner à droite, deux espaces sur la droite pour aligner à gauche et deux espaces au moins à chaque extrémité pour centrer le texte.

Tableau avec alignement
droite centré gauche
gauche droite centré
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Voici à quoi ça ressemble dans le code source :

^          Tableau avec alignement         ^^^
|        droite|    centré   |gauche         |
|gauche        |       droite|    centré     |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Exercice8


Ecrire du Dokuwiki avec OpenOffice

Une macro très pratique qui permet de convertir un texte openoffice en syntaxe dokuwiki : http://homepages.paradise.net.nz/hillview/OOo/DokuWiki.sxw

Et pour les tableau : http://www.lucsorel.com/index.php?page=downloads

Organisation des pages

Toutes les données sont stockées dans des fichiers texte – aucune base de donnée n'est requise. Quand on crée une page, il est possible de spécifier son répertoire. Voir création de liens internes.

Définir des répertoires est indispensable pour pouvoir gérer des droits différents sur les pages.

Gestion des utilisateurs et des droits

Uniquement pour les membres du groupe “Admin”. Voir http://dokuwiki.fr/doku.php?id=wiki:gestion_des_utilisateurs

Pour aller plus loin

1) Ceci est une note de pied de page
playground/aide_a_la_syntaxe.txt · Dernière modification: 2008/05/07 11:13 (modification externe)