XWikiSyntaxLinks

Modifié par superadmin le 2026/01/29 15:29

Editing

Liens

1.0 Links

Fonctionnalité	Syntaxe XWiki 1.0	Résultat
Lien vers une page de l'espace courant	[WebHome]	Web Home
Lien avec étiquette	[étiquette>WebHome]	étiquette
Lien vers une page avec l'espace spécifié	[Main.WebHome]	Web Home
Lien vers un sous-wiki	[sous-wiki:Main.WebHome]	Web Home
Lien qui s'ouvre dans une nouvelle page	[étiquette>WebHome>_blank]	étiquette
Lien vers un URL placé directement dans le texte	Ceci est un URL: http://xwiki.org	Ceci est un URL: http://xwiki.org
Lien vers un URL	[http://xwiki.org]	http://xwiki.org
Lien vers un URL avec étiquette	[XWiki>http://xwiki.org]	XWiki
Lien vers une adresse email	[john@smith.net>mailto:john@smith.net]	john@smith.net
Lien image	<a href="$xwiki.getURL("Espace1.Page1")">{image:img.png\|document=Espace2.Page2}</a>
Lien vers une pièce jointe à la page courante	InformationVoir Attacher une Macro pour savoir plus. {attach:text\|file=img.png}	texte
Lien vers une pièce jointe à une autre page	InformationVoir Attacher une Macro pour savoir plus. {attach:texte\|document=Space.Page\|file=img.png}	text
Lien vers une ancre dans une page	[label>Space.Page#ancre]	label
Lien vers un titre dans une page	[label>Space.Page#HMontitre]	label

Quand vous ajoutez un titre, une ancre nommée "H" suivie du titre avec uniquement les lettres est créé. Par exemple, pour le titre "Mon titre", l'ancre générée sera "HMontitre".

$subHeading Spécifications des liens pour la syntaxe XWiki 1.0 $subHeading

La syntaxe complète d'un lien est (alias[|>])+(link)(@interWikiAlias)+([|gt;]target)+

alias: Un String optionnel qui sera affiché à l'utilisateur comme le nom du lien au moment du rendu. Exemple: "Ma page".
link: La référence complète du lien en utilisant la syntaxe suivante: (virtualWikiAlias:)+(space.)+(reference)(?queryString)+(#anchor)+
Notez qu'il faut préciser soit le link , soit l'alias.
- virtualWikiAlias: Un String optionnel contenant le nom d'un wiki virtuel. Le lien est vers une page de ce wiki virtuel. Exemple: "mywiki".
- space: Le nom d'un espace Wiki optionnel. Si aucun espace n'est spécifié, alors l'espace courant sera utilisé. Exemple: "Main".
- 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").
- queryString: Un String optionnel de requêtes pour spécifier les paramètres qui seront utilisés dans l'URL rendu. Exemple: "mydata1=5&mydata2=Bonjour".
- 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".
interWikiAlias: Un alias optionnel Inter Wiki défini comme dans "InterWiki Map" (pour plus d'informations, allez au guide de l'administrateur). Exemple: "wikipedia".
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"

2.0 Links

Fonctionnalité	Syntaxe XWiki 2.0	Résultat
Lien vers une page de l'espace courant	[[WebHome]]	XWiki
Lien avec étiquette	[[étiquette>>WebHome]]	étiquette
Lien vers une page avec l'espace spécifié	[[Main.WebHome]]	Main
Lien vers un sous-wiki	[[sous-wiki:Main.WebHome]]	Main
Lien qui s'ouvre dans une nouvelle page	[[étiquette>>WebHome\|\|rel="__blank"]]	étiquette
Lien vers un URL placé directement dans le texte	Ceci est un URL: http://xwiki.org	Ceci est un URL: http://xwiki.org
Lien vers un URL	[[http://xwiki.org]]	http://xwiki.org
Lien vers un URL avec étiquette	[[XWiki>>http://xwiki.org]]	XWiki
Lien vers une adresse email	[[john@smith.net>>mailto:john@smith.net]]	john@smith.net
Lien image	[[image:Espace2.Page2@img.png>>Espace1.Page1]] InformationLa syntaxe Wiki est supportée dans les étiquettes des liens.
Lien vers une pièce jointe à la page courante	[[texte>>attach:img.png]]	texte
Lien vers une pièce jointe à une autre page	[[text>>attach:Space.Page@img.png]]	text
Lien vers une ancre dans une page	[[label>>Space.Page#ancre]]	label
Lien vers un titre dans une page	[[label>>Space.Page#HMontitre]]	label

Quand vous ajoutez un Titre, une ancre nommée "H" suivie du titre avec uniquement les lettres est créé. Par exemple, pour le Titre "Mon titre", l'ancre générée sera "HMontitre".

$subHeading Spécifications des liens pour la syntaxe XWiki 2.0 $subHeading

La syntaxe complèted'un lien est (label>>)?(link)(||parameters)*

label: L'étiquette du lien qui peut contenir de la syntaxe wiki
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: etattach:pour des liens vers une adresse email et vers une pièce jointe.
parameters: Une liste optionnelle de paramètres transmis au lien.

2.1 Links

Fonctionnalité	Syntaxe XWiki 2.1	Résultat
Lien vers une page de l'espace courant	[[WebHome]]	XWiki
Lien avec étiquette	[[étiquette>>WebHome]]	étiquette
Lien vers une page avec l'espace spécifié	[[Main.WebHome]]	Main
Lien vers un sous-wiki	[[sous-wiki:Main.WebHome]]	Main
Lien qui s'ouvre dans une nouvelle page	[[étiquette>>WebHome\|\|rel="__blank"]]	étiquette
Lien vers un URL placé directement dans le texte	Ceci est un URL: http://xwiki.org	Ceci est un URL: http://xwiki.org
Lien vers un URL	[[http://xwiki.org]]	http://xwiki.org
Lien vers un URL avec étiquette	[[XWiki>>http://xwiki.org]]	XWiki
Lien vers une adresse email	[[john@smith.net>>mailto:john@smith.net]]	john@smith.net
Lien image	[[image:Espace2.Page2@img.png>>Espace1.Page1]] InformationLa syntaxe Wiki est supportée dans les étiquettes des liens.
Lien image avec paramètres image	[[[[image:Space2.Page2@img.png\|\|width="26" height="26"]]>>Space1.Page1]]
Lien vers une pièce jointe à la page courante	[[texte>>attach:img.png]]	texte
Lien vers une pièce jointe à une autre page	[[texte>>attach:Space.Page@img.png]]	texte
Lien vers une ancre dans une page	[[label>>Space.Page\|\|ancre=ancre]]	label
Lien vers un titre dans une page	[[label>>XWiki.XWikiSyntax\|\|anchor=HMontitre]]	label

Quand vous ajoutez un Titre, une ancre nommée "H" suivie du titre avec uniquement les lettres est créé. Par exemple, pour le Titre "Mon titre", l'ancre générée sera "HMontitre".

$subHeading Spécifications des liens pour la syntaxe XWiki 2.1 $subHeading

La syntaxe complète d'un lien est (label>>)?(link)(||parameters)*

label: L'étiquette du lien qui peut contenir de la syntaxe wiki
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: etattach:pour des liens vers une adresse email et vers une pièce jointe.
parameters: Une liste optionnelle de paramètres transmis au lien.
- queryString: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: url:http://domain.com/path||queryString="mydata1=5&mydata2=Hello" produces target address http://domain.com/path?mydata1=5&mydata2=Hello
- anchor: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: url:http://domain.com/path||anchor="HTableOfContents" produces target address http://domain.com/path#HTableOfContents
- rel: An optional parameter that allows to open link target in new window. Example: rel="__blank"