Cette page décrit la syntaxe wiki utilisée par JSPWiki. Pour plus de détails sur les diffé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 !) des rè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 de la page [WikiEtiquette] est plus que recommandée, pour que vous sachiez quelle est la 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 texte Wiki pour utiliser un Wiki. Il suffit simplement d'écrire du texte normal, et d'utiliser une 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 va automatiquement 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, pour pointer 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] qui s'affichera [Home page Java|http://java.sun.com]. Si votre lien ne commence pas par l'un des "protocoles" ci-dessus, le wiki supposera qu'il s'agit d'un lien normal vers une autre page de l'espace wiki. Il faudra juste que le premier caractère du nom de la page soit une lettre, car des noms de page purement 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 depuis toute 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 lien vers 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'ils sont supportés, le mot CamelCase devrait lui-même être un lien). Par défaut, le support 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 hyperlien suffit à créer une référence à une note de base de page, comme ceci [[1] qui crée ce lien[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 bas de page de cette page). Vous pouvez aussi créer une note de bas de page nommée, comme si vous créiez un hyperlien 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]. Consultez la page [SystemInfo] pour plus d'informations sur la disponibilité des liens inter-wiki. Si un lien inter-wiki n'est pas supporté, une notification sera mise dans la page lorsqu'elle sera enregistrée. !Ajouter des images On peut insérer n'importe quelle image dans le code wiki : il suffit que l'image soit accessible quelque part sur le web dans un des formats reconnus, puis d'insérer un lien vers elle. Si vous spécifiez un texte lié ([[celui-ci|http://example.com/example.png]), celui-ci devient le texte ALTernatif affiché pour les utilisateurs qui ne peuvent ou ne veulent voir l'image. Vous pouvez aussi attacher une image, et y faire référence comme s'il s'agissait de n'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 des lé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 place de l'astérisque. Comme ceci : {{{ # Un \\ Un et demi # Deux # Trois ## Trois.Un }}} ce qui crée : # Un \\ Un et demi # Deux # Trois ## Trois.Un Pour que l'item de liste soit sur plusieurs lignes, il suffit d'ajouter un ou plusieurs espaces 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 commenter rapidement le texte de quelqu'un d'autre : il suffit de ne pas préciser de terme dans la 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 des double-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 lui ressemble beaucoup, mais qui n'est pas la même. Vous pouvez aussi [souligner|] votre texte en créant un lien hypertexte qui ne pointe vers rien, [[comme ceci|]. !Texte préformaté Pour insérer du texte préformaté (comme du code source), il suffit d'utiliser une triple accolade ouvrante ({) pour ouvrir un bloc, et une triple accolade fermante (}) pour le fermer. Vous en trouverez plusieurs exemples en éditant cette page. !Tableaux On peut insérer des tableaux grâce à de simples tubes ('|'). Chaque ligne correspond alors à 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 un tableau) : || 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 CSS sont 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éviendra au moment de modifier la page, et indiquera un conflit de page. Désolé, mais le premier qui enregistre ses modifications gagne... __Petit avertissement :__ Si vous utilisez le bouton "Retour" de votre navigateur pour revenir à la page d'édition, vous ferez très certainement face à un conflit avec vous-même. Simplement parce que le navigateur va penser qu'il est en train d'éditer une ancienne version de la page. !Supprimer des pages Normalement, ce n'est pas possible pour un utilisateur normal. On peut bien sûr supprimer tous les liens vers une page, ce qui la rend inaccessible. Mais seul l'administrateur est habilité à réellement supprimer la page. Pour cela, vous pouvez 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 de son [nom Wiki|JSPWiki:WikiName]. Cliquez sur ce nouveau lien qui devrait être rouge et souligné de manière discontinue 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 pour une 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 de base est la suivante : {{ [[{$nomVariable}], }} où ''nomVariable'' est le nom de la variable que vous voulez insérer. Notez les noms de variable 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 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|#2] L'autre note de bas de page. Notez comme son nom est différent ! ---- Des [idées|JSPWiki:IdeasTextFormattingRules] ? Des [questions|JSPWiki:TextFormattingRulesDiscussion] ?