XWikiSyntaxLinks

1

= Editing =

2

3

== Liens ==

4

5

{{comment}}please do not translate the sub headlines{{/comment}}

6

=== 1.0 Links ===

7

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

21

{{{{attach:text|file=img.png}}}}

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

26

)))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]

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

29

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

31

32

33

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

34

35

36

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

37

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"

=== 2.0 Links ===

|=(% 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]]

69

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

71

72

73

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

74

75

76

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

77

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.

=== 2.1 Links ===

|=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]]

103

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

105

106

107

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

108

109

110

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

111

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.

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

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

Code source wiki de XWikiSyntaxLinks