Guide de syntaxe XWiki

Modifié par superadmin le 2022/06/05 23:31

Syntaxe XWiki 2.1 » Général

Syntaxe XWiki 2.1: Général

Introduction

2.1 Introduction

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:

  • 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.
  • 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.

 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. 

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 et 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

Remarques générales

2.0 General Remarks

La syntaxe XWiki v2.1 corrige quelques erreurs et le problème de la syntaxe ambiguë comme indiqué dans les exemples du tableau ci-dessous:

DescriptionExemple de syntaxe invalide ou ambiguëCorrigé dans la syntaxe XWiki 2.1
Des styles de texte non fermés**gras**gras**
Deux éléments autonomes non séparés par 2 nouvelles lignes| cellule de tableau
* élément de liste
| cellule de tableau

* élément de liste
Deux éléments autonomes non séparés par 2 nouvelles lignesparagraphe
----
paragraphe
paragraphe

----

paragraphe
Nouvelle ligne ignorée au début du document<nouvelle ligne au début du document>
paragraphe
paragraphe
La syntaxe avec des titres non fermés=== titre=== titre ===

D'autres syntaxes

1.0 Other Syntaxes

Les syntaxes suivantes sont mises en œuvre dans XWiki Enterprise 1.6 et dans les version ultérieures: