XWikiSyntaxLinks

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

Editing

Liens

FonctionnalitéSyntaxe XWiki 1.0Ré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 texteCeci est un URL: https://xwiki.orgCeci est un URL: https://xwiki.org
Lien vers un URL[https://xwiki.org]https://xwiki.org
Lien vers un URL avec étiquette[XWiki>https://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>img.png
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
Information

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

Erreur dans lexécution de la macro [velocity]. Cause : [The execution of the [velocity] script macro is not allowed in [portail:XWiki.XWikiSyntaxLinks]. Check the rights of its last author or the parameters if it's rendered from another script.]. Cliquer sur ce message pour voir plus de détails.

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: "https://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"
FonctionnalitéSyntaxe XWiki 2.0Ré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 texteCeci est un URL: https://xwiki.orgCeci est un URL: https://xwiki.org
Lien vers un URL[[https://xwiki.org]]https://xwiki.org
Lien vers un URL avec étiquette[[XWiki>>https://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.

img.png
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
Information

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

Erreur dans lexécution de la macro [velocity]. Cause : [The execution of the [velocity] script macro is not allowed in [portail:XWiki.XWikiSyntaxLinks]. Check the rights of its last author or the parameters if it's rendered from another script.]. Cliquer sur ce message pour voir plus de détails.

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.
FonctionnalitéSyntaxe XWiki 2.1Ré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 texteCeci est un URL: https://xwiki.orgCeci est un URL: https://xwiki.org
Lien vers un URL[[https://xwiki.org]]https://xwiki.org
Lien vers un URL avec étiquette[[XWiki>>https://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.

img.png
Lien image avec paramètres image[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]img.png
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
Information

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

Erreur dans lexécution de la macro [velocity]. Cause : [The execution of the [velocity] script macro is not allowed in [portail:XWiki.XWikiSyntaxLinks]. Check the rights of its last author or the parameters if it's rendered from another script.]. Cliquer sur ce message pour voir plus de détails.

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"