Écrire des pages en texte Wiki

Le format texte Wiki offre un outil pour formater du texte à l'aide de commandes de formatage intuitives et lisibles. Ces commandes sont automatiquement traduites en XHTML lors de l'affichage. Vous n'avez ainsi pas besoin d'apprendre le langage HTML pour produire des formats relativement complexes, et le texte que vous écrivez s'affiche correctement même avant son affichage définitif. Ce format offre une réelle alternative à l'enregistrement en HTML de fichiers Word, en permettant la modification en ligne de la ressource.

Sur le principe, vous tapez simplement du texte. Un certain nombre de caractères spéciaux vous permettent d'agir sur le format de ce texte.

### Formatage des paragraphes

Les paragraphes sont séparés par une ligne vide au moins. Pour changer le format d'un paragraphe, il suffit taper comme premier(s) caractère(s) de la première ligne du paragraphe l'un des codes suivants, suivi d'un espace.

Code | Type de paragraphe
--- | ---
Aucun | Paragraphe normal
> | Citation
Espace | Texte préformaté (police monospace)
% | Texte préformaté et le formatage Wiki est ignoré
!# | Titre - où # est un chiffre de 1 à 6, le niveau du titre (1 est le plus élevé)
Q. | Question - un formatage est ajouté au paragraphe pour améliorer la présentation des questions/réponses
A. | Réponse - comme ci-dessus, mais pour une réponse

### Formatage des listes

De simples listes peuvent être construites facilement en plaçant un caractère spécial au début de chaque ligne de la liste, suivi par un espace. La liste est terminée par une ligne vide. Les listes peuvent être imbriquées, et les listes imbriquées peuvent être de types différents. Les listes et les paragraphes peuvent être combinées pour obtenir le résultat désiré. Les caractères spéciaux sont les suivants.

Caractère | Type de liste
--- | ---
* | Liste non ordonnée (puces)
# | Liste ordonnée(1, 2, 3, etc.)
: (deux-point) | Liste descriptive, terme à définir
; (point-virgule) | Liste descriptive, définition

Exemple de liste imbriquée :

      * Première puce
      * Deuxième puce
      ## Ligne numérotée 1
      ## Ligne numérotée 2
      * Troisième puce

produira :

- Première puce
- Deuxième puce

1. Ligne numérotée 1
2. Ligne numérotée 2

- Troisième puce

### Formatage du texte

Le formatage du texte permet de marquer une partie d'une ligne dans un style différent. Les caractères spéciaux utilisés pour cela peuvent se placer n'importe où sur une ligne, mais ne peut chevaucher plusieurs lignes. Voici ces caractères.

Exemple | Résultat | Description
--- | --- | ---
*il fait beau* | il fait beau | Gras
/il fait beau/ | il fait beau | Italique
+il fait beau+ | il fait beau | Texte inséré
-il fait beau- | il fait beau | Texte supprimé
il fait ~world~ | il fait beau | Indice
il fait ^world^ | il fait beau | Exposant
"il fait beau" | “il fait beau” | Entre guillemets
%il fait beau% | `il fait beau` | Police monospace
@il fait beau@ | il fait beau | Citation

### Acronymes

La composition d'acronymes s'obtient en plaçant l'acronyme en lettres capitales, suivies de la description entre parenthèses. Il ne doit y avoir aucun espace entre l'acronyme et la parenthèse. Voici un exemple :

Exemple | Résultat
--- | ---
HTML(Hypertext Markup Language) | HTML

### Hyperliens

Les liens peuvent être écrits directement dans le texte, et suivi (sans espace) par le texte à afficher sur le lien. Les liens pour les adresses de courriel se traitent de la même manière.

Exemple | Résultat
--- | ---
http://www.google.fr/(Rechercher) | Rechercher
nobody@exemple.net(Utilisateur bidon) | Utilisateur bidon

### Liens vers des modules de Moodle

Si vous connaissez le numéro identifiant et le type d'un module dans Moodle, vous pouvez le lier directement en suivant la syntaxe TypeDuModule:nn(Texte descriptif) comme dans l'exemple ci-dessous. Le type de module doit être écrit suivant sa dénomitation originale en anglais.

Exemple
resource:36(Ma nouvelle page)
forum:10(Jump to forum)

### Liens vers des images de Moodle

Des images peuvent être placées dans les pages en texte Wiki. Il vous suffit de déposer l'image sur le site et de noter son chemin d'accès dans la zone des fichiers déposés. Vous utiliserez ensuite la syntaxe /chemin/d/accès/au/fichier(Texte alternatif).

Exemple
/photos/groupe.jpg(Photo du personnel)
/images/fr/menu.gif(Menu en français)

### Liens vers des fichiers de Moodle

De la même façon que les images, les fichiers préalablement déposés dans Moodle peuvent être liés sur les pages en texte Wiki. La syntaxe est file:/chemin/d/accès/au/fichier(Texte du lien).

Exemple
file:/textes/moodle.pdf(Manuel de Moodle)
file:/media/movies/navette.mov(Décollage de la navette)

### Formatage automatique

De nombreux textes sont automatiquement convertis en leur équivalent XHTML. Les principaux sont les suivants :

- Les liens HTTP sont convertis en liens actifs
- (R), (TM), (C), 1/4, 1/2, 3/4 sont tous transformés dans le caractère correct correspondant
- 123 x 456 affiche un symbole de multiplication correct
- Toute ligne commençant par au moins 4 tirets est convertie une ligne horizontale

### Correcteur orthographique (experimental)

Le moteur Wiki de Moodle peut être placé en mode correcteur orthographique. Si vous placez une ligne de la forme suivante, tout ce qui sera écrit ensuite sera vérifié.

    !SPELL:language_code:language_variant

Exemples :

    !SPELL:en:british
    !SPELL:fr

Le « language_code » doit être remplacé par le code adéquat (en, fr, de, etc.), « language_variant » et les deux-points qui le suivent sont facultatifs et peuvent être « american », « british » ou « canadian », dans le cas où le code de langue est en.

Les mots non reconnus sont mis en surbrillance et vous pouvez voir les suggestions en plaçant le pointeur sur le mot.

Remarque : le correcteur utilise les librairies pspell. Celles-ci doivent être installées sur le serveur, en compagnie des dictionnaires, pour que le correcteur fonctionne. Notamment, le système d'exploitation Windows n'est pas supporté.