
Cette page décrit la syntaxe wiki utilisée par JSPWiki. Pour plus de détails sur lesdifférences entre la syntaxe de JSPWiki et celle de Wikipedia, veuillez vous référerà la page en anglais [MigratingFromMediaWiki](JSPWiki:MigratingFromMediaWiki).

Vous trouverez également une version plus complète (et beaucoup plus longue !) desrègles de formatage dans la [liste complète des règles de formatage](FullTextFormattingRules).

[{TableOfContents title='Table des matières'}]()   
Une fois que vous aurez compris comment fonctionne l'éditeur, une petite lecture dela page [WikiEtiquette]() est plus que recommandée, pour que vous sachiez quelle estla meilleure manière d'utiliser vos connaissances nouvellement acquises. Le[bac à sable](SandBox) est le meilleur endroit pour faire des essais.

#### Référence rapide

``
----       = Insère un séparateur horizontal. Les '-' supplémentaires sont ignorés.
\\         = Force un retour à la ligne.

[lien]     = Insère un hyperlien vers une WikiPage interne appelée 'Lien'.
[ceci est aussi un lien] = Insère un hyperlien vers une WikiPage interne appelée
             'CeciEstAussiUnLien', en montrant un lien avec les espaces.
[cliquez là|lien] = Insère un hyperlien vers une WikiPage interne appelée 'Lien',
             mais affiche le texte 'cliquez là' plutôt que 'Lien' à l'utilisateur.
~PasDeLien = Evite la création d'un lien pour le mot en CamelCase.
[1]        = Insère une référence à une note de bas de page numérotée 1.
[#1]       = Marque la note de bas de page numéro 1.
[[link]    = Insère le texte '[link]'.

!titre   = Insère un petit titre avec le texte 'titre'
!!titre  = Insère un titre moyen avec le texte 'titre'
!!!titre = Insère un titre gros  avec le texte 'titre'

''texte''   = Affiche 'texte' en italique.
__texte__   = Affiche 'texte' en gras.
{{texte}}   = Affiche 'texte' en police de caractères à taille fixe.
[texte|]    = Affiche 'texte' en souligné (faux lien hypertexte)

* texte     = Insère un item de liste à puces avec le 'texte'
# texte     = Insère un item de liste à numéros avec le 'texte'
;terme:ex   = Insère une définition pour le 'terme' avec l'explication 'ex'
``

#### Ecrire du texte

Il n'y a pas besoin de connaître quoi que ce soit sur les règles de formatage du texteWiki pour utiliser un Wiki. Il suffit simplement d'écrire du texte normal, et d'utiliserune ligne vide pour marquer un paragraphe. C'est comme écrire un e-mail.

Vous pouvez toujours éditer cette page avec le lien 'Edit' (en haut du texte de la page)pour voir la manière dont les différents effets possibles sont utilisés dans cette page.

#### [Ins�]()�rer un lien vers une [WikiPage]()

Il suffit de taper le nom de la page entre crochets : [[Comme ceci]. Cela vaautomatiquement créer un lien vers une page.

#### [Ins�]()�rer des liens

Le lien peut aussi être une URL directe commençant par http:, ftp:, mailto:, https:,ou news:. Dans ce cas, le lien pointe vers une entité externe. Par exemple, pourpointer vers la page de garde java.sun.com, il suffit d'écrire [[http://java.sun.com]qui s'affichera [http://java.sun.com/](), ou [[Home page Java|[http://java.sun.com]()] quis'affichera [Home page Java](http://java.sun.com).

Si votre lien ne commence pas par l'un des "protocoles" ci-dessus, le wiki supposeraqu'il s'agit d'un lien normal vers une autre page de l'espace wiki. Il faudra justeque le premier caractère du nom de la page soit une lettre, car des noms de pagepurement numeriques sont interdits. Si vous voulez utiliser des crochets (`[[]`)dans votre page sans créer de lie hypertexte, doublez votre crochet ouvrant.Ainsi, le texte `[[[Exemple Non-Lien]` apparaîtra comme ceci : `[[Exemple Non-Lien]`.

Pour ajouter une nouvelle page, il vous suffit de créer un lien vers celle-ci depuistoute autre page (alors même que la nouvelle page n'existe pas encore !).Vous verrez alors le nom de la page être souligné de rouge pointillé dans le lienvers votre nouvelle page. Cliquez dessus, et votre page est créée !

Il est possible d'utiliser à peu près n'importe quel caractère à l'intérieur d'un[Nom Wiki](JSPWiki:WikiName), tant qu'il s'agit de lettres ou de chiffres.

Ce Wiki peut être configuré pour supporter les liens [CamelCase]() standards (s'ilssont supportés, le mot [CamelCase]() devrait lui-même être un lien). Par défaut, lesupport de [CamelCase]() est désactivé.

### Notes de base de page

Ceux-ci sont des hyperliens spéciaux. Un simple numéro à l'intérieur d'un hyperliensuffit à créer une référence à une note de base de page, comme ceci [[1] qui crée celien[1](). Pour insérer la véritable note de bas de page, insérez juste un [[#1] là oùvous voulez que votre note se trouve (regardez plus bas pour trouver la note de basde page de cette page).

Vous pouvez aussi créer une note de bas de page nommée, comme si vous créiez unhyperlien classique. Par exemple, ceci se réfère à la même note[Note de bas de page numéro 1](1) que la référence ci-dessus, mais cela se réfèreà une autre note de bas de page[2]().

#### Liens [inter-wiki](JSPWiki:InterWiki)

On peut aussi insérer des liens entre différents Wikis sans connaître leur URL.En utilisant la forme [[Wiki:[PageWiki]()], JSPWiki vous créera un lien inter-wiki.Par exemple, ce lien pointe vers les[Règles de formatage de texte JSPWiki](JSPWiki:TextFormattingRules). Consultezla page [SystemInfo]() pour plus d'informations sur la disponibilité des liensinter-wiki.

Si un lien inter-wiki n'est pas supporté, une notification sera mise dans la pagelorsqu'elle sera enregistrée.

#### Ajouter des images

On peut insérer n'importe quelle image dans le code wiki : il suffit que l'image soitaccessible quelque part sur le web dans un des formats reconnus, puis d'insérer un lienvers elle.

Si vous spécifiez un texte lié ([[celui-ci|[http://example.com/example.png]()]), celui-cidevient le texte ALTernatif affiché pour les utilisateurs qui ne peuvent ou ne veulentvoir l'image.

Vous pouvez aussi attacher une image, et y faire référence comme s'il s'agissait den'importe quelle autre page. Vous pouvez consulter la page[WikiAttachments](JSPWiki:WikiAttachments) pour plus d'informations.

Si vous avez besoin de plus de contrôle sur la présentation (ou des choses comme deslégendes), regardez du côté du [plugin Image](JSPWiki:Image).Il peut faire beaucoup plus que simplement insérer une image.

La liste des types d'image acceptés dépend du Wiki (cf. la page [Infos système](SystemInfo)pour consulter cette liste).

#### Listes à puces

Utiliser un astérisque (*) dans la première colonne permet d'insérer un item de listeà puces. Plus il y a d'astérisques, plus le niveau d'imbrication de l'item est grand.Par exemple :

``
* Un \\ Un et demi
* Deux
* Trois
** Trois.Un
``

crée :

* Un   
Un et demi
* Deux
* Trois
    * Trois.Un

#### Listes à numéros

Cela fonctionne comme les listes à puces, sauf qu'on utilise un dièse (#) à la placede l'astérisque. Comme ceci :

``
# Un \\ Un et demi
# Deux
# Trois
## Trois.Un
``

ce qui crée :

1. Un   
Un et demi
1. Deux
1. Trois
    1. Trois.Un

Pour que l'item de liste soit sur plusieurs lignes, il suffit d'ajouter un ou plusieursespaces en début de ligne, et la ligne sera automatiquement ajoutée à l'item précédent.Par exemple :

``
* Ceci est un item sur une seule ligne.
* Ceci est en fait un item sur plusieurs lignes.
  On continue l'item avec une seconde phrase sur sa propre ligne.
  On peut même faire une troisième ligne de texte tant qu'on y est...
  Remarquez cependant que toutes ces phrases se retrouvent dans le même item de liste !
* Le troisième item est, lui, sur une seule ligne.
``
ce qui donne :
* Ceci est un item sur une seule ligne.
* Ceci est en fait un item sur plusieurs lignes. On continue l'item avec une seconde phrase sur sa propre ligne. On peut même faire une troisième ligne de texte tant qu'on y est... Remarquez cependant que toutes ces phrases se retrouvent dans le même item de liste !
* Le troisième item est, lui, sur une seule ligne.

#### Listes de définition et commentaires

La manière la plus simple pour insérer une liste de définitions est d'utiliser l'outil';:' :

**Outil** : _Quelque chose que vous utilisez pour faire un truc_

L'outil `;:` a ceci de pratique que l'on peut aussi l'utiliser pour commenterrapidement le texte de quelqu'un d'autre : il suffit de ne pas préciser de terme dansla définition, comme ceci :

``
;:''Ceci est mon commentaire.''
``

Qui apparaîtra comme cela :

: _Ceci est mon commentaire._

#### Effets sur le texte

Vous pouvez rendre le texte **gras** ou _italique_, en utilisant respectivement desdouble-soulignés (_) et des double-apostrophes ('). Sur un ordinateur sous Windows,assurez-vous que vous utilisez la bonne apostrophe, car il en existe une autre qui luiressemble beaucoup, mais qui n'est pas la même.

Vous pouvez aussi <!---->souligner{style:'text-decoration:underline;'} votre texte en créant un lien hypertexte qui ne pointevers rien, [[comme ceci|].

#### Texte préformaté

Pour insérer du texte préformaté (comme du code source), il suffit d'utiliser une tripleaccolade ouvrante ({) pour ouvrir un bloc, et une triple accolade fermante (}) pour lefermer. Vous en trouverez plusieurs exemples en éditant cette page.

#### Tableaux

On peut insérer des tableaux grâce à de simples tubes ('|'). Chaque ligne correspondalors à une ligne du tableau, à condition que : * un double tube commence une cellule d'en-tête de tableau ; * un tube unique commence une cellule classique de tableau.Le tableau se termine par une ligne qui n'est pas une ligne de tableau.

Par exemple :

``
|| Titre 1 || Titre 2
| ''Gober'' | Barre
| [Page principale|Main]     | [Entraînez-vous ici|Sandbox]
``

affiche le tableau suivant (notez comment on peut aussi insérer des liens dans untableau) :

| Titre 1 | Titre 2
| _Gober_ | Barre
| [Page principale](Main) | [Entraînez-vous ici](Sandbox)

#### Styles CSS

Bien qu'ils contreviennent à la règle de simplicité du Wiki, les styles CSSsont utilisables [au sein des pages Wikis](JSPWiki:CSSInWikipages) pour les cas particuliers où vous voulez mettre en évidence un morceau de page.

#### Conflits

Si quelqu'un édite la même page en même temps que vous, JSPWiki vous préviendraau moment de modifier la page, et indiquera un conflit de page. Désolé, mais lepremier qui enregistre ses modifications gagne...

**Petit avertissement :** Si vous utilisez le bouton "Retour" de votre navigateurpour revenir à la page d'édition, vous ferez très certainement face à un conflitavec vous-même. Simplement parce que le navigateur va penser qu'il est en traind'éditer une ancienne version de la page.

#### Supprimer des pages

Normalement, ce n'est pas possible pour un utilisateur normal. On peut bien sûrsupprimer tous les liens vers une page, ce qui la rend inaccessible. Mais seull'administrateur est habilité à réellement supprimer la page. Pour cela, vouspouvez lui envoyer un e-mail, ou bien, à la rigueur, ajouter un lien vers la page[DELETEME](JSPWiki:DELETEME).

#### Ajouter de nouvelles pages

[Cr�]()�ez un lien qui pointe vers une nouvelle (et inexistante) page à l'aide deson [nom Wiki](JSPWiki:WikiName).Cliquez sur ce nouveau lien qui devrait être rouge et souligné de manièrediscontinue et vous obtiendrez un éditeur pour la nouvelle page.

#### Faire un renvoi automatique d'une page vers une autre

Il est possible que vous vouliez qu'un nom de page Wiki soit en fait un autre nom pourune page Wiki existante. C'est ce qu'on appelle un [alias de page](PageAlias).

#### [Ins�]()�rer des variables

Il existe de nombreuses variables que vous pouvez insérer dans une page. La syntaxe debase est la suivante :` [[{$nomVariable}], `où _nomVariable_ est le nom de la variable que vous voulez insérer. Notez les noms devariable sont insensibles à la casse - autrement dit, "nompage" est identique à "nOMpAgE"ou "[NomPage]()".

Toutes les variables prédéfinies sont dans [WikiVariables](JSPWiki:WikiVariables).

### [Ins�]()�rer des plugins

L'incantation de base pour insérer un plugin ressemble à ceci :

`` [[{INSERT <classe plugin> WHERE param1=valeur, param2=valeur, ...}] ``

Vous trouverez plus d'information sur le sujet dans [JSPWikiPlugins](JSPWiki:JSPWikiPlugins).

* * *
[#1] Voici la note de bas de page que j'ai mentionnée.   
[L'autre note de bas de page] L'autre note de bas de page. Notez comme son nom est différent !
* * *
Des [idées](JSPWiki:IdeasTextFormattingRules) ?Des [questions](JSPWiki:TextFormattingRulesDiscussion) ?
