Code source wiki de Guide de syntaxe XWiki

Modifié par Administrator le 2013/06/04 01:06
Afficher les derniers auteurs
1 {{velocity}}$xwiki.get('ssx').use($doc.getFullName()){{/velocity}}
2
3 {{box cssClass="floatinginfobox" title="**Contents**"}}
4 {{toc depth="1"/}}
5 {{/box}}
6
7 À partir de XWiki Enterprise 1.7, nous avons introduit une nouvelle syntaxe wiki. Alors, nous dénommons la syntaxe précédente la //Syntaxe XWiki v1.0//, tandis que la nouvelle syntaxe est logiquement appelée la //Syntaxe XWiki v2.0//. Les raisons principales pour l'introduction de la nouvelle syntaxe ont été les suivantes:
8
9 * Corriger les limitations et les ambiguïtés de la syntaxe XWiki 1.0.
10 ** Les symboles sous-optimales. Par exemple, le symbole pour le texte gras était représenté par des astérisques simples. Cela causait des problèmes lorsque les utilisateurs renseignaient du texte contenant des astérisques, parce que celui-ci était considéré comme gras lorsqu'il ne l'était pas. C'est pourquoi nous avons rationalisé la syntaxe en utilisant partout des caractères doubles.
11 ** Ambiguïtés. Par exemple il y avait une ambiguïté entre un élément de gras placé au début d'une ligne et une liste à puces. La résolution du problème des ambiguïtés était nécessaire pour réécrire l'éditeur WYSIWYG afin qu'il puisse être déterministe.
12 * Être plus près de la syntaxe [[Creole 1.0>>http://www.wikicreole.org/]] qui devient une norme pour la syntaxe wiki. En outre, la communauté Creole a pris son temps d'analyser toutes les syntaxes wiki existantes avant de décider sur les symboles.
13
14 Depuis l'introduction de la syntaxe XWiki 2.0, quelques lacunes de cette syntaxe ont été trouvées. Pour y remédier, la syntaxe XWiki 2.1, actuellement //expérimentale//, a été ajoutée dans XWiki Enterprise version 3.0. Cette nouvelle syntaxe a été notamment développée pour les raisons suivantes:
15 * Homogénéiser la syntaxe des liens et des images pour plus de cohérence et de clarté, ainsi que la possibilité de l'étendre ultérieurement.
16 * Ajouter la possibilité d'afficher des icônes, d'utiliser la notation UNC pour ajouter des liens, et de créer des liens vers des adresses relatives.
17
18 {{info}} La syntaxe XWiki 2.1 étant basée sur la syntaxe XWiki 2.0, toute la syntaxe XWiki 2.0 reste valable sauf si les caractéristiques de la syntaxe XWiki 2.1 précisent un changement. {{/info}}
19
20 (((
21 En plus de ces 2 syntaxes XWiki, nous avons aussi changé notre moteur de rendu sous-jacent (précédemment c'était Radeox) en faveur de notre propre moteur, qui est un sur-ensemble emballé autour de [[Wikimodel>>http://code.google.com/p/wikimodel/]] et [[Doxia>>http://maven.apache.org/doxia/]] (et éventuellement d'autres dans le futur). Cela nous a permis de fournir d'autres syntaxes dans le wiki: [[MediaWiki, Confluence, JSPWiki, Creole, TWiki et plus>>#HD'autressyntaxes]].
22 )))
23
24 = Remarques générales =
25
26 La syntaxe XWiki v2.0 corrige quelques erreurs et le problème de la syntaxe ambiguë comme indiqué dans les exemples du tableau ci-dessous:
27
28 |=Description|=Exemple de syntaxe invalide ou ambiguë|=Corrigé dans la syntaxe XWiki 2.0
29 |Des styles de texte non fermés|{{{**gras}}}|{{{**gras**}}}
30 |Deux éléments autonomes non séparés par 2 nouvelles lignes|{{{| cellule de tableau}}}
31 {{{* élément de liste}}}|{{{| cellule de tableau}}}
32 \\{{{* élément de liste}}}
33 |Deux éléments autonomes non séparés par 2 nouvelles lignes|{{{paragraphe}}}
34 {{{----}}}
35 {{{paragraphe}}}|{{{paragraphe}}}
36 \\{{{----}}}
37 \\{{{paragraphe}}}
38 |Nouvelle ligne ignorée au début du document|<nouvelle ligne au début du document>
39 paragraphe|paragraphe
40 |La syntaxe avec des titres non fermés|{{{=== titre}}}|{{{=== titre ===}}}
41
42 = Paragraphes =
43
44 Les paragraphes sont des éléments de texte séparés par 2 ou plusieurs nouvelles lignes.
45
46 {{info}}
47 En syntaxe XWiki 2.0, on tient compte des lignes nouvelles, ce qui n'est pas le cas des syntaxes XWiki 1.0 et Creole.
48 {{/info}}
49
50 (% style="width: 99%;" %)
51 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat de la syntaxe XWiki 1.0|=Résultat de la syntaxe XWiki 2.0
52 |Paragraphe simple|Ceci est un paragraphe simple|Ceci est un paragraphe|Ceci est un paragraphe|Ceci est un paragraphe
53 |Paragraphe sur plusieurs lignes |Paragraphe sur{{{\\}}}
54 plusieurs lignes|Paragraphe sur
55 plusieurs lignes|Paragraphe sur
56 plusieurs lignes|Paragraphe sur
57 plusieurs lignes
58 |Deux paragraphes|Le premier paragraphe
59 \\Le deuxième paragraphe|Le premier paragraphe
60 \\Le deuxième paragraphe|Le premier paragraphe
61 \\Le deuxième paragraphe|Le premier paragraphe
62 \\Le deuxième paragraphe
63 |Paragraphe paramétré|<p style="text-align:center;
64 color:blue">
65 Paragraphe centré et bleu</p>|{{{(% style="text-align:center;
66 color:blue" %)}}}
67 Paragraphe centré et bleu|(% style="text-align: center; color: blue;" %)
68 Paragraphe centré et bleu|(% style="text-align: center; color: blue;" %)
69 Paragraphe centré et bleu
70
71 = Titres =
72
73 (% style="width: 99%;" %)
74 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
75 |Titres standard|(((
76 1 niveau 1
77 1.1 niveau 2
78 1.1.1 niveau 3
79 1.1.1.1 niveau 4
80 1.1.1.1.1 niveau 5
81 1.1.1.1.1.1 niveau 6
82 )))|(((
83 {{{= niveau 1 =
84 == niveau 2 ==
85 === niveau 3 ===
86 ==== niveau 4 ====
87 ===== niveau 5 =====
88 ====== niveau 6 ======}}}
89 )))|(((
90 {{html}}
91 <!-- Note: replace this with wiki syntax when http://jira.xwiki.org/jira/browse/XWIKI-4358 is implemented -->
92 <h1 id="Hlevel1"><span>niveau 1</span></h1><p>&nbsp;</p><h2 id="Hlevel2"><span>niveau 2</span></h2><h3 id="Hlevel3"><span>niveau 3</span></h3><h4 id="Hlevel4"><span>niveau 4</span></h4><h5 id="Hlevel5"><span>niveau 5</span></h5><h6 id="Hlevel6"><span>niveau 6</span></h6>
93 {{/html}}
94 )))
95 |Titres paramétrés|<h1><span style="color:blue">
96 titre</span></h1>|{{{(% style="color:blue" %)}}}
97 ~= titre =|(((
98 {{html}}
99 <h1 id="Hheading" style="color:blue"><span>titre</span></h1>
100 {{/html}}
101 )))
102 |Titres en syntaxe wiki|1.1.1 Titre en *gras*|{{{=== Titre en **gras** ===}}}|(((
103 === Titre en **gras** ===
104 )))
105
106 = Formatage du texte =
107
108 {{info}}
109 Nouveau en syntaxe XWiki 2.0 sur la syntaxe XWiki 1.0:
110 * Les espaces sont autorisés, juste après les symboles de syntaxe.
111 * L'utilisation des symboles doubles au cas où il y avait seulement un symbole en syntaxe XWiki 1.0, de sorte qu'il soit moins probable que l'utilisateur s'en serve dans le texte de manière erronée.
112 * La possibilité d'avoir plusieurs lignes.
113 {{/info}}
114
115 (% style="width: 99%;" %)
116 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
117 |Gras|{{{*gras*}}}|{{{**gras**}}}|**gras**
118 |Souligné|{{{__souligné___}}}|{{{__souligné__}}}|__souligné__
119 |Italique|{{{~~italique~~}}}|{{{//italique//}}}|//italique//
120 |Barré|{{{--barré--}}}|{{{--barré--}}}|--barré--
121 |Espacement fixe|<tt>espacement fixe</tt>|{{{##espacement fixe##}}}|##espacement fixe##
122 |Puissance|utilisation de la <sup>puissance</sup>|{{{utilisation de la ^^puissance^^}}}|utilisation de la ^^puissance^^
123 |Indice|utilisation de l'<sub>indice</sub>|{{{utilisation de l',,indice,,}}}|utilisation de l',,indice,,
124
125 = La ligne horizontale =
126
127 (% style="width: 99%;" %)
128 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
129 |Ligne horizontale simple|{{{----}}}|{{{----}}}|(((
130 ----
131 )))
132 |Ligne horizontale paramétrée|<hr style="color:blue"/>|(((
133 {{{(% style="color:blue" %)
134 ----}}}
135 )))|(((
136 (% style="color: blue;" %)
137 ----
138 )))
139
140 = Listes =
141
142 (% style="width: 99%;" %)
143 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
144 |Liste à puces|(((
145 {{{* élément 1
146 ** élément 2
147 *** élément 3
148 * élément 4}}}
149 )))|(((
150 {{{* élément 1
151 ** élément 2
152 *** élément 3
153 * élément 4}}}
154 )))|(((
155 * élément 1
156 ** élément 2
157 *** élément 3
158 * élément 4
159 )))
160 |Liste numérotée|(((
161 {{{1. élément 1
162 11. élément 2
163 111. élément 3
164 1. élément 4}}}
165 )))|(((
166 {{{1. élément 1
167 11. élément 2
168 111. élément 3
169 1. élément 4}}}
170 )))|(((
171 1. élément 1
172 11. élément 2
173 111. élément 3
174 1. élément 4
175 )))
176 |Liste mixte|(((
177 {{{1. élément 1
178 1*. élément 2
179 1*. élément 3
180 1. élément 4}}}
181 )))|(((
182 {{{1. élément 1
183 1*. élément 2
184 1*. élément 3
185 1. élément 4}}}
186 )))|(((
187 1. élément 1
188 1*. élément 2
189 1*. élément 3
190 1. élément 4
191 )))
192 |Liste aux carrés|(((
193 {{{- élément 1
194 - élément 2}}}
195 )))|(((
196 {{{(% style="list-style-type: }}}
197
198 square" %)
199 ~* élément 1
200 ~* élément 2
201 )))|(((
202 (% style="list-style-type: square;" %)
203 * élément 1
204 * élément 2
205 )))
206 |Liste aux disques|(((
207 <ul style="list-style-type:
208
209 disc">
210 <li>élément 1</li>
211 <li>élément 2</li>
212 </ul>
213 )))|(((
214 {{{(% style="list-style-type: }}}
215
216 disc" %)
217 ~* élément 1
218 ~* élément 2
219 )))|(((
220 (% style="list-style-type: disc;" %)
221 * élément 1
222 * élément 2
223 )))
224 |Liste alphabétique en minuscules|(((
225 {{{a. élément 1
226 a. élément 2}}}
227 )))|(((
228 {{{(% style="list-style-type: }}}
229
230 lower-alpha" %)
231 ~* élément 1
232 ~* élément 2
233 )))|(((
234 (% style="list-style-type: lower-alpha;" %)
235 * élément 1
236 * élément 2
237 )))
238 |Liste alphabétique en majuscules|(((
239 {{{A. élément 1
240 A. élément 2}}}
241 )))|(((
242 {{{(% style="list-style-type: }}}
243
244 upper-alpha" %)
245 ~* élément 1
246 ~* élément 2
247 )))|(((
248 (% style="list-style-type: upper-alpha;" %)
249 * élément 1
250 * élément 2
251 )))
252 |Liste Romaine en minuscules|(((
253 {{{i. élément 1
254 i. élément 2}}}
255 )))|(((
256 {{{(% style="list-style-type: }}}
257
258 lower-roman" %)
259 ~* élément 1
260 ~* élément 2
261 )))|(((
262 (% style="list-style-type: lower-roman;" %)
263 * élément 1
264 * élément 2
265 )))
266 |Liste Romaine en majuscules|(((
267 {{{I. élément 1
268 I. élément 2}}}
269 )))|(((
270 {{{(% style="list-style-type: }}}
271
272 upper-roman" %)
273 ~* élément 1
274 ~* élément 2
275 )))|(((
276 (% style="list-style-type: upper-roman;" %)
277 * élément 1
278 * élément 2
279 )))
280 |Liste Grecque en minuscules|(((
281 {{{g. élément 1
282 g. élément 2}}}
283 )))|(((
284 {{{(% style="list-style-type: }}}
285
286 lower-greek" %)
287 ~* élément 1
288 ~* élément 2
289 )))|(((
290 (% style="list-style-type: lower-greek;" %)
291 * élément 1
292 * élément 2
293 )))
294 |Liste Grecque en majuscules|(((
295 {{{G. élément 1
296 G. élément 2}}}
297 )))|(((
298 {{{(% style="list-style-type: }}}
299
300 upper-greek" %)
301 ~* élément 1
302 ~* élément 2
303 )))|(((
304 * élément 1
305 * élément 2
306 )))
307 |Liste Hiragana|(((
308 {{{h. élément 1
309 h. élément 2}}}
310 )))|(((
311 {{{(% style="list-style-type: }}}
312
313 hiragana" %)
314 ~* élément 1
315 ~* élément 2
316 )))|(((
317 (% style="list-style-type: hiragana;" %)
318 * élément 1
319 * élément 2
320 )))
321 |Liste Hiragana Iroha|(((
322 {{{H. élément 1
323 H. élément 2}}}
324 )))|(((
325 {{{(% style="list-style-type: }}}
326
327 hiragana-iroha" %)
328 ~* élément 1
329 ~* élément 2
330 )))|(((
331 (% style="list-style-type: hiragana-iroha;" %)
332 * élément 1
333 * élément 2
334 )))
335 |Liste Katakana|(((
336 {{{k. élément 1
337 k. élément 2}}}
338 )))|(((
339 {{{(% style="list-style-type: }}}
340
341 katakana" %)
342 ~* élément 1
343 ~* élément 2
344 )))|(((
345 (% style="list-style-type: katakana;" %)
346 * élément 1
347 * élément 2
348 )))
349 |Liste Katakana Iroha|(((
350 {{{K. élément 1
351 K. élément 2}}}
352 )))|(((
353 {{{(% style="list-style-type:}}}
354
355 katakana-iroha" %)
356 ~* élément 1
357 ~* élément 2
358 )))|(((
359 (% style="list-style-type: katakana-iroha;" %)
360 * élément 1
361 * élément 2
362 )))
363 |Liste Arménienne|(((
364 {{{<ul style="list-style-type: }}}
365
366 armenian">
367 <li>élément 1</li>
368 <li>élément 2</li>
369 </ul>
370 )))|(((
371 {{{(% style="list-style-type: }}}
372
373 armenian" %)
374 ~* élément 1
375 ~* élément 2
376 )))|(((
377 (% style="list-style-type: armenian;" %)
378 * élément 1
379 * élément 2
380 )))
381 |Liste Hébraïque|(((
382 {{{j. élément 1
383 j. élément 2}}}
384 )))|(((
385 {{{(% style="list-style-type: }}}
386
387 hebrew" %)
388 ~* élément 1
389 ~* élément 2
390 )))|(((
391 (% style="list-style-type: hebrew;" %)
392 * élément 1
393 * élément 2
394 )))
395 |Liste Géorgienne|(((
396 {{{<ul style="list-style-type: }}}
397
398 georgian">
399 <li>élément 1</li>
400 <li>élément 2</li>
401 </ul>
402 )))|(((
403 {{{(% style="list-style-type: }}}
404
405 georgian" %)
406 ~* élément 1
407 ~* élément 2
408 )))|(((
409 (% style="list-style-type: georgian;" %)
410 * élément 1
411 * élément 2
412 )))
413 |Liste CJK idéographique|(((
414 {{{<ul style="list-style-type: }}}
415
416 cjk-ideographic">
417 <li>élément 1</li>
418 <li>élément 2</li>
419 </ul>
420 )))|(((
421 {{{(% style="list-style-type: }}}
422
423 cjk-ideographic" %)
424 ~* élément 1
425 ~* élément 2
426 )))|(((
427 (% style="list-style-type: cjk-ideographic;" %)
428 * élément 1
429 * élément 2
430 )))
431
432 = Listes de définitions =
433
434 (% style="width: 99%;" %)
435 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
436 |Définition standard|(((
437 {{{<dl>
438 <dt>terme</dt>
439 <dd>définition</dd>
440 </dl>}}}
441 )))|(((
442 {{{; terme
443 : définition}}}
444 )))|(((
445 ; terme
446 : définition
447 )))
448 |Définitions imbriquées|(((
449 {{{<dl>
450 <dt>terme1</dt>
451 <dd>définition1
452 <dl>
453 <dt>terme2</dt>
454 <dd>définition2</dd>
455 </dl>
456 </dd>
457 </dl>}}}
458 )))|(((
459 {{{; terme1
460 : définition1
461 :; terme2
462 :: définition2}}}
463 )))|(((
464 ; terme1
465 : définition1
466 :; terme2
467 :: définition2
468 )))
469 |Définition paramétrée|(((
470 {{{<dl style="color:blue">
471 <dt>terme</dt>
472 <dd>définition</dd>
473 </dl>}}}
474 )))|(((
475 {{{(% style="color:blue" %)
476 ; terme
477 : définition}}}
478 )))|(((
479 (% style="color: blue;" %)
480 ; terme
481 : définition
482 )))
483
484 = Nouvelle ligne/Sauts de ligne =
485
486 Une nouvelle ligne est un retour chariot. Un saut de ligne est une nouvelle ligne forcée qui peut apparaître n'importe où dans le texte.
487
488 {{info}}
489 En syntaxe XWiki 2.0, les nouvelles lignes sont ignorées, ce qui n'est pas le cas de la syntaxe XWiki 1.0 et Creole.
490 {{/info}}
491
492 (% style="width: 99%;" %)
493 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat de la syntaxe XWiki 1.0|=Résultat de la syntaxe XWiki 2.0
494 |Saut de ligne|{{{Ligne\\Nouvelle ligne}}}|{{{Ligne\\Nouvelle ligne}}}|Ligne
495 Nouvelle ligne|Ligne
496 Nouvelle ligne
497 |Nouvelle ligne|Ligne
498 Nouvelle ligne|Ligne
499 Nouvelle ligne|Ligne Nouvelle ligne|Ligne
500 Nouvelle ligne
501
502 = Liens =
503
504 (% style="width: 99%;" %)
505 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat de la syntaxe XWiki 1.0/2.0
506 |Lien vers une page de l'espace courant|{{{[WebHome]}}}|{{{[[WebHome]]}}}|[[WebHome]]
507 |Lien avec étiquette|{{{[étiquette>WebHome]}}}|{{{[[étiquette>>WebHome]]}}}|[[étiquette>>WebHome]]
508 |Lien vers une page avec l'espace spécifié|{{{[Main.WebHome]}}}|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
509 |Lien vers un sous-wiki|{{{[sous-wiki:Main.WebHome]}}}|{{{[[sous-wiki:Main.
510 WebHome]]}}}|[[xwiki:Main.WebHome]]
511 |Lien qui s'ouvre dans une nouvelle page|{{{[étiquette>WebHome>
512 _blank]}}}|{{{[[étiquette>>WebHome
513 ||rel="__blank"]]}}}|[[étiquette>>WebHome||rel="__blank"]]
514 |Lien vers un URL placé directement dans le texte|{{{Ceci est un URL: http://xwiki.org}}}|{{{Ceci est un URL: http://xwiki.org}}}|Ceci est un URL: http://xwiki.org
515 |Lien vers un URL|{{{[http://xwiki.org]}}}|{{{[[http://xwiki.org]]}}}|[[http://xwiki.org]]
516 |Lien vers un URL avec étiquette|{{{[XWiki>http://xwiki.org]}}}|{{{[[XWiki>>http://xwiki.org]]}}}|[[XWiki>>http://xwiki.org]]
517 |Lien vers une adresse émail|{{{[john@smith.net>
518 mailto:john@smith.net]}}}|{{{[[john@smith.net>>
519 mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
520 |Lien image|{{{<a href="$xwiki.getURL
521 ("Espace1.Page1")">
522 {image:img.png|
523 document=Espace2.Page2}
524 </a>}}}|(((
525 {{{[[image:Espace2.Page2@}}}
526
527 {{{img.png>>Espace1.Page1]]}}}
528 {{info}}La syntaxe Wiki est supportée dans les étiquettes des liens.{{/info}}
529 )))|[[image:PagesSpacesAttachments@img.png]]
530 |Lien vers une pièce jointe à la page courante|(((
531 {{info}}Allez à [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}}
532 {{{{attach:text|file=img.png}}}}
533 )))|{{{[[texte>>attach:img.png]]}}}|[[texte>>attach:img.png]]
534 |Lien vers une pièce jointe à une autre page|(((
535 {{info}}allez à [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}}
536 {{{{attach:text|}}}
537
538 {{{document=Space.Page}}}
539
540 {{{|file=img.png}}}}
541 )))|{{{[[text>>attach:Space.Page
542 @img.png]]}}}|[[text>>attach:XWiki.XWikiSyntax@img.png]]
543
544 == Spécifications des liens pour la syntaxe XWiki 1.0 ==
545
546 La syntaxe complète d'un lien est ##(alias[|&gt;])+(link)(@interWikiAlias)+([|&gt;]target)+##
547
548 * ##alias##: Un String optionnel qui sera affiché à l'utilisateur comme le nom du lien au moment du rendu. Exemple: "Ma page".
549 * ##link##: La référence complète du lien en utilisant la syntaxe suivante: ##(virtualWikiAlias{{{:)}}}+(space.)+(reference)(?queryString)+(#anchor)+##
550 * Notez qu'il faut préciser soit le ##link## , soit l'##alias##.
551 ** ##virtualWikiAlias##: Un String optionnel contenant le nom d'un wiki virtuel. Le lien est vers une page de ce wiki virtuel. Exemple: "mywiki".
552 ** ##space##: Le nom d'un espace Wiki optionnel. Si aucun espace n'est spécifié, alors l'espace courant sera utilisé. Exemple: "Main".
553 ** ##reference##: La référence du lien. Elle peut contenir soit un URI##{{{ protocol:path }}}##(example: {{{"http://xwiki.org"}}}, {{{"mailto:john@smith.com"}}}) ou le nom d'une page wiki (exemple: "WebHome").
554 ** ##queryString##: Un String optionnel de requêtes pour spécifier les paramètres qui seront utilisés dans l'URL rendu. Exemple: {{{"mydata1=5&amp;mydata2=Bonjour"}}}.
555 ** ##anchor##: Le nom d'un ancre optionnel vers un ancre défini dans le lien référencé. Notez qu'en XWiki les ancres sont créés automatiquement pour les titres. Exemple: "AncreDeLaTableDesMatières".
556 * ##interWikiAlias##: Un alias optionnel [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] défini comme dans "InterWiki Map" (pour plus d'informations, allez au [[guide de l'administrateur>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Exemple: "wikipedia".
557 * ##target##: Un String optionnel qui correspond à l'attribut HTML ##target## d'un élément HTML de liaison ##A##. Cet élément est utilisé lors du rendu du lien. Par défaut, le lien est ouvert dans la page courante. Exemples: "_self", "_blank"
558
559 == Spécifications des liens pour la syntaxe XWiki 2.0 ==
560
561 La syntaxe complète\ d'un lien est ##(label>>)?(link)(||parameters)*##
562
563 * ##label##: L'étiquette du lien qui peut contenir de la syntaxe wiki
564 * ##link##: La cible du lien, c'est-à-dire, où aller après cliquer sur un lien. La syntaxe ressemble à la syntaxe XWiki 1.0 et peut contenir 2 types de URI: ##mailto~:## et##{{{attach:}}}##pour des liens vers une adresse émail et vers une pièce jointe.
565 * ##parameters##: Une liste optionnelle de paramètres transmis au lien.
566
567 = Tableaux =
568
569 En syntaxe XWiki 2.0, il est également possible d'avoir des paramètres pour le tableau, la ligne ou la cellule.
570
571 (% style="width: 99%;" %)
572 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
573 |Tableau standard|{{{(((
574 {table}
575 Titre 1 | Titre 2
576 Mot 1 | Mot 2
577 {table}
578 )))}}}|(((
579 {{{|=Titre 1|=Titre 2
580 |Mot 1|Mot 2}}}
581 )))ou(((
582 {{{!=Titre 1!=Titre 2
583 !!Mot 1!!Mot 2}}}
584 )))|(((
585 |=Titre 1|=Titre 2
586 |Mot 1|Mot 2
587 )))
588 |Tableau paramétré|(((
589 <table style="background-color:
590
591 red;align:center">
592 <tbody>
593 <tr>
594 <td>Titre 1</td>
595 <td style="background-color:
596
597 yellow">Titre 2</td>
598 </tr>
599 <tr>
600 <td>Mot 1</td>
601 <td>Mot 2</td>
602 </tr>
603 </tbody>
604 </table>
605 )))|(((
606 {{{(% style="background-color:}}}
607
608 red;align=center" %)
609 ~|=Titre 1|=~(% style="background-color:
610
611 yellow" %)Titre 2
612 ~|Mot 1|Mot 2
613 )))|(((
614 (% style="background-color: red;" %)
615 |=Titre 1|=(% style="background-color: yellow;" %)Titre 2
616 |Mot 1|Mot 2
617 )))
618 |Tableau filtrable et pouvant
619 être trié|(((
620 {{{$xwiki.ssfx.use}}}
621
622 ("js/xwiki/table/table.css")
623 $xwiki.jsfx.use
624
625 ("js/xwiki/table/tablefilterNsort.js", true)
626 <table id="tableid"
627
628 class="grid sortable filterable doOddEven">
629 <tr class="sortHeader">
630 <th>Titre1</th>
631 <th>Titre2</th>
632 </tr>
633 <tr>
634 <td>Cellule11</td>
635 <td>Cellule12</td>
636 </tr>
637 <tr>
638 <td>Cellule21</td>
639 <td>Cellule22</td>
640 </tr>
641 </table>
642 )))|(((
643 {{{{{velocity}}
644 $xwiki.ssfx.use}}}
645
646 {{{("js/xwiki/table/table.css")
647 $xwiki.jsfx.use}}}
648
649 {{{("js/xwiki/table/tablefilterNsort.js", true)
650 {{/velocity}}
651
652 {{html}}
653 <table id="tableid" }}}
654
655 {{{class="grid sortable filterable doOddEven">
656 <tr class="sortHeader">
657 <th>Titre1</th>
658 <th>Titre2</th>
659 </tr>
660 <tr>
661 <td>Cellule11</td>
662 <td>Cellule12</td>
663 </tr>
664 <tr>
665 <td>Cellule21</td>
666 <td>Cellule22</td>
667 </tr>
668 </table>
669 {{/html}}}}}
670 )))|(((
671 {{velocity}}
672 $xwiki.ssfx.use("js/xwiki/table/table.css")
673 $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
674 {{/velocity}}
675
676 {{html}}
677 <table id="tableid" class="grid sortable filterable doOddEven">
678 <tr class="sortHeader">
679 <th>Titre1</th>
680 <th>Titre2</th>
681 </tr>
682 <tr>
683 <td>Cellule11</td>
684 <td>Cellule12</td>
685 </tr>
686 <tr>
687 <td>Cellule21</td>
688 <td>Cellule22</td>
689 </tr>
690 </table>
691 {{/html}}
692 )))
693
694 = Images =
695
696 (% style="width: 99%;" %)
697 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
698 |Image d'une pièce jointe à la page courante|(((
699 {{info}}Allez à [[Image Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/ImageMacro]] pour savoir plus.{{/info}}
700 {{{{image:img.png}}}}
701 )))|{{{image:img.png}}}|[[image:PagesSpacesAttachments@img.png]]
702 |Image d'une pièce jointe à un autre document|{{{{image:img.png|
703 document=Space.Page}}}}|{{{image:Space.Page
704 @img.png}}}|[[image:PagesSpacesAttachments@img.png]]
705 |Image avec des paramètres|{{{{image:img.png
706 |width=25|height=25}}}}|{{{[[image:img.png||
707 width="25" height="25"]]}}}|[[image:PagesSpacesAttachments@img.png||height="25" width="25"]]
708 |Images localisées dans un URL|{{{http://some/url/img.png}}}|{{{image:http://some/url/img.png}}}|[[image:PagesSpacesAttachments@img.png]]
709
710 = Verbatim =
711
712 Vous permet d'avoir un contenu qui ne sera pas formaté . En d'autres termes, la syntaxe wiki ne sera pas prise en compte.
713
714 {{info}}
715 En syntaxe XWiki 1.0 la [[macro Pre>>http://code.xwiki.org/xwiki/bin/view/Macros/PreMacro]] préserve seulement la syntaxe wiki et les macros Radeox. Cependant, les fragments HTML et les scripts Groovy/Velocity sont toujours exécutés.
716 {{/info}}
717
718 (% style="width: 99%;" %)
719 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat de la syntaxe XWiki 1.0|=Résultat de la syntaxe XWiki 2.0
720 |Verbatim en-ligne|{{{Du contenu verbatim {pre}*[non rendu]*{/pre}}}}|{{{Du contenu verbatim
721 {{{**[[non rendu]]**}}}}}}|Du contenu verbatim {{{*[non rendu]*}}}|Du contenu verbatim {{{**[[non rendu]]**}}}
722 |Le bloc Verbatim|(((
723 {{{
724 {pre}
725 Du contenu
726 *verbatim*
727 sur plusieurs lignes
728 {/pre}
729 }}}
730 {{info}}Il est aussi possible d'utiliser la [[macro Code>>http://code.xwiki.org/xwiki/bin/view/Macros/CodeMacro]] mais celle-ci affiche son contenu dans une boîte par défaut..{{/info}}
731 )))|(((
732 {{{{{{
733 Du contenu
734 **verbatim**
735 sur plusieurs lignes
736 }}}}}}
737 )))|(((
738 {{{Du contenu
739 *verbatim*
740 sur plusieurs lignes}}}
741 )))|(((
742 {{{Du contenu
743 **verbatim**
744 sur plusieurs lignes}}}
745 )))
746
747 = Citations =
748
749 (% style="width: 99%;" %)
750 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
751 |Citation simple|(((
752 <blockquote><p>
753
754 John a dit cela.
755
756 </p></blockquote>
757 J'ai dit ok.
758 )))|(((
759 {{{> John a dit cela.
760 J'ai dit ok.}}}
761 )))|(((
762 > John a dit cela.
763
764 J'ai dit ok.
765 )))
766 |Citations imbriquées|(((
767 <blockquote><p>
768
769 John a dit cela.</p>
770 <blockquote><p>
771
772 Marie a répondu cela.
773
774 </p></blockquote>
775 </blockquote>
776 J'ai dit ok.
777 )))|(((
778 {{{> John a dit cela.
779 >> Marie a répondu cela.
780 J'ai dit ok.}}}
781 )))|(((
782 > John a dit cela.
783 >> Marie a répondu cela.
784
785 (((
786
787 )))
788
789 (((
790
791 )))
792
793 (((
794
795 )))
796
797 (((
798
799 )))
800
801 (((
802
803 )))
804
805
806
807
808
809
810
811
812
813 J'ai dit ok.
814 )))
815
816 = Groupes =
817
818 Les groupes peuvent être utilisés pour insérer un autre document directement dans le document courant. Cela permet par exemple d'insérer des éléments complexes à l'intérieur d'un élément d'une liste ou dans une cellule de tableau. Les groupes sont délimités par les éléments syntaxiques suivants:##{{{(((...)))}}}##. Un groupe peut contenir un autre groupe et il n'y a pas de limite d'imbrication.
819
820
821 (% style="width: 99%;" %)
822 |=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
823 |{{info}}Cette fonctionnalité n'existe pas en syntaxe XWiki 1.0. Il faudrait utiliser du HTML pur pour atteindre le résultat.{{/info}}|(((
824 {{{|=Titre 1|=Titre 2|=Titre 3
825 |Cellule 1|(((
826 = Document ancré
827
828 Un paragraphe ancré.
829
830 * élément de liste 1
831 * élément de liste 2
832 ** sous-élément 1
833 ** sous-élément 2
834 ))) | Cellule 3
835
836 Le paragraphe suivant dans le document de haut niveau}}}
837 )))|(((
838 |=Titre 1|=Titre 2|=Titre 3
839 |Cellule 1|(((
840 {{html}}
841 <h1 id="HEmbeddeddocument"><span>Document ancré</span></h1>
842 {{/html}}
843
844 Un paragraphe ancré.
845
846 * élément de liste 1
847 * élément de liste 2
848 ** sous-élément 1
849 ** sous-élément 2
850 )))| Cellule 3
851
852 Le paragraphe suivant dans le document de haut niveau
853 )))
854
855 = Protéger les caractères =
856
857 (% style="width: 99%;" %)
858 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat de la syntaxe XWiki 1.0|=Résultat de la syntaxe XWiki 2.0
859 |Pour un caractère|{{{Ceci n'est pas un \[lien\]}}}|(((
860 {{{Ceci n'est pas un ~[~[lien~]~]}}}
861 {{info}}Pour renseigner le caractère ~~ utilisez l'Escape double: ~~~~{{/info}}
862 )))|{{{Ceci n'est pas un [lien]}}}|{{{Ceci n'est pas un [[lien]]}}}
863
864 = Macros =
865
866 En syntaxe XWiki 1.0, il y a deux types de macros:
867
868 * Les macros Velocity appelées en utilisant la syntaxe ###macroname(param1 ... paramN)##
869 * Les macros Radeox appelées en utilisant la syntaxe ##{macroname:param1=value1|...|paramN=valueN}##
870
871 En syntaxe XWiki 2.0, il y a aussi deux types de macros:
872
873 * Les macros Velocity appelées en utilisant la syntaxe ###macroname(param1 ... paramN)## dans la Macro Velocity
874 * Les macros XWiki appelées en utilisant la syntaxe##{{{{{macroname param1="value1" ... paramN="valueN"}}}}}##
875
876 {{info}}
877 Les macros Radeox ne peuvent pas être utilisées en syntaxe XWiki 2.0. C'est la raison pour laquelle elles ont été ré-écrites comme des macros XWiki.
878 {{/info}}
879
880 {{info}}
881 Pour accéder à la liste de toutes les macros disponibles, allez à la [[page de référence des macros>>LesMacrosXWiki]].
882 {{/info}}
883
884 (% style="width: 99%;" %)
885 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0
886 |Macro Velocity|(((
887 {{{#info("Un fragment de texte")}}}
888 )))|(((
889 {{{
890 {{velocity}}{{html}}
891 #info("Un fragment de texte")
892 {{/html}}{{/velocity}}}}}
893 {{info}}Dans cet exemple, nous utilisons la macro HTML étant donné que la macro ###Message d'Information## renvoie du contenu HTML.{{/info}}
894 )))
895 |Macros Radeox/XWiki|(((
896 {{{{code:java}
897 Du contenu Java
898 {code}}}}
899 )))|(((
900 {{{{{code language="java"}}
901 Du contenu Java
902 {{/code}}}}}
903 )))
904
905 = HTML =
906
907 {{info}}
908 En syntaxe XWiki 2.0, le code HTML ou XHTML doit être écrit en utilisant la macro {~{~html~}~} alors qu'en syntaxe XWiki 1.0 il est possible d'utiliser du code HTML directement dans le texte.
909 {{/info}}
910
911 (% style="width: 99%;" %)
912 |=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=Résultat
913 |<b>gras</b>|{{{{{html}}<b>gras</b>{{/html}}}}}|{{html}}<b>gras</b>{{/html}}
914
915 {{info}}
916 En syntaxe XWiki 2.0, par défaut, la macro {~{~html~}~} ne peut pas analyser la syntaxe wiki. Pour l'activer, utilisez {{{{{html wiki="true"}}}}}.
917 {{/info}}
918
919 = Scripts Velocity/Groovy =
920
921 {{info}}
922 En syntaxe XWiki 1.0, il était possible d'inclure des scripts Velocity directement dans la page. Cela a créé quelques problèmes, par exemple, les cas où l'utilisateur avait inclus involontairement du contenu Velocity. Cela affectait aussi la performance des pages qui ne nécessitaient pas de contenu Velocity. Il y avait eu d'autres limitations techniques. Ainsi, en syntaxe XWiki 2.0, les scripts Velocity doivent être inclus en utilisant la macro ##velocity##. En va de même pour l'inclusion des scripts Groovy.
923 {{/info}}
924
925 (% style="width: 99%;" %)
926 |=Fonctionnalité|=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0
927 |Script Velocity|(((
928 {{{#set ($var = "quelquechose")}}}
929 )))|(((
930 {{{{{velocity}}
931 #set ($var = "quelquechose")
932 {{/velocity}}}}}
933 )))
934 |Script Groovy|(((
935 {{{<%
936 def var = "quelquechose"
937 %>}}}
938 )))|(((
939 {{{{{groovy}}
940 def var = "quelquechose"
941 {{/groovy}}}}}
942 )))
943
944 = Paramètres =
945
946 En syntaxe XWiki 2.0, il est possible de passer des paramètres aux divers éléments de syntaxe et aussi aux blocs de texte. Vous pouvez utiliser ces paramètres par exemple pour créer des styl. Il est possible de choisir n'importe quelle paire clé/valeur. Le moteur de rendu XHTML va passer ces paramètres en tant que XHTML attributs à la représentation XHTML sous-jacente des éléments de syntaxe. En syntaxe XWiki 1.0, il n'y avait pas de possibilité de passer des paramètres et la seule façon de le faire était d'écrire du XHTML directement dans le contenu comme vous le voyez dans le tableau ci-dessous.
947
948
949 (% style="width: 99%;" %)
950 |=Syntaxe XWiki 1.0|=Syntaxe XWiki 2.0|=XHTML généré
951 |(((
952 {{{<h1 class="myClass" }}}
953
954 style="myStyle" id="myId">
955
956 heading</h1>
957 )))|(((
958 {{{(% class="myClass" }}}
959
960 style="myStyle" id="myId" %)
961 ~= titre =
962 )))|(((
963 {{{<h1 class="myClass" }}}
964
965 style="myStyle" id="myId">titre</h1>
966 )))
967
968 {{id name="syntaxes"/}}
969
970 = La syntaxe 2.1 =
971
972 La syntaxe XWiki 2.1 est maintenant définitive ce qui signifie qu'on n'y apportera aucune autre modification. En outre, lorsque vous créerez une page, la syntaxe par défaut sera 2.1. Vous pouvez encore en choisir une autre, comme expliqué [[ici>>ModesEdition]].
973
974 == Les liens en syntaxe XWiki 2.1 ==
975
976 Le format complet d'un lien est **##[label>>] (ressource) [||paramètres]##**
977
978 * **##label##**: Un string optionnel qui sera affiché comme le nom du lien. L’étiquette peut contenir également de la syntaxe Wiki et si aucune n'est spécifiée, une étiquette par défaut sera générée.
979 * **##ressource##**: Un string obligatoire contenant la référence au lien qui peut être:
980 ** **URL**: Un URL ayant la forme **##[url:] (protocole:~/~/chemin d'accès)##**. Exemples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/##
981 *** **##url:##** Un string optionnel qui identifie la ressource comme étant un URL
982 ** Référence **à une page Wiki** ayant la forme **##[doc:] ~[~[nomDuWiki:] espace.] (page)##**. Exemples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
983 *** **##doc:##** Un string optionnel qui identifie la ressource comme étant un document XWiki.
984 *** **##nomDuWiki##**: Un string optionnel contenant le nom d'un wiki virtuel. Le lien sera vers une page de ce wiki virtuel. Exemple: ##mywiki##
985 *** **##espace##**: Un string optionnel contenant le nom d'un espace wiki. Au cas où vous n'en spécifierez aucun, l'espace courant sera utilisé. Exemple: ##Main##.
986 *** **##page##**: Un string obligatoire contenant le nom de la page wiki vers laquelle vous souhaitez créer le lien. Exemple: ##WebHome##
987 ** Référence à **une page InterWiki** ayant la forme **##interwiki: {{{(interWikiAlias:)}}}(page)##**. Exemple: ##interwiki:wikipedia:XWiki##
988 *** **##interwiki:##** Un string obligatoire qui identifie la ressource comme étant un lien InterWiki.
989 *** **##interWikiAlias##**: Un alias [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] optionnel définit dans le [[Guide de l'Administrateur>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Exemple: ##wikipedia##
990 *** **##page##**: Un string obligatoire contenant le nom de la page vers laquelle vous souhaitez créer le lien. Exemple: ##XWiki##
991 ** Référence à une **Pièce jointe** ayant la forme **##attach~: [nomPageWiki@] (nomPièceJointe)##**. Exemples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##
992 *** **##attach~:##**: Un string obligatoire qui identifie la ressource comme étant une pièce jointe.
993 *** **##nomPageWiki##**: Un string optionnel qui référence le document contenant le pièce jointe.
994 *** **##nomPièceJointe##**: Le nom de la pièce jointe, tel qu'il est stocké dans le wiki.
995 ** **Adresse de mail** ayant la forme **##mailto~: (adresseEmail)##** (###anchor## n'est pas valide). Exemple: ##mailto~:john@smith.com##
996 *** **##mailto~:##**: Un string obligatoire qui identifie la ressource comme étant un e-mail.
997 *** **##adresseEmail##**: L'adresse e-mail cible. Exemple: ##john@smith.com##
998 ** Référence à un **chemin relatif** sur le serveur ayant la forme **##path: (cheminRelatif)##**. Exemple: ##path:$doc.getURL('reset')## va donner l'adresse cible ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## où ##/xwiki/bin/reset/Space/Page## est généré par ##$doc.getURL('reset')##.
999 *** **##path:##** Un string obligatoire qui identifie la ressource comme étant un chemin relatif.
1000 *** **##cheminRelatif##**: Un string obligatoire contenant le chemin relatif de la ressource vers laquelle vous souhaitez créer le lien.
1001 ** Référence **UNC (Windows Explorer)** ayant la forme **##unc: (chemin)##**. Le lien est rendu tout comme un lien ##file:~/~/##. Exemples: ##unc:C:\Windows\##, ##unc:~\~\myserver\chemin\img.png##, ##unc:home/user/somefile##
1002 *** **##unc:##** Un string obligatoire qui identifie la ressource comme étant un chemin UNC (Windows Explorer).
1003 *** **##chemin##**: Un string contenant le chemin local d'une ressource accessible à l'utilisateur. Exemples: ##C:\Windows\##, ##~\~\myserver\path\img.png##, ##home/user/monfichier##
1004 * **##paramètres##**: Une liste optionnelle de paramètres séparés par des espaces qui seront transmis au lien. Exemple: ##queryString="mydata1=5&amp;mydata2=Hello" anchor="HTableOfContents" rel="~_~_blank"##
1005 ** **##queryString##**: Un string d'interrogation optionnel pour spécifier les paramètres qui seront ajoutés à l'adresse cible du lien et utilisés par le URL rendu. Exemple: ##url:http:~/~/domain.com/path||queryString="mydata1=5&amp;mydata2=Hello"## génère l'adresse cible ##http:~/~/domain.com/path?mydata1=5&amp;mydata2=Hello##
1006 ** **##anchor##**: Le nom optionnel d'une ancre qui dirige vers l'ancre définit dans le lien référencé. Notez que dans XWiki les ancres sont générées automatiquement pour les titres. Exemple: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## génère l'adresse cible ##http:~/~/domain.com/path#HTableOfContents##
1007 ** **##rel##**: Un paramètre optionnel qui vous permet d'ouvrir le lien cible dans une nouvelle fenêtre. Exemple: ##rel="~_~_blank"##
1008
1009 == Les images en syntaxe 2.1 ==
1010
1011 Le format complet d'une image est soit **##image~: (référence)##** ou **##~[~[image~: (référence) {||paramètres}]]##**.
1012
1013 * **##image~:##** Un string obligatoire qui identifie la ressource comme étant une image.
1014 * **##référence##**: La référence à l'image qui devrait être affichée dans l'une des formes suivantes:
1015 ** **URL**: Tout lien vers une image ayant la forme **##protocole:~/~/chemin/nomImage##**. Exemple: ##http:~/~/domain.org/path/img.png##
1016 ** Une référence à une **Pièce jointe** ayant la forme **##~{~{~{nomwiki:} espace.} page@} (nomImage)##**
1017 *** **##nomWiki##**: Un string optionnel contenant le nom du wiki virtuel. La rérérence va diriger vers l'image attachée à la page de ce wiki virtuel. Exemple: mywiki.
1018 *** **##espace##**: Le nom de l'espace (optionnel). Au cas où aucun espace ne serait spécifié, l'espace courant va être utilisé. Exemple: Main
1019 *** **##page##**: Un string optionnel contenant le nom de la page wiki qui contient l'image référencée. Exemple: WebHome
1020 *** **##nomImage##**: Un string obligatoire contenant le nom d'une image attachée à une page tel qu'il est stocké dans le wiki.
1021 ** Référence à une(% style="font-family: Arial; font-size: 14px" id="ID0E6B" %)**Icône **(%%)ayant la forme**##{{{(icon:)}}}(nomIcone)##**. Exemple: **##icon:accept##**
1022 *** **##icon:##** Un string obligatoire qui identifie la référence à l'image comme étant une(% style="font-family: Arial; font-size: 14px" id="ID0E6B" %)** icône**(% style="font-family: Arial; font-size: 14px" %)** **(%%)de [[XWiki>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]].
1023 *** **##nomIcone##**: Un string obligatoire qui identifie l'(% style="font-family: Arial; font-size: 14px" id="ID0E6B" %)**icône**(%%) référencée. Exemple: ##accept##
1024 * **##parameters##**: Une liste optionnelle de paramètres séparés par des espaces qui sont transmis à l'image. Exemple: ##width="800" height="600" alt="img.png" title="My nice image"##
1025 ** **Des attributs HTML**: Tous les attributs définis par le standard HTML seront ajoutés au tag ##<img>## rendu.
1026 *** **##style##**: le code CSS qui devrait être appliqué. Exemples: ##style="float:right;height:50"##, ##style="style="display:block;margin-left:auto;margin-right:auto;width:80%"##, ##style="vertical-align:bottom"##
1027 *** **##height##**: Un paramètre qui définit la hauteur de l'image affichée. La valeur devrait être soit en pixels (exemple: ##height="80"##) ou en pixels relativement au bloc qui contient l'image (exemple: ##height="40%"##).
1028 *** **##width##**: Un paramètre qui définit la largeur de l'image affichée. La valeur devrait être soit en pixels (exemple: ##width="80"##) soit en pixels relativement à la largeur du bloc contenant l'image (exemple: ##width="40%"##).
1029 *** **##title##**: Un paramètre qui définit le titre de l'image affichée qui serait visible lorsque vous survolez l'image. Exemple: ##title="My nice image".##
1030 *** **##alt##**: Un paramètre qui définit le texte à afficher au cas où le navigateur ne pourrait pas afficher l'image. Etant donné que ceci est un attribut HTML obligatoire, XWiki utilisera le nom du fichier au cas où le paramètre ##alt## ne serait pas définit. Exemple: ##alt="img.png".##
1031 *** **Pour en savoir plus**: Des explications plus détaillées sur le tag ##<img>## et sur d'autres attributs sont disponibles sur [[on w3.org>>http://www.w3.org/TR/html4/struct/objects.html#h-13.2]].
1032 ** **##queryString##**: Permet la transmission des interrogations au serveur lors de la création du lien de téléchargement pour l'image référencée. Exemple: ##queryString="width=100&amp;height=800&amp;keepAspectRatio=true"## (**##keepAspectRatio=true## **ne va pas fonctionner si les paramètres** ##width## **et** ##height## **sont spécifiés à part de** ##queryString##!**)
1033
1034 = D'autres syntaxes =
1035
1036 Les syntaxes suivantes sont mises en œuvre dans XWiki Enterprise 1.6 et dans les version ultérieures:
1037
1038 * [[JSPWiki>>http://www.jspwiki.org/wiki/TextFormattingRules]]
1039 * [[MediaWiki>>http://en.wikipedia.org/wiki/Help:Editing]]
1040 * [[Confluence>>http://confluence.atlassian.com/display/CONF20/Confluence+Notation+Guide+Overview]]
1041 * [[TWiki>>http://twiki.org/cgi-bin/view/TWiki/WikiSyntax]]
1042 * [[Creole 1.0>>http://www.wikicreole.org/wiki/Creole1.0]]
1043 * [[XHTML 1.0>>http://www.w3.org/TR/xhtml1/]]
This wiki is licensed under a Creative Commons 2.0 license
XWiki 13.10 - Documentation - Conditions