wiki:Doc/Wiki

Version 14 (modified by Michel Jouvin, 18 years ago) (diff)

--

Quelques recommandations pour la contribution à ces pages…

L'édition de pages avec TracWiki est très simple. Se référer à la documentation pour la description des différentes commandes de formattage. D'une façon générale, les commandes de formattage consistent en des balises au fil du texte. Les balises encadrent le texte affecté.

Balises les Plus Courantes

Les plus utiles sont :

  • marqueur de titre : =. On peut avoir jusqu'à 5 niveaux de titre. Le nombre de = détermine le niveau du titre
  • les listes à puces (comme celle-ci ): ligne commençant par un * (ou 1. pour une liste numérotée). Pour un niveau de liste donné, toutes les * doivent être alignés sur la même colonne. On peut imbriquer les listes à puces en décalant les *.
  • souligner : le texte à souligner doit être encadré par __.
  • mettre en gras : le texte à mettre en gras doit être encadré par '''
  • mettre en italique : le texte à mettre en gras doit être encadré par ''
  • exposant : met le texte en exposant
  • indice : met le texte en indice
  • tableau : chaque cellule est séparé par ||. La ligne doit commencer par ||.

On peut écrire des mots, des morceaux de phrase ou des paragraphes en mode verbatim, en mettant le texte entre {{{ et }}} ou entre `. Si les balises {{{ et }}} sont seules sur la ligne, le texte compris entre les 2 balises est mis dans une division spécifique, comme dans l'exemple suivant :

Exemple de division verbatim

à la différence de (voir le source de cette page) :

Exemple de division verbatim

Balisage Avancé

Il existe quelques autres instructions de balisage moins utilisées.

Pour ecrire une énumération, on peut utiliser la syntaxe suivante (la première ligne doit commencer par un espace) :

 liste::
  un deux trois

qui sera affiché :

liste
un deux trois

Editer une Nouvelle Page

Pour éditer une nouvelle page, il suffit de lui donner un nom, soit en la référençant dans un autre document, soit en donnant son url. Si vous écrivez une nouvelle page, merci de la commencer par un titre de premier niveau et de mettre en deuxième ligne la barre de navigation. Ceci se fait de la manière suivante :

= Titre de la page =
[[TracNav]]

Si on souhaite ajouter une table des matières en tête du document, on peut ajouter l'instruction suivante :

[[TOC(inline)]]

TOC, TracNav sont des macros qui étendent les fonctionnalités de base de TracWiki. Pour plus d'information sur les macros installés au LAL, se référer à la documentation Trac sur ce site, en particulier la documentation des principaux macros.

Il est possible d'ajouter votre nouveau document dans la barre de navigation, au moyen de son menu 'edit'. Le contenu de la barre de navigation est décrit dans une page qui obéit à la même syntaxe que celle de toutes pages de TracWiki mais sa partie utile est un ensemble de liste à puces qui sera décrit ultérieurement.

Cette page est une illustration de ces quelques principes. Vous pouvez voir la syntaxe utilisée en entrant le mode édition de cette page (bouton 'Edit this page' en bas de la page). Pour vous exercer, n'hésitez pas à utiliser la page prévue à cet effet.