Code source wiki de XWikiSyntaxLinks
Modifié par superadmin le 2026/01/29 15:29
Masquer les derniers auteurs
| author | version | line-number | content |
|---|---|---|---|
| |
1.1 | 1 | = Editing = |
| 2 | |||
| |
2.1 | 3 | == Liens == |
| |
1.1 | 4 | |
| |
2.1 | 5 | {{comment}}please do not translate the sub headlines{{/comment}} |
| |
1.1 | 6 | === 1.0 Links === |
| 7 | |||
| |
2.1 | 8 | |=(% style="width:20%" %)Fonctionnalité|=Syntaxe XWiki 1.0|=(% style="width:20%" %)Résultat |
| 9 | |Lien vers une page de l'espace courant|{{{[WebHome]}}}|[[Web Home>>WebHome]] | ||
| 10 | |Lien avec étiquette|{{{[étiquette>WebHome]}}}|[[étiquette>>WebHome]] | ||
| 11 | |Lien vers une page avec l'espace spécifié|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] | ||
| 12 | |Lien vers un sous-wiki|{{{[sous-wiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] | ||
| 13 | |Lien qui s'ouvre dans une nouvelle page|{{{[étiquette>WebHome>_blank]}}}|[[étiquette>>WebHome||rel="__blank"]] | ||
| 14 | |Lien vers un URL placé directement dans le texte|{{{Ceci est un URL: http://xwiki.org}}}|Ceci est un URL: http://xwiki.org | ||
| 15 | |Lien vers un URL|{{{[http://xwiki.org]}}}|[[http://xwiki.org]] | ||
| 16 | |Lien vers un URL avec étiquette|{{{[XWiki>http://xwiki.org]}}}|[[XWiki>>http://xwiki.org]] | ||
| 17 | |Lien vers une adresse email|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] | ||
| 18 | |Lien image|{{{<a href="$xwiki.getURL("Espace1.Page1")">{image:img.png|document=Espace2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] | ||
| 19 | |Lien vers une pièce jointe à la page courante|((( | ||
| 20 | {{info}}Voir [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}} | ||
| |
1.1 | 21 | {{{{attach:text|file=img.png}}}} |
| |
2.1 | 22 | )))|[[texte>>attach:XWiki.XWikiSyntaxLinks@img.png]] |
| 23 | |Lien vers une pièce jointe à une autre page|((( | ||
| 24 | {{info}}Voir [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}} | ||
| 25 | {{{{attach:texte|document=Space.Page|file=img.png}}}} | ||
| |
1.1 | 26 | )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |
| |
2.1 | 27 | |Lien vers une ancre dans une page|{{{[label>Space.Page#ancre]}}}|[[label>>XWiki.XWikiSyntax||ancre=ancre]] |
| 28 | |Lien vers un titre dans une page|{{{[label>Space.Page#HMontitre]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] | ||
| |
1.1 | 29 | |
| |
2.1 | 30 | {{info}}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".{{/info}} |
| |
1.1 | 31 | |
| |
2.1 | 32 | {{velocity}} |
| 33 | $subHeading Spécifications des liens pour la syntaxe XWiki 1.0 $subHeading | ||
| 34 | {{/velocity}} | ||
| |
1.1 | 35 | |
| |
2.1 | 36 | La syntaxe complète d'un lien est ##(alias[|>])+(link)(@interWikiAlias)+([|gt;]target)+## |
| |
1.1 | 37 | |
| |
2.1 | 38 | * ##alias##: Un String optionnel qui sera affiché à l'utilisateur comme le nom du lien au moment du rendu. Exemple: "Ma page". |
| 39 | * ##link##: La référence complète du lien en utilisant la syntaxe suivante: ##(virtualWikiAlias{{{:)}}}+(space.)+(reference)(?queryString)+(#anchor)+## | ||
| 40 | * Notez qu'il faut préciser soit le ##link## , soit l'##alias##. | ||
| 41 | ** ##virtualWikiAlias##: Un String optionnel contenant le nom d'un wiki virtuel. Le lien est vers une page de ce wiki virtuel. Exemple: "mywiki". | ||
| 42 | ** ##space##: Le nom d'un espace Wiki optionnel. Si aucun espace n'est spécifié, alors l'espace courant sera utilisé. Exemple: "Main". | ||
| 43 | ** ##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"). | ||
| 44 | ** ##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"}}}. | ||
| 45 | ** ##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". | ||
| 46 | * ##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". | ||
| 47 | * ##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" | ||
| |
1.1 | 48 | |
| 49 | === 2.0 Links === | ||
| 50 | |||
| |
2.1 | 51 | |=(% style="width:20%" %)Fonctionnalité|=Syntaxe XWiki 2.0|=(% style="width:20%" %)Résultat |
| 52 | |Lien vers une page de l'espace courant|{{{[[WebHome]]}}}|[[WebHome]] | ||
| 53 | |Lien avec étiquette|{{{[[étiquette>>WebHome]]}}}|[[étiquette>>WebHome]] | ||
| 54 | |Lien vers une page avec l'espace spécifié|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] | ||
| 55 | |Lien vers un sous-wiki|{{{[[sous-wiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] | ||
| 56 | |Lien qui s'ouvre dans une nouvelle page|{{{[[étiquette>>WebHome||rel="__blank"]]}}}|[[étiquette>>WebHome||rel="__blank"]] | ||
| 57 | |Lien vers un URL placé directement dans le texte|{{{Ceci est un URL: http://xwiki.org}}}|Ceci est un URL: http://xwiki.org | ||
| 58 | |Lien vers un URL|{{{[[http://xwiki.org]]}}}|[[http://xwiki.org]] | ||
| 59 | |Lien vers un URL avec étiquette|{{{[[XWiki>>http://xwiki.org]]}}}|[[XWiki>>http://xwiki.org]] | ||
| 60 | |Lien vers une adresse email|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] | ||
| 61 | |Lien image|((( | ||
| 62 | {{{[[image:Espace2.Page2@img.png>>Espace1.Page1]]}}} | ||
| 63 | {{info}}La syntaxe Wiki est supportée dans les étiquettes des liens.{{/info}} | ||
| 64 | )))|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] | ||
| 65 | |Lien vers une pièce jointe à la page courante|{{{[[texte>>attach:img.png]]}}}|[[texte>>attach:img.png]] | ||
| 66 | |Lien vers une pièce jointe à une autre page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] | ||
| 67 | |Lien vers une ancre dans une page|{{{[[label>>Space.Page#ancre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=ancre]] | ||
| 68 | |Lien vers un titre dans une page|{{{[[label>>Space.Page#HMontitre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] | ||
| |
1.1 | 69 | |
| |
2.1 | 70 | {{info}}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".{{/info}} |
| |
1.1 | 71 | |
| |
2.1 | 72 | {{velocity}} |
| 73 | $subHeading Spécifications des liens pour la syntaxe XWiki 2.0 $subHeading | ||
| 74 | {{/velocity}} | ||
| |
1.1 | 75 | |
| |
2.1 | 76 | La syntaxe complèted'un lien est ##(label>>)?(link)(||parameters)*## |
| |
1.1 | 77 | |
| |
2.1 | 78 | * ##label##: L'étiquette du lien qui peut contenir de la syntaxe wiki |
| 79 | * ##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 email et vers une pièce jointe. | ||
| 80 | * ##parameters##: Une liste optionnelle de paramètres transmis au lien. | ||
| |
1.1 | 81 | |
| 82 | === 2.1 Links === | ||
| 83 | |||
| |
2.1 | 84 | |=Fonctionnalité|=Syntaxe XWiki 2.1|=Résultat |
| 85 | |Lien vers une page de l'espace courant|{{{[[WebHome]]}}}|[[WebHome]] | ||
| 86 | |Lien avec étiquette|{{{[[étiquette>>WebHome]]}}}|[[étiquette>>WebHome]] | ||
| 87 | |Lien vers une page avec l'espace spécifié|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] | ||
| 88 | |Lien vers un sous-wiki|{{{[[sous-wiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] | ||
| 89 | |Lien qui s'ouvre dans une nouvelle page|{{{[[étiquette>>WebHome||rel="__blank"]]}}}|[[étiquette>>WebHome||rel="__blank"]] | ||
| 90 | |Lien vers un URL placé directement dans le texte|{{{Ceci est un URL: http://xwiki.org}}}|Ceci est un URL: http://xwiki.org | ||
| 91 | |Lien vers un URL|{{{[[http://xwiki.org]]}}}|[[http://xwiki.org]] | ||
| 92 | |Lien vers un URL avec étiquette|{{{[[XWiki>>http://xwiki.org]]}}}|[[XWiki>>http://xwiki.org]] | ||
| 93 | |Lien vers une adresse email|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] | ||
| 94 | |Lien image|((( | ||
| 95 | {{{[[image:Espace2.Page2@img.png>>Espace1.Page1]]}}} | ||
| 96 | {{info}}La syntaxe Wiki est supportée dans les étiquettes des liens.{{/info}} | ||
| 97 | )))|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] | ||
| 98 | |Lien image avec paramètres image|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||height="26" width="26"]]>>Main.WebHome]] | ||
| 99 | |Lien vers une pièce jointe à la page courante|{{{[[texte>>attach:img.png]]}}}|[[texte>>attach:img.png]] | ||
| 100 | |Lien vers une pièce jointe à une autre page|{{{[[texte>>attach:Space.Page@img.png]]}}}|[[texte>>attach:XWiki.XWikiSyntaxLinks@img.png]] | ||
| 101 | |Lien vers une ancre dans une page|{{{[[label>>Space.Page||ancre=ancre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=ancre]] | ||
| 102 | |Lien vers un titre dans une page|{{{[[label>>XWiki.XWikiSyntax||anchor=HMontitre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] | ||
| |
1.1 | 103 | |
| |
2.1 | 104 | {{info}}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".{{/info}} |
| |
1.1 | 105 | |
| |
2.1 | 106 | {{velocity}} |
| 107 | $subHeading Spécifications des liens pour la syntaxe XWiki 2.1 $subHeading | ||
| 108 | {{/velocity}} | ||
| |
1.1 | 109 | |
| |
2.1 | 110 | La syntaxe complète d'un lien est ##(label>>)?(link)(||parameters)*## |
| |
1.1 | 111 | |
| |
2.1 | 112 | * ##label##: L'étiquette du lien qui peut contenir de la syntaxe wiki |
| 113 | * ##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 email et vers une pièce jointe. | ||
| 114 | * ##parameters##: Une liste optionnelle de paramètres transmis au lien. | ||
| |
1.1 | 115 | ** **##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## |
| |
2.1 | 116 | ** **##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## |
| 117 | ** **##rel##**: An optional parameter that allows to open link target in new window. Example: ##rel="~_~_blank"## |