= Quelques recommandations pour la contribution à ces pages... =
[[TracNav]]

L'édition de pages avec TracWiki est très simple. Se référer à la [wiki:TracWiki 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é. 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}}}

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 [wiki:Doc documentation Trac] sur ce site, en particulier la documentation des [wiki:Doc/Macros principaux macros].

Actuellement les documents disponibles sont organisés dans les arborescences suivantes (qui sont toutes sous l'URL wiki/) :

 * Apache : les différentes documentations relatives au serveur Web
 * Mail: les différentes documentations relatives au serveur Mail
 * Storage : les informations relatives aux disques, backup...
 * Divers : les documentations diverses

Merci d'essayer de respecter cette structure pour que le site reste gérable quand il grossira...!!!


Il est possible d'ajouter votre nouveau document dans la [http://svn.ipd.uka.de/trac/javaparty/wiki/TracNav/Usage 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 [wiki:SandBox page prévue] à cet effet.