É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.

CodeType de paragraphe
AucunParagraphe normal
>Citation
EspaceTexte 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èreType 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.

ExempleRésultatDescription
*il fait beau*il fait beauGras
/il fait beau/il fait beauItalique
+il fait beau+il fait beauTexte inséré
-il fait beau-il fait beauTexte supprimé
il fait ~world~il fait beauIndice
il fait ^world^il fait beauExposant
"il fait beau"“il fait beau”Entre guillemets
%il fait beau%il fait beauPolice monospace
@il fait beau@il fait beauCitation

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 :

ExempleRé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.

ExempleRé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é.

Index de tous les fichiers d'aide