Loading…
 None
Source string changed |
|
|
None
Source string changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>> * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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 and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##( {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:] *** **##url:##** An optional string identifying the resource as an URL. ** ** **Wiki page**: A reference in the form **## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, *** **##wikiName##**: An optional string containing the name of a *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **## *** **##doc:##** A *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space** *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki: *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~: *** **##attach~:##** A required string identifying the resource as attachment. *** **##wikiPageName##**: An optional string referencing the (terminal or non-terminal) page that holds the attachment. This is resolved identically to "Untyped", below. *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** **** **##Non-terminal page##** *** //Note1 - Absolute links//: *** //Note2 - Special handling of ##.WebHome##//: * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##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 and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## |
|
None
Source string changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>> * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##( {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:] *** **##url:##** An optional string identifying the resource as an URL. ** ** **Wiki page**: A reference in the form **## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, *** **##wikiName##**: An optional string containing the name of a *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **## *** **##doc:##** A *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space** *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki: *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~: *** **##attach~:##** A required string identifying the resource as attachment. *** **##wikiPageName##**: An optional string referencing the (terminal or non-terminal) page that holds the attachment. This is resolved identically to "Untyped", below. *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** **** **##Non-terminal page##** *** //Note1 - Absolute links//: *** //Note2 - Special handling of ##.WebHome##//: * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##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## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## |
 surli
Translation changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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 and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##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 and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
= Editing =
== Liens == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === |=(% style="width:20%" %)Fonctionnalité|=Syntaxe XWiki 1.0|=(% style="width:20%" %)Résultat |Lien vers une page de l'espace courant|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Lien avec étiquette|{{{[étiquette>WebHome]}}}|[[étiquette>>WebHome]] |Lien vers une page avec l'espace spécifié|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Lien vers un sous-wiki|{{{[sous-wiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Lien qui s'ouvre dans une nouvelle page|{{{[étiquette>WebHome>_blank]}}}|[[étiquette>>WebHome||rel="__blank"]] |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>>http://xwiki.org]] |Lien vers une adresse email|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Lien image|{{{<a href="$xwiki.getURL("Espace1.Page1")">{image:img.png|document=Espace2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Lien vers une pièce jointe à la page courante|((( {{info}}Voir [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}} {{{{attach:text|file=img.png}}}} )))|[[texte>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Lien vers une pièce jointe à une autre page|((( {{info}}Voir [[Attacher une Macro>>http://code.xwiki.org/xwiki/bin/view/Macros/AttachMacro]] pour savoir plus.{{/info}} {{{{attach:texte|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Lien vers une ancre dans une page|{{{[label>Space.Page#ancre]}}}|[[label>>XWiki.XWikiSyntax||ancre=ancre]] |Lien vers un titre dans une page|{{{[label>Space.Page#HMontitre]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] {{info}}Quand vous ajoutez un {{velocity}} $subHeading Spécifications des liens pour la syntaxe XWiki 1.0 $subHeading {{/velocity}} 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 ** ##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. ** ##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>>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". * ##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 |Lien vers une page de l'espace courant|{{{[[WebHome]]}}}|[[WebHome]] |Lien avec étiquette|{{{[[étiquette>>WebHome]]}}}|[[étiquette>>WebHome]] |Lien vers une page avec l'espace spécifié|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Lien vers un sous-wiki|{{{[[sous-wiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Lien qui s'ouvre dans une nouvelle page|{{{[[étiquette>>WebHome||rel="__blank"]]}}}|[[étiquette>>WebHome||rel="__blank"]] |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>>http://xwiki.org]] |Lien vers une adresse email|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Lien image|((( {{{[[image:Espace2.Page2@img.png>>Espace1.Page1]]}}} {{info}}La syntaxe Wiki est supportée dans les étiquettes des liens.{{/info}} )))|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Lien vers une pièce jointe à la page courante|{{{[[texte>>attach:img.png]]}}}|[[texte>>attach:img.png]] |Lien vers une pièce jointe à une autre page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Lien vers une ancre dans une page|{{{[[label>>Space.Page#ancre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=ancre]] |Lien vers un titre dans une page|{{{[[label>>Space.Page#HMontitre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] {{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}} {{velocity}} $subHeading Spécifications des liens pour la syntaxe XWiki 2.0 $subHeading {{/velocity}} 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~:## et##{{{attach:}}}##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]]}}}|[[WebHome]] |Lien avec étiquette|{{{[[étiquette>>WebHome]]}}}|[[étiquette>>WebHome]] |Lien vers une page avec l'espace spécifié|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Lien vers un sous-wiki|{{{[[sous-wiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Lien qui s'ouvre dans une nouvelle page|{{{[[étiquette>>WebHome||rel="__blank"]]}}}|[[étiquette>>WebHome||rel="__blank"]] |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>>http://xwiki.org]] |Lien vers une adresse email|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Lien image|((( {{{[[image:Espace2.Page2@img.png>>Espace1.Page1]]}}} {{info}}La syntaxe Wiki est supportée dans les étiquettes des liens.{{/info}} )))|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |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]] |Lien vers une pièce jointe à la page courante|{{{[[texte>>attach:img.png]]}}}|[[texte>>attach:img.png]] |Lien vers une pièce jointe à une autre page|{{{[[texte>>attach:Space.Page@img.png]]}}}|[[texte>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Lien vers une ancre dans une page|{{{[[label>>Space.Page||ancre=ancre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=ancre]] |Lien vers un titre dans une page|{{{[[label>>XWiki.XWikiSyntax||anchor=HMontitre]]}}}|[[label>>XWiki.XWikiSyntax||anchor=HMontitre]] {{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}} {{velocity}} $subHeading Spécifications des liens pour la syntaxe XWiki 2.1 $subHeading {{/velocity}} 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~:## et##{{{attach:}}}##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"## |
|
surli
Contributor joined |
Contributor joined
3 years ago
|
== Links ==
=== 1.0 Links ===
|=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result
|Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]]
|Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]]
|Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]]
|Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]]
|Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]]
|Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]]
|Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]]
|Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link to an attachment on the current page|(((
{{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}}
{{{{attach:text|file=img.png}}}}
)))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an attachment in a different page|(((
{{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] for details{{/info}}
{{{{attach:text|document=Space.Page|file=img.png}}}}
)))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]]
|Link to a Heading in a page|(((
{{{[label>Space.Page#HMyheading]}}}
)))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]]
{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}
{{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}}
{{info}}
Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used.
{{/info}}
The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##**
* **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page##
* **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##**
** **##reference##**: The link reference. This can be either
*** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or
*** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
**** **##wikiName##**: An optional string containing the name of a
virtualwiki. The link will point to a page inside thatvirtualwiki. Example: ##mywiki##**** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
**** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome##
** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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: ##HTableOfContents##
* **##interWikiAlias##**: An optional [[Inter Wiki>>
http://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia##* **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank##
=== 2.0 Links ===
|=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result
|Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]]
|Link with a label|(((
{{{[[label>>WebHome]]}}}
{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>WebHome]]
|Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]]
|Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
|Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]]
|Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]]
|Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]]
|Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]]
|Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]]
{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}
{{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}}
{{info}}
The part in ##( )## is required, while the parts in ##[ ]## are optional.
{{/info}}
The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##**
* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##**
** **##reference##**: The link reference in one of the following forms:
*** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/##
*** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
**** **##wikiName##**: An optional string containing the name of a
virtualwiki. The link will point to a page inside thatvirtualwiki. Example: ##mywiki##**** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
**** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome##
*** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##
**** **##attach~:##** A required string identifying the resource as attachment.
**** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above.
**** **##attachmentName##**: Name of the attachment as it is stored in the wiki.
*** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##
**** **##mailto~:##** A required string identifying the resource as email.
**** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##"
** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##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 and images. Example: ##HTableOfContents##
* **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia##
* **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window)
=== 2.1 Links ===
|=Feature|=XWiki Syntax 2.1|=Result
|Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]]
|Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]]
|Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]]
|Link with a label|(((
{{{[[label>>PageA]]}}}
{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>]]
|Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]]
|Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]]
|Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]]
|Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]]
|Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]]
|Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]]
|Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]]
|Link to a Heading in a page|(((
{{{[[PageA.PageB||anchor="HMyheading"]]}}}
{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}
)))|[[PageB>>]]
|Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]]
|Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]]
|Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]]
{{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}}
{{info}}
Legend: The parts in ##(
isare required, while the parts in ##[{{/info}}
The full format of a link is **##[label>>] (resource) [||parameters]##**
* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: A required string with the link reference in one of the following forms
** **URL**: Any URL in the form of **##[url:]
*** **##url:##** An optional string identifying the resource as an URL.
**
**Wiki page** {{info}}Since 10.6{{/info}}* **##protocol:~/~/path##**: The URL itself** **Wiki page**: A reference in the form **##
(page:)[(wikiName):]*** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page,
bothif both exist it will lead to the non-terminal page.*** **##wikiName##**: An optional string containing the name of a
virtualwiki. The link will point to a page inside thatvirtualwiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##*** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child##
** **Wiki document**: A reference in the form **##
([doc:)]~[~[(wikiName):]*** **##doc:##** A
requiredn optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##).*** **##wikiName##**: An optional string containing the name of a
virtualwiki. The link will point to a page inside thatvirtualwiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome##
** **Wiki space**
{{info}}Since 7.4.1{{/info}}: A reference in the form **##(space:)[(wikiName):]*** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space).
*** **##wikiName##**: An optional string containing the name of a
virtualwiki. The link will point to a page inside thatvirtualwiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##*** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C##
** **InterWiki page**: A reference in the form **##interwiki:
: )):](pageName)##**. Example: ##interwiki:wikipedia:XWiki##*** **##interwiki:##** A required string identifying the resource as an InterWiki link.
*** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia##
*** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki##
** **Attachment**: A reference in the form **##attach~:
[wikiPageName@] (attachment~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##***** **##attach~:##** A required string identifying the reference as an XWiki Document attachment.
*** **##wikiName
)##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##, ##attach~:mywiki:Main@img.png##mywiki##.*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##**
*** **##
apageAttach~:##** An required string identifying the resourference as an XWiki Page attachment.*** **##wiki
PageName##**: An optional stringreferencing the (terminal or non-terminal) page that holds the attachment. This is resolved identically to "Untyped", below.containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.*** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Email address**: A reference in the form **##mailto
~: ({{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##*** **##mailto~:##** A required string identifying the resource as email.
*** **##emailAddress##**: Targeted email address. Example: ##john@smith.com##
** **Relative path**: A reference on the server in the form **##path
: ({{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##.*** **##path:##** A required string identifying the resource as a relative path.
*** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked.
** **UNC (Windows Explorer)**: A reference in the form **##unc
: ({{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile##*** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path.
*** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile##
** **Untyped**: If none of the above
*** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]##
*** **##Non-terminal page##**
{{info}}Since 7.4.1{{/info}}in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]##*** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made:
**** **##Terminal page##**
{{info}}Since 7.4.1{{/info}}as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]##**** **##Non-terminal page##**
{{info}}Since 7.4.1{{/info}}as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]##*** //Note1 - Absolute links//:
{{info}}Since 7.4.1{{/info}}If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##.*** //Note2 - Special handling of ##.WebHome##//:
{{info}}Since 7.4.1{{/info}}If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##.* **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"##
** **##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 and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents##
** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##