XWiki Platform/xwiki-platform-help/xwiki-platform-help-syntax/XWiki.XWikiSyntaxLinks — German @ Weblate XWiki.org: = Editing = == Links == === 1.0 Links === …

Translation

Key content

English

= 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&param2=value2"]]}}}|[[PageB>>]]
|Link to the current page with a query string|{{{[[label>>||queryString="param1=value1&param2=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"##

German

= Bearbeiten =

== Links ==

{{comment}}please do not translate the sub headlines{{/comment}}
=== 1.0 Links ===

|=(% style="width:20%" %)Funktion|=XWiki Syntax 1.0|=(% style="width:20%" %)Ergebnis
|Link zu Seite im aktuellen Bereich|{{{[WebHome]}}}|[[Web Home>>WebHome]]
|Link mit Linktext|{{{[Linktext>WebHome]}}}|[[Linktext>>WebHome]]
|Link mit XWiki Syntax im Linktext|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}|[[**fetter Linktext**>>WebHome]]
|Link zu Seite im angegebenen Bereich|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]]
|Link zu einem Unterwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]]
|Link der in neuem Fenster öffnet|{{{[Linktext>WebHome>_blank]}}}|[[Linktext>>WebHome||rel="__blank"]]
|Link zu einer URL direkt im Text|{{{Dies ist eine URL: https://xwiki.org}}}|Dies ist eine URL: https://xwiki.org
|Link zu einer URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]]
|Link zu einer URL mit Linktext|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]]
|Link zu einer E-Mail-Adresse|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Bild-Link|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png|document=Bereich2.Seite2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Bild-Link mit Bildparametern|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png|document=Bereich2.Seite2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link zu einem Anhang auf der aktuellen Seite|(((
{{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}}
{{{{attach:Text|file=img.png}}}}
)))|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link zu einem Anhang auf einer anderen Seite|(((
{{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}}
{{{{attach:Text|document=Bereich.Seite|file=img.png}}}}
)))|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]]

{{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation  $subHeading{{/velocity}}

{{info}}
Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden.
{{/info}}

Das vollständige Format eines Links ist **##[Linktext {> oder |}] (Ressource) [@interWikiAlias] [{> oder|} Ziel]##**

* **##Linktext##**: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite##
* **##Ressource##**: Die vollständige Linkreferenz in folgender Syntax: **##(Referenz) [?queryString] [#Anker]##**
** **##Referenz##**: Die Linkreferenz in einer der folgenden Formen:
*** **Ein URI** in der Form **##Protokoll:Pfad##** (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder
*** **Eine Wikiseitenreferenz** in der Form **##~[~[wikiName:] Bereich.] (Seite)##**. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein.
**** **##wikiName##**: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki##
**** **##Bereich##**: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main##
**** **##Seite##**: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome##
** **##queryString##**: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo##
** **##Anker##**: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis##
* **##interWikiAlias##**: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia##
* **##Ziel##**: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank##

=== 2.0 Links ===

|=(% style="width:20%" %)Funktion|=XWiki Syntax 2.0|=(% style="width:20%" %)Ergebnis
|Link zu Seite im aktuellen Bereich|{{{[[WebHome]]}}}|[[WebHome]]
|Link mit Linktext|(((
{{{[[Linktext>>WebHome]]}}}
{{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}}
)))|[[Linktext>>WebHome]]
|Link mit XWiki Syntax im Linktext|{{{[[**fetter Linktext**>>WebHome]]}}}|[[**fetter Linktext**>>WebHome]]
|Link zu Seite im angegebenen Bereich|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
|Link zu einem Unterwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]]
|Link der in neuem Fenster öffnet|{{{[[Linktext>>WebHome||rel="__blank"]]}}}|[[Linktext>>WebHome||rel="__blank"]]
|Link zu einer URL direkt im Text|{{{Dies ist eine URL: https://xwiki.org}}}|Dies ist eine URL: https://xwiki.org
|Link zu einer URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Link zu einer URL mit Linktext|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link zu einer E-Mail-Adresse|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Bild-Link|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Bild-Link mit Bildparametern|{{{[[[[image:Bereich2.Seite2@Bild.png||width="26" height="26"]]>>Bereich1.Seite1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link zu einem Anhang auf der aktuellen Seite|{{{[[Text>>attach:img.png]]}}}|[[Text>>attach:img.png]]
|Link zu einem Anhang auf einer anderen Seite|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}|[[Text>>attach:XWiki.XWikiSyntax@img.png]]
|Link zu einem Anker auf einer Seite|{{{[[Text>>Bereich.Seite#anchor]]}}}|[[Text>>XWiki.XWikiSyntax||anchor=anchor]]
|Link zu einer Überschrift auf einer Seite|{{{[[Text>>Bereich.Seite#HMyheading]]}}}|[[Text>>XWiki.XWikiSyntax||anchor=HMyheading]]

{{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}}

{{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}}

{{info}}
Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind.
{{/info}}

Das vollständige Format eines Links ist **##[Linktext>>] (Ressource) [@interWikiAlias] [||Parameter]##**

=== 2.1 Links ===

|=Funktion|=XWiki Syntax 2.1|=Ergebnis
|Link zu Seite im aktuellen Bereich|{{{[[WebHome]]}}}|[[WebHome]]
|Link mit Linktext|(((
{{{[[Linktext>>WebHome]]}}}
{{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}}
)))|[[Linktext>>WebHome]]
|Link mit XWiki Syntax im Linktext|{{{[[**fetter Linktext**>>WebHome]]}}}|[[**fetter Linktext**>>WebHome]]
|Link zu Seite im angegebenen Bereich|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
|Link zu einem Unterwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]]
|Link der in neuem Fenster öffnet|{{{[[Linktext>>WebHome||rel="__blank"]]}}}|[[Linktext>>WebHome||rel="__blank"]]
|Link zu einer URL direkt im Text|{{{Dies ist eine URL: https://xwiki.org}}}|Dies ist eine URL: https://xwiki.org
|Link zu einer URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Link zu einer URL mit Linktext|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link zu einer E-Mail-Adresse|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Bild-Link|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Bild-Link mit Bildparametern|{{{[[[[image:Bereich2.Seite2@Bild.png||width="26" height="26"]]>>Bereich1.Seite1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link zu einem Anhang auf der aktuellen Seite|{{{[[Text>>attach:img.png]]}}}|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link zu einem Anhang auf einer anderen Seite|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link zu einem Anker auf einer Seite|{{{[[Text>>Bereich.Seite||anchor=anchor]]}}}|[[Text>>XWiki.XWikiSyntax||anchor=anchor]]
|Link zu einer Überschrift auf einer Seite|{{{[[Text>>Bereich.Seite||anchor=HMyheading]]}}}|[[Text>>XWiki.XWikiSyntax||anchor=HMyheading]]

{{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}}

{{info}}
Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind.
{{/info}}

Das vollständige Format eines Links ist **##[Linktext>>] (Ressource) [||Parameter]##**

* **##Linktext##**: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Beispiel: ##Meine Seite##
* **##Ressource##**: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen
** **URL**: Eine URL in der Form **##[url:] (Protokoll:~/~/Pfad)##**. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/##
*** **##url:##** Eine optionale Zeichenkette, die die Ressource als URL identifiziert.
** **Wikiseitenname** Referenz in der Form **##[doc:] ~[~[wikiName:] Bereich.] (Seite)##**. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
*** **##doc:##** Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert.
**** **##wikiName##**: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki##
**** **##Bereich##**: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main##
**** **##Seite##**: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome##
** **InterWiki Seitenname** Referenz in der Form **##interwiki: {{{(interWikiAlias:)}}} (Seite)##**. Beispiel: ##interwiki:wikipedia:XWiki##
*** **##interwiki:##** Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert.
*** **##interWikiAlias##**: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Beispiel: ##wikipedia##
*** **##Seite##**: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki##
** **Anhang**: Referenz in der Form **##attach~:~{~{~{(wikiName):}(spaceNameListe).}(seitenName)@}(anhangsName)##**
*** **##attach~:##** Eine erforderliche Zeichenfolge, die die Referenz als XWiki-Dokumentanhang identifiziert.
*** **##wikiName##**: Eine optionale Zeichenfolge, die den Namen eines Wikis enthält. Die Bildreferenz zeigt auf ein Bild, das an eine Seite innerhalb dieses Wikis angehängt ist. Wenn kein Wiki angegeben ist, wird das aktuelle Wiki verwendet. Beispiel: ##mywiki##.
*** **##spaceNameListe##**: Eine optionale, durch Punkte getrennte Liste von Wiki-Bereichs-Namen. Wenn kein Bereich angegeben ist, wird der aktuelle Bereich verwendet. Beispiele: ##Main##, ##A.B##, ##A.B.C##
*** **##seitenName##**: Eine optionale Zeichenfolge, die den Namen der Wiki-Seite enthält, an die das referenzierte Bild angehängt ist. Beispiel: ##Welcome##
*** **##anhangsName##**: Name des Anhangs, wie er im Wiki gespeichert ist.
** **E-Mail-Adresse** in der Form **##mailto~: (emailAdresse)##** (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com##
*** **##mailto~:##**: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert.
*** **##emailAddress##**: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com##
** **Relativer Pfad** Referenz auf dem Server in der Form **##path: (relPfad)##**. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird.
*** **##path:##** Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert.
*** **##relPfad##**: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll.
** **UNC (Windows Explorer)** Referenz in der Form **##unc: (Pfad)##**. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile##
*** **##unc:##** Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert.
*** **##Pfad##**: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile##
* **##Parameter##**: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"##
** **##queryString##**: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad||queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello##
** **##anchor##**: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##url:http:~/~/domain.com/pfad||anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis##
** **##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"##

Needs editing

Insufficient privileges for saving translations.

Skip

	Key	English	German	Actions
	content	= 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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"##	= Bearbeiten = == Links == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 1.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[WebHome]}}}\|[[Web Home>>WebHome]] \|Link mit Linktext\|{{{[Linktext>WebHome]}}}\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[Main.WebHome]}}}\|[[Web Home>>Main.WebHome]] \|Link zu einem Unterwiki\|{{{[subwiki:Main.WebHome]}}}\|[[Web Home>>xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[Linktext>WebHome>_blank]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[https://xwiki.org]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[XWiki>https://xwiki.org]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[john@smith.net>mailto:john@smith.net]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2}</a>}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2\|width=26\|height=26}</a>}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|((( {{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|((( {{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|document=Bereich.Seite\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] {{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden. {{/info}} Das vollständige Format eines Links ist ##[Linktext {> oder \|}] (Ressource) [@interWikiAlias] [{> oder\|} Ziel]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * Ein URI in der Form ##Protokoll:Pfad## (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder * Eine Wikiseitenreferenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein. ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Ziel##: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank## === 2.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 2.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[[https://xwiki.org]]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>https://xwiki.org]]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntax@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite#anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite#HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [@interWikiAlias] [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * URL: Eine URL in der Form ##Protokoll:~/~/Pfad##. Beispiele: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## * Wikiseitenname Referenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## * Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)## (###Anker## ist nicht zulässig). Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## ** ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. * E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## ** ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Parameter##: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: ##rel="~_~_blank"## (in neuem Fenster öffnen) === 2.1 Links === \|=Funktion\|=XWiki Syntax 2.1\|=Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[[https://xwiki.org]]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>https://xwiki.org]]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen URL: Eine URL in der Form ##[url:] (Protokoll:~/~/Pfad)##. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## * ##url:## Eine optionale Zeichenkette, die die Ressource als URL identifiziert. Wikiseitenname Referenz in der Form ##[doc:] ~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## * ##doc:## Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert. ** ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## InterWiki Seitenname Referenz in der Form ##interwiki: {{{(interWikiAlias:)}}} (Seite)##. Beispiel: ##interwiki:wikipedia:XWiki## * ##interwiki:## Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert. * ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Beispiel: ##wikipedia## * ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki## Anhang: Referenz in der Form ##attach~:~{~{~{(wikiName):}(spaceNameListe).}(seitenName)@}(anhangsName)## * ##attach~:## Eine erforderliche Zeichenfolge, die die Referenz als XWiki-Dokumentanhang identifiziert. * ##wikiName##: Eine optionale Zeichenfolge, die den Namen eines Wikis enthält. Die Bildreferenz zeigt auf ein Bild, das an eine Seite innerhalb dieses Wikis angehängt ist. Wenn kein Wiki angegeben ist, wird das aktuelle Wiki verwendet. Beispiel: ##mywiki##. * ##spaceNameListe##: Eine optionale, durch Punkte getrennte Liste von Wiki-Bereichs-Namen. Wenn kein Bereich angegeben ist, wird der aktuelle Bereich verwendet. Beispiele: ##Main##, ##A.B##, ##A.B.C## * ##seitenName##: Eine optionale Zeichenfolge, die den Namen der Wiki-Seite enthält, an die das referenzierte Bild angehängt ist. Beispiel: ##Welcome## * ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## * ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. * ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## Relativer Pfad Referenz auf dem Server in der Form ##path: (relPfad)##. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird. * ##path:## Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert. * ##relPfad##: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll. UNC (Windows Explorer) Referenz in der Form ##unc: (Pfad)##. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## * ##unc:## Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert. * ##Pfad##: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## * ##Parameter##: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello## ##anchor##: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##url:http:~/~/domain.com/pfad\|\|anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis## ##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"##
	title	XWikiSyntaxLinks	XWikiSyntaxLinks

	Key	English	German	Actions
	content	= 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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"##	= Bearbeiten = == Links == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 1.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[WebHome]}}}\|[[Web Home>>WebHome]] \|Link mit Linktext\|{{{[Linktext>WebHome]}}}\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[Main.WebHome]}}}\|[[Web Home>>Main.WebHome]] \|Link zu einem Unterwiki\|{{{[subwiki:Main.WebHome]}}}\|[[Web Home>>xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[Linktext>WebHome>_blank]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[https://xwiki.org]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[XWiki>https://xwiki.org]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[john@smith.net>mailto:john@smith.net]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2}</a>}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2\|width=26\|height=26}</a>}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|((( {{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|((( {{info}}Siehe [[Anhangsmakro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|document=Bereich.Seite\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] {{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden. {{/info}} Das vollständige Format eines Links ist ##[Linktext {> oder \|}] (Ressource) [@interWikiAlias] [{> oder\|} Ziel]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * Ein URI in der Form ##Protokoll:Pfad## (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder * Eine Wikiseitenreferenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein. ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Ziel##: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank## === 2.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 2.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[[https://xwiki.org]]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>https://xwiki.org]]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntax@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite#anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite#HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [@interWikiAlias] [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * URL: Eine URL in der Form ##Protokoll:~/~/Pfad##. Beispiele: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## * Wikiseitenname Referenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## * Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)## (###Anker## ist nicht zulässig). Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## ** ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. * E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## ** ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Parameter##: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: ##rel="~_~_blank"## (in neuem Fenster öffnen) === 2.1 Links === \|=Funktion\|=XWiki Syntax 2.1\|=Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: https://xwiki.org}}}\|Dies ist eine URL: https://xwiki.org \|Link zu einer URL\|{{{[[https://xwiki.org]]}}}\|[[https://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>https://xwiki.org]]}}}\|[[XWiki>>https://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen URL: Eine URL in der Form ##[url:] (Protokoll:~/~/Pfad)##. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## * ##url:## Eine optionale Zeichenkette, die die Ressource als URL identifiziert. Wikiseitenname Referenz in der Form ##[doc:] ~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## * ##doc:## Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert. ** ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## InterWiki Seitenname Referenz in der Form ##interwiki: {{{(interWikiAlias:)}}} (Seite)##. Beispiel: ##interwiki:wikipedia:XWiki## * ##interwiki:## Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert. * ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Beispiel: ##wikipedia## * ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki## Anhang: Referenz in der Form ##attach~:~{~{~{(wikiName):}(spaceNameListe).}(seitenName)@}(anhangsName)## * ##attach~:## Eine erforderliche Zeichenfolge, die die Referenz als XWiki-Dokumentanhang identifiziert. * ##wikiName##: Eine optionale Zeichenfolge, die den Namen eines Wikis enthält. Die Bildreferenz zeigt auf ein Bild, das an eine Seite innerhalb dieses Wikis angehängt ist. Wenn kein Wiki angegeben ist, wird das aktuelle Wiki verwendet. Beispiel: ##mywiki##. * ##spaceNameListe##: Eine optionale, durch Punkte getrennte Liste von Wiki-Bereichs-Namen. Wenn kein Bereich angegeben ist, wird der aktuelle Bereich verwendet. Beispiele: ##Main##, ##A.B##, ##A.B.C## * ##seitenName##: Eine optionale Zeichenfolge, die den Namen der Wiki-Seite enthält, an die das referenzierte Bild angehängt ist. Beispiel: ##Welcome## * ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## * ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. * ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## Relativer Pfad Referenz auf dem Server in der Form ##path: (relPfad)##. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird. * ##path:## Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert. * ##relPfad##: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll. UNC (Windows Explorer) Referenz in der Form ##unc: (Pfad)##. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## * ##unc:## Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert. * ##Pfad##: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## * ##Parameter##: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello## ##anchor##: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##url:http:~/~/domain.com/pfad\|\|anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis## ##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"##
	title	XWikiSyntaxLinks	XWikiSyntaxLinks

Loading…

Simpel Translation changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	English = 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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"## German 601 characters edited = Bearbeiten = == Links == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 1.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[WebHome]}}}\|[[Web Home>>WebHome]] \|Link mit Linktext\|{{{[Linktext>WebHome]}}}\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[Main.WebHome]}}}\|[[Web Home>>Main.WebHome]] \|Link zu einem Unterwiki\|{{{[subwiki:Main.WebHome]}}}\|[[Web Home>>xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[Linktext>WebHome>_blank]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[http://xwiki.org]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[XWiki>http://xwiki.org]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[john@smith.net>mailto:john@smith.net]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2}</a>}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2\|width=26\|height=26}</a>}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|document=Bereich.Seite\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] {{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden. {{/info}} Das vollständige Format eines Links ist ##[Linktext {> oder \|}] (Ressource) [@interWikiAlias] [{> oder\|} Ziel]##** * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * Ein URI in der Form ##Protokoll:Pfad## (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder * Eine Wikiseitenreferenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein. ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Ziel##: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank## === 2.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 2.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntax@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite#anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite#HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [@interWikiAlias] [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * URL: Eine URL in der Form ##Protokoll:~/~/Pfad##. Beispiele: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## * Wikiseitenname Referenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## * Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)## (###Anker## ist nicht zulässig). Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## ** ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. * E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## ** ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Parameter##: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: ##rel="~_~_blank"## (in neuem Fenster öffnen) === 2.1 Links === \|=Funktion\|=XWiki Syntax 2.1\|=Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen URL: Eine URL in der Form ##[url:] (Protokoll:~/~/Pfad)##. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## * ##url:## Eine optionale Zeichenkette, die die Ressource als URL identifiziert. Wikiseitenname Referenz in der Form ##[doc:] ~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## * ##doc:## Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert. ** ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## InterWiki Seitenname Referenz in der Form ##interwiki: {{{(interWikiAlias:)}}} (Seite)##. Beispiel: ##interwiki:wikipedia:XWiki## * ##interwiki:## Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert. * ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Beispiel: ##wikipedia## * ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki## Anhang: Referenz in der Form ##attach~: ~~[wikiS~~~{~{~{(wikiName):}(spaceNameListe).}(seitenName @] )@}(anhangsName)##~~. Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##~~ * ##attach~:##: Eine ~~notwendig~~erforderliche Zeichen~~kett~~folge, die die Re~~ssource als A~~ferenz als XWiki-Dokumentanhang identifiziert. * ##wiki~~Seiten~~Name##: Eine optionale Zeichen~~kette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "~~folge, die den Namen eines Wikis enthält. Die Bildreferenz zeigt auf ein Bild, das an eine Seite innerhalb dieses Wikis angehängt ist. Wenn kein Wiki angegeben ist, wird das aktuelle Wiki verwendet. Beispiel: ##mywiki##. * ##spaceNameListe##: Eine optionale, durch Punkte getrennte Liste von Wiki-Bereichs-Namen. Wenn kein Bereich angegeben ist, wird der aktuelle Bereich verwendet. Beispiele: ##Main##, ##A.B##, ##A.B.C## * ##seitenName##: Eine optionale Zeichenfolge, die den Namen der Wikis-Seite~~nname" oben.~~ enthält, an die das referenzierte Bild angehängt ist. Beispiel: ##Welcome## * ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## * ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. * ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## Relativer Pfad Referenz auf dem Server in der Form ##path: (relPfad)##. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird. * ##path:## Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert. * ##relPfad##: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll. UNC (Windows Explorer) Referenz in der Form ##unc: (Pfad)##. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## * ##unc:## Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert. * ##Pfad##: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## * ##Parameter##: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello## ##anchor##: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. In XWiki werden Anker automatisch für Überschriften und Bilder erstellt. Beispiel: ##url:http:~/~/domain.com/pfad\|\|anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis## ##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"## 2 years ago
None Source string changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	= 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 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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~:~~[(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 re~~source as~~ference as an XWiki Page attachment. * ##wiki~~Page~~Name##: An optional string ~~referencing 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-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"## 2 years ago
Simpel Translation changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	English = 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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"## German 80 characters edited = Bearbeiten = == Links == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 1.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[WebHome]}}}\|[[Web Home>>WebHome]] \|Link mit Linktext\|{{{[Linktext>WebHome]}}}\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[Main.WebHome]}}}\|[[Web Home>>Main.WebHome]] \|Link zu einem Unterwiki\|{{{[subwiki:Main.WebHome]}}}\|[[Web Home>>xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[Linktext>WebHome>_blank]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[http://xwiki.org]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[XWiki>http://xwiki.org]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[john@smith.net>mailto:john@smith.net]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2}</a>}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2\|width=26\|height=26}</a>}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|document=Bereich.Seite\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] {{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden. {{/info}} Das vollständige Format eines Links ist ##[Linktext {> oder \|}] (Ressource) [@interWikiAlias] [{> oder\|} Ziel]##** * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * Ein URI in der Form ##Protokoll:Pfad## (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder * Eine Wikiseitenreferenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein. ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Ziel##: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank## === 2.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 2.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntax@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite#anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite#HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [@interWikiAlias] [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * URL: Eine URL in der Form ##Protokoll:~/~/Pfad##. Beispiele: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## * Wikiseitenname Referenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## * Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)## (###Anker## ist nicht zulässig). Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## ** ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. * E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## ** ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. ~~Es ist zu beachten, dass XWiki~~In XWiki werden Anker automatisch für Überschriften und Bilder erstellt ~~werden~~. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Parameter##: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: ##rel="~_~_blank"## (in neuem Fenster öffnen) === 2.1 Links === \|=Funktion\|=XWiki Syntax 2.1\|=Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen URL: Eine URL in der Form ##[url:] (Protokoll:~/~/Pfad)##. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## * ##url:## Eine optionale Zeichenkette, die die Ressource als URL identifiziert. Wikiseitenname Referenz in der Form ##[doc:] ~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## * ##doc:## Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert. ** ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## InterWiki Seitenname Referenz in der Form ##interwiki: {{{(interWikiAlias:)}}} (Seite)##. Beispiel: ##interwiki:wikipedia:XWiki## * ##interwiki:## Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert. * ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Beispiel: ##wikipedia## * ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki## Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)##. Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## * ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. * ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. * ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## * ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. * ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## Relativer Pfad Referenz auf dem Server in der Form ##path: (relPfad)##. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird. * ##path:## Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert. * ##relPfad##: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll. UNC (Windows Explorer) Referenz in der Form ##unc: (Pfad)##. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## * ##unc:## Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert. * ##Pfad##: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## * ##Parameter##: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello## ##anchor##: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. ~~Es ist zu beachten, dass XWiki~~In XWiki werden Anker automatisch für Überschriften und Bilder erstellt ~~werden~~. Beispiel: ##url:http:~/~/domain.com/pfad\|\|anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis## ##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"## 2 years ago
None Source string changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	= 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 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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~:[(wikiPageName)@](attachmentName)##. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##, ##attach~:mywiki:Main@img.png## * ##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{{{:(}}}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"## 2 years ago
Simpel Translation changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	English = 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=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"## German 0 characters edited = Bearbeiten = == Links == {{comment}}please do not translate the sub headlines{{/comment}} === 1.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 1.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[WebHome]}}}\|[[Web Home>>WebHome]] \|Link mit Linktext\|{{{[Linktext>WebHome]}}}\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{<a href="$xwiki.getURL("WebHome")"><strong>fetter Linktext</strong></a>}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[Main.WebHome]}}}\|[[Web Home>>Main.WebHome]] \|Link zu einem Unterwiki\|{{{[subwiki:Main.WebHome]}}}\|[[Web Home>>xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[Linktext>WebHome>_blank]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[http://xwiki.org]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[XWiki>http://xwiki.org]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[john@smith.net>mailto:john@smith.net]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2}</a>}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{<a href="$xwiki.getURL("Bereich1.Seite1")">{image:Bild.png\|document=Bereich2.Seite2\|width=26\|height=26}</a>}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|((( {{info}}Siehe [[Anhangsmakro>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Attach+Macro+%28Radeox%29]] für Details{{/info}} {{{{attach:Text\|document=Bereich.Seite\|file=img.png}}}} )))\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] {{velocity}}$subHeading XWiki Syntax 1.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Teil in ##( )## ist erforderlich, Teile in ##[ ]## sind optional und eines der zwei Zeichen in ##{ }## muss eingefügt werden, wenn optionale Teile verwendet werden. {{/info}} Das vollständige Format eines Links ist ##[Linktext {> oder \|}] (Ressource) [@interWikiAlias] [{> oder\|} Ziel]##** * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * Ein URI in der Form ##Protokoll:Pfad## (Beispiel: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), oder * Eine Wikiseitenreferenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiel: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## sein. ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispie: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Ziel##: Eine optionale Zeichenkette entsprechend dem HTML ##target## Attribut für ein HTML ##A## Linkelement. Dieses Element wird beim Rendern des Links verwendet. Standardmäßig wird der Link im aktuellen Fenster geöffnet. Beispiele: ##_self##, ##_blank## === 2.0 Links === \|=(% style="width:20%" %)Funktion\|=XWiki Syntax 2.0\|=(% style="width:20%" %)Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntax@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite#anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite#HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [@interWikiAlias] [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Die vollständige Linkreferenz in folgender Syntax: ##(Referenz) [?queryString] [#Anker]## ##Referenz##: Die Linkreferenz in einer der folgenden Formen: * URL: Eine URL in der Form ##Protokoll:~/~/Pfad##. Beispiele: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## * Wikiseitenname Referenz in der Form ##~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## * Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)## (###Anker## ist nicht zulässig). Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## ** ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. * E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## ** ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die in der gerenderten URL verwendet werden. Beispiel: ##mydata1=5&mydata2=Hallo## ##Anker##*: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##HInhaltsverzeichnis## ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Dies ist nur für Wikiseitennamen zulässig. Beispiel: ##wikipedia## * ##Parameter##: Eine optionale Liste mit Parametern, die an den Link weitergegeben werden. Beispiel: ##rel="~_~_blank"## (in neuem Fenster öffnen) === 2.1 Links === \|=Funktion\|=XWiki Syntax 2.1\|=Ergebnis \|Link zu Seite im aktuellen Bereich\|{{{[[WebHome]]}}}\|[[WebHome]] \|Link mit Linktext\|((( {{{[[Linktext>>WebHome]]}}} {{info}}XWiki Syntax innerhalb des Linktextes wird unterstützt.{{/info}} )))\|[[Linktext>>WebHome]] \|Link mit XWiki Syntax im Linktext\|{{{[[fetter Linktext>>WebHome]]}}}\|[[fetter Linktext>>WebHome]] \|Link zu Seite im angegebenen Bereich\|{{{[[Main.WebHome]]}}}\|[[Main.WebHome]] \|Link zu einem Unterwiki\|{{{[[subwiki:Main.WebHome]]}}}\|[[xwiki:Main.WebHome]] \|Link der in neuem Fenster öffnet\|{{{[[Linktext>>WebHome\|\|rel="__blank"]]}}}\|[[Linktext>>WebHome\|\|rel="__blank"]] \|Link zu einer URL direkt im Text\|{{{Dies ist eine URL: http://xwiki.org}}}\|Dies ist eine URL: http://xwiki.org \|Link zu einer URL\|{{{[[http://xwiki.org]]}}}\|[[http://xwiki.org]] \|Link zu einer URL mit Linktext\|{{{[[XWiki>>http://xwiki.org]]}}}\|[[XWiki>>http://xwiki.org]] \|Link zu einer E-Mail-Adresse\|{{{[[john@smith.net>>mailto:john@smith.net]]}}}\|[[john@smith.net>>mailto:john@smith.net]] \|Bild-Link\|{{{[[image:Bereich2.Seite2@Bild.png>>Bereich1.Seite1]]}}}\|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] \|Bild-Link mit Bildparametern\|{{{[[[[image:Bereich2.Seite2@Bild.png\|\|width="26" height="26"]]>>Bereich1.Seite1]]}}}\|[[[[image:XWiki.XWikiSyntaxLinks@img.png\|\|width="26" height="26"]]>>Main.WebHome]] \|Link zu einem Anhang auf der aktuellen Seite\|{{{[[Text>>attach:img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anhang auf einer anderen Seite\|{{{[[Text>>attach:Bereich.Seite@img.png]]}}}\|[[Text>>attach:XWiki.XWikiSyntaxLinks@img.png]] \|Link zu einem Anker auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=anchor]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=anchor]] \|Link zu einer Überschrift auf einer Seite\|{{{[[Text>>Bereich.Seite\|\|anchor=HMyheading]]}}}\|[[Text>>XWiki.XWikiSyntax\|\|anchor=HMyheading]] {{info}}Wenn Sie eine Überschrift in einem Dokument hinzufügen, wird daraus automatisch ein Anker generiert, der aus einem vorangestellem "H", gefolgt von den Buchstaben in der Überschrift gebildet wird. Beispiel: eine Überschrift "Neuer Abschnitt" erzeugt einen Anker "HNeuerAbschnitt".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.1 Linkspezifikation $subHeading{{/velocity}} {{info}} Der Teil in ##( )## ist erforderlich, während die Teile in ##[ ]## optional sind. {{/info}} Das vollständige Format eines Links ist ##[Linktext>>] (Ressource) [\|\|Parameter]## * ##Linktext##: Eine optionale Zeichenkette, welche dem Nutzer beim Rendern als Linkname gezeigt wird. Der Linktext kann XWiki Syntax enthalten. Wenn kein Linktext angegeben ist, wird ein Standartext generiert. Das Erstellungsmuster kann verändert werden, siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]. Beispiel: ##Meine Seite## * ##Ressource##: Eine erforderliche Zeichenkette mit der Linkreferenz in einer der folgenden Formen URL: Eine URL in der Form ##[url:] (Protokoll:~/~/Pfad)##. Beispiele: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## * ##url:## Eine optionale Zeichenkette, die die Ressource als URL identifiziert. Wikiseitenname Referenz in der Form ##[doc:] ~[~[wikiName:] Bereich.] (Seite)##. Beispiele: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## * ##doc:## Eine optionale Zeichenkette, die die Ressource als XWiki Dokument identifiziert. ** ##wikiName##: Eine optionale Zeichenkette, die den Namen des virtuellen Wikis enthält. Der Link wird auf eine Seite in diesem virtuellen Wiki zeigen. Beispiel: ##mywiki## ##Bereich##: Ein optionaler Bereichsname. Wenn kein Bereich spezifiziert wird, wird der aktuelle Bereich verwendet. Beispiel: ##Main## ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##WebHome## InterWiki Seitenname Referenz in der Form ##interwiki: {{{(interWikiAlias:)}}} (Seite)##. Beispiel: ##interwiki:wikipedia:XWiki## * ##interwiki:## Eine erforderliche Zeichenkette, die die Ressource als einen InterWiki Link identifiziert. * ##interWikiAlias##: Ein optionales [[Inter Wiki>>http://en.wikipedia.org/wiki/InterWiki]] Alias, entsprechend der Definition in der InterWiki Map (siehe [[Admin Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/]]). Beispiel: ##wikipedia## * ##Seite##: Eine erforderliche Zeichenkette, die den Namen der verknüpften Wikiseite enthält. Beispiel: ##XWiki## Anhang Referenz in der Form ##attach~: [wikiSeitenName @] (anhangsName)##. Beispiele: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## * ##attach~:##: Eine notwendige Zeichenkette, die die Ressource als Anhang identifiziert. * ##wikiSeitenName##: Eine optionale Zeichenkette, die das Dokument, an das der Anhang angehängt ist, referenziert, siehe "Wikiseitenname" oben. * ##anhangsName##: Name des Anhangs, wie er im Wiki gespeichert ist. E-Mail-Adresse in der Form ##mailto~: (emailAdresse)## (###Anker## ist nicht zulässig). Beispiel: ##mailto~:john@smith.com## * ##mailto~:##: Eine notwendige Zeichenkette, die die Ressource als E-Mail identifiziert. * ##emailAddress##: Ziel-E-Mail-Adresse. Beispiel: ##john@smith.com## Relativer Pfad Referenz auf dem Server in der Form ##path: (relPfad)##. Beispiel: ##path:$doc.getURL('reset')## erzeugt Zieladresse ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## wobei ##/xwiki/bin/reset/Space/Page## durch ##$doc.getURL('reset')## erzeugt wird. * ##path:## Eine erforderliche Zeichenkette, die die Ressource als relativen Pfad identifiziert. * ##relPfad##: Eine erforderliche Zeichenkette, die den relativen Pfad der Ressource auf dem Server enthält, die verknüpft werden soll. UNC (Windows Explorer) Referenz in der Form ##unc: (Pfad)##. Der Link wird als ##file:~/~/## gerendet. Beispiele: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## * ##unc:## Eine erforderliche Zeichenkette, die die Ressource als UNC (Windows Explorer) Pfad identifiziert. * ##Pfad##: Eine erforderliche Zeichenkette, die den lokalen Pfad der Ressource, die dem Nutzer zugänglich ist, enthält. Beispiele: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## * ##Parameter##: Eine optionale Liste von Leerzeichen-getrennten Parametern, die an den Link übergeben werden. Beispiel: ##queryString="mydata1=5&mydata2=Hallo" anchor="HInhaltsverzeichnis" rel="~_~_blank"## ##queryString##: Eine optionale Abfragezeichenkette, die Parameter spezifiziert, die an die Linkzieladresse angehängt werden und in der gerenderten URL verwendet werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|queryString="mydata1=5&mydata2=Hello"## erzeugt Zieladresse ##http:~/~/domain.com/pfad?mydata1=5&mydata2=Hello## ##anchor##: Ein optionaler Ankername, der auf einen Anker im referenzierten Link zeigt. Es ist zu beachten, dass XWiki Anker automatisch für Überschriften erstellt werden. Beispiel: ##url:http:~/~/domain.com/pfad\|\|anchor="HInhaltsverzeichnis"## erzeugt Zieladresse ##http:~/~/domain.com/pfad#HInhaltsverzeichnis## ##rel##**: Ein optionaler Parameter, der es ermöglicht das Linkziel in einem neuen Fenster zu öffnen. Beispiel: ##rel="~_~_blank"## 2 years ago
Simpel Contributor joined XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	Contributor joined 2 years ago
None Source string changed XWiki Platform xwiki-platform-help xwiki-platform-help-syntax XWiki.XWikiSyntaxLinks German	= 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 ~~virtual~~ wiki. The link will point to a page inside that ~~virtual~~ 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>>~~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 ~~virtual~~ wiki. The link will point to a page inside that ~~virtual~~ 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. 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&param2=value2"]]}}}\|[[PageB>>]] \|Link to the current page with a query string\|{{{[[label>>\|\|queryString="param1=value1&param2=value2"]]}}}\|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##( )## isare 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. Wiki page** {{info}}Since 10.6{{/info}}* ##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, ~~both~~if both exist it will lead to the non-terminal page. * ##wikiName##: An optional string containing the name of a ~~virtual~~ wiki. The link will point to a page inside that ~~virtual~~ 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:## A ~~required~~n 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 ~~virtual~~ wiki. The link will point to a page inside that ~~virtual~~ 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 ~~{{info}}Since 7.4.1{{/info}}~~: 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 ~~virtual~~ wiki. The link will point to a page inside that ~~virtual~~ 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~: [(wikiPageName)@] (attachmentName)##. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##, ##attach~:mywiki:Main@img.png## * ##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~~~: (~~{{{:(}}}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## ~~{{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. 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"## 3 years ago

Browse all string changes

Things to check

Consecutive duplicated words

Text contains the same word twice in a row: die

Reset

Mismatching line breaks

Number of new lines in translation does not match source

Reset

Glossary

English	German
HTML		XWiki Platform
URL	URL	XWiki Platform
Ein Uniform Resource Locator (Abk. URL; englisch für einheitlicher Ressourcenzeiger) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (engl. location) der Ressource in Computernetzwerken.
XWiki	XWiki	XWiki Platform

String information

Key

content

String age

4 years ago

Last updated

a year ago

Source string age

4 years ago

Translation file

xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.de.xml, string 1