| Strings Words Characters | |||
|---|---|---|---|
| 2 2,465 21,776 |
|
All strings | Browse Translate Zen |
| 2 2,465 21,776 |
|
Translated strings | Browse Translate Zen |
| 2 2,465 21,776 |
|
Unfinished strings without suggestions | Browse Translate Zen |
| 1 1 16 |
|
Strings with any failing checks | Browse Translate Zen |
| 1 1 16 |
|
Translated strings with any failing checks | Browse Translate Zen |
| 1 1 16 |
|
Translated strings with dismissed checks | Browse Translate Zen |
| 1 1 16 |
|
Failing check: Inconsistent | Browse Translate Zen |
Other components
| Component | Translated | Unfinished | Unfinished words | Unfinished characters | Untranslated | Checks | Suggestions | Comments | |
|---|---|---|---|---|---|---|---|---|---|
| Attachment - Validation - Default LGPL-2.1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | ||
|
|
|||||||||
| XWiki.Notifications.Code.LegacyNotificationAdministrationTranslations LGPL-2.1 | 83% | 1 | 1 | 5 | 0 | 0 | 0 | 0 | |
|
|
|||||||||
| XWiki Core Resources LGPL-2.1 | 96% | 150 | 854 | 4,925 | 87 | 2 | 0 | 47 | |
|
|
|||||||||
| XWiki Security Authentication Default LGPL-2.1 | 66% | 3 | 35 | 197 | 3 | 0 | 0 | 0 | |
|
|
|||||||||
| XWiki.OfficeImporterTranslations LGPL-2.1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | ||
|
|
|||||||||
| Attachment - Validation - UI LGPL-2.1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | ||
|
|
|||||||||
| XWiki.XWikiSyntaxOtherSyntaxes LGPL-2.1 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | ||
|
|
|||||||||
| XWiki.XWikiSyntaxVerbatim LGPL-2.1 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | ||
|
|
|||||||||
| Sandbox.WebHome LGPL-2.1 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | ||
|
|
|||||||||
| XWiki.XWikiSyntaxLists LGPL-2.1 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | ||
|
|
|||||||||
Overview
| Project website | www.xwiki.org |
|---|---|
| Translation license | GNU Lesser General Public License v2.1 only |
| Translation process |
|
| Source code repository |
https://github.com/xwiki/xwiki-platform
|
| Repository branch | master |
| Last remote commit |
XWIKI-22734: Improve the standard query validator
8b53ed9ec50
 tmortagne authored yesterday |
| Last commit in Weblate |
XCOMMONS-3051: Introduce the Supported By concept in Extension Manager and Repository
15728e115e4
tmortagne authored 3 months ago |
| Weblate repository |
https://l10n.xwiki.org/git/xwiki-platform/xwiki-core-resources/
|
| File mask | xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.*.xml |
| Monolingual base language file | xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.xml |
| Translation file |
Download
xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.ja.xml
|
| Last change | Dec. 1, 2022, 5:50 a.m. |
| Last author | Suguru Hirahara |
9 days ago
String statistics
| Strings percent | Hosted strings | Words percent | Hosted words | Characters percent | Hosted characters | |
|---|---|---|---|---|---|---|
| Total | 2 | 2,465 | 21,776 | |||
| Translated | 100% | 2 | 100% | 2,465 | 100% | 21,776 |
| Needs editing | 0% | 0 | 0% | 0 | 0% | 0 |
| Read-only | 0% | 0 | 0% | 0 | 0% | 0 |
| Failing checks | 50% | 1 | 1% | 1 | 1% | 16 |
| Strings with suggestions | 0% | 0 | 0% | 0 | 0% | 0 |
| Untranslated strings | 0% | 0 | 0% | 0 | 0% | 0 |
Quick numbers
and previous 30 days
Trends of last 30 days
—
Hosted words
+100%
—
Hosted strings
+100%
—
Translated
+100%
—
Contributors
—
 None
Resource updated |
|
 shirahara
Translation replaced |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
= 編集 =
== リンク == === リンク1.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 1.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[WebHome]}}}|[[ウェブのホーム>>WebHome]] |ラベル付きのリンク|{{{[ラベル>WebHome]}}}|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{<a href="$xwiki.getURL("WebHome")"><strong>太字のラベル</strong></a>}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[Main.WebHome]}}}|[[ウェブのホーム>>Main.WebHome]] |サブウィキへのリンク|{{{[subwiki:Main.WebHome]}}}|[[ウェブのホーム>>xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[ラベル>WebHome>_blank]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|document=スペース.ページ|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[ラベル>スペース.ページ#アンカー]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor=anchor]] |ページの見出しへのリンク|((( {{{[ラベル>スペース.ページ#HMyheading]}}} )))|[[ラベル>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}見出しを追加すると、見出しのタイトルの前に"H"（見出しのH）がついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 1.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションで、オプションを使用する場合は##{ }##の2つの文字のうち1つを追加する必要があります。 {{/info}} リンクの完全なフォーマットは **##[ラベル {> または |}] (リソース) [@interWikiエイリアス] [{> または |} ターゲット]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：完全なリンク参照。これは以下のいずれかを指定できます *** **##プロトコル:パス##**形式の**URI**（例：##http:~/~/xwiki.org##、##mailto~:john@smith.com##） *** **##~[~[ウィキ名:] スペース名のリスト.] (ページ名)##**形式の**ウィキのページ**。例：##WebHome##、##Main.WebHome##、##ウィキ:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しのアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##ターゲット##**：HTMLの##A##リンク要素の##ターゲット##属性に対応する文字列（オプション）。この要素はリンクのレンダリングの際に使用されます。既定ではリンクを現在のウィンドウで開きます。例：##_self##、##_blank## === リンク2.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 2.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[[WebHome]]}}}|[[WebHome]] |ラベル付きのリンク|((( {{{[[ラベル>>WebHome]]}}} {{info}}XWikiシンタックスはリンクのラベルで使用できます。{{/info}} )))|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{[[**太字のラベル**>>WebHome]]}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |サブウィキへのリンク|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[[ラベル>>WebHome||target="_blank"]]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{[[image:スペース2.ページ2@img.png>>スペース1.ページ1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{[[[[image:スペース2.ページ2@img.png||width="26" height="26"]]>>スペース1.ページ1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|{{{[[テキスト>>attach:img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|{{{[[テキスト>>attach:スペース.ページ@img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[[ラベル>>スペース.ページ#anchor]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="anchor"]] |ページの見出しへのリンク|{{{[[ラベル>>スペース.ページ#HMyheading]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="HMyheading"]] |現在のページのアンカーへのリンク|{{{[[ラベル>>#anchor]]}}}|[[ラベル>>||anchor="anchor"]] {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 2.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [@interWikiエイリアス] [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：以下の形式によるリンク参照： *** **URL**：**##プロトコル:~/~/パス##**の形式のURL。例：##http:~/~/xwiki.org##、##https:~/~/svn.xwiki.org/## *** **ウィキのページ**：**##~[~[ウィキ名:] スペース名の一覧.] (ページ名)##** の形式による参照。例：##WebHome##、##Main.WebHome##、##mywiki:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## *** **添付ファイル**：**##attach~: [ウィキのページ名@] (添付ファイル名)##** の形式による参照。例：##attach~:img.png##、##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** 添付ファイルとしてリソースを指示する文字列（必須）。 **** **##ウィキのページ名##**：添付ファイルがあるページを参照する文字列（オプション）。上記の"ウィキのページ"を参照。 **** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。 *** **Eメールアドレス**：**##mailto~: (Eメールアドレス)##** の形式（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## **** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 **** **##Eメールアドレス##**：指定するEメールアドレス。例： "##john@smith.com##" ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション）。例： ##target="~_blank"##（新しいウィンドウで開きます） === リンク2.1 === |=機能|=XWikiシンタックス 2.1|=結果 |##ページA##にある##ページB##への絶対リンク|{{{[[ページA.ページB]]}}}|[[ページB>>]] |現在のページから##ページA##への相対リンク|{{{[[ページA]]}}} or {{{[[.ページA]]}}}|[[ページA>>]] |現在のページから、##ページA##にある##ページB##への相対リンク|{{{[[.ページA.ページB]]}}}|[[ページB>>]] |ラベル付きのリンク|((( {{{[[ラベル>>ページA]]}}} {{info}}XWikiシンタックスはリンクラベルで利用できます。{{/info}} )))|[[ラベル>>]] |ラベルでウィキのシンタックスを使用したリンク|{{{[[**太字のラベル**>>ページA]]}}}|[[**太字のラベル**>>]] |画像のリンク|{{{[[image:ページA@img.png>>ページA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |##ウィキA##の##ページA##にある##ページB##への絶対リンク|{{{[[ウィキA:ページA.ページB]]}}}|[[ページB>>]] |新しいウィンドウで開くリンク|{{{[[ページA||target="_blank"]]}}}|[[ページA>>]] |暗示的なURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |明示的なURLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |明示的なURLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |現在のページの添付ファイルへのリンク|{{{[[attach:img.png]]}}}|[[img.png>>]] |異なるページの添付ファイルへのリンク|{{{[[attach:ページA.ページB@img.png]]}}}|[[img.png>>]] |ページのアンカーへのリンク|{{{[[ページA.ページB||anchor="anchor"]]}}}|[[ページB>>]] |ページの見出しへのリンク|((( {{{[[ページA.ページB||anchor="HMyheading"]]}}} {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} )))|[[ページB>>]] |現在のページのアンカーへのリンク|{{{[[ラベル>>||anchor="anchor"]]}}}|[[ラベル>>]] |クエリー文字列付きのページへのリンク|{{{[[ページA.ページB||queryString="param1=value1¶m2=value2"]]}}}|[[ページB>>]] |クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1¶m2=value2"]]}}}|[[ラベル>>]] {{velocity}}$subHeading XWikiシンタックス 2.1 リンク仕様 $subHeading{{/velocity}} {{info}} 凡例：##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：以下の形式によるリンク参照の文字列（必須） ** **URL**：**##[url:](プロトコル:~/~/パス)##** の形式によるURL。例：##http:~/~/xwiki.org##、##url:https:~/~/svn.xwiki.org/## *** **##url:##** URLとしてリソースを指示する文字列（オプション）。 *** **##プロトコル:~/~/パス##**：URLを指定 ** **ウィキのページ**：**##page:[(ウィキ名):](ページ名の一覧)##** の形式による参照。例：##page:ページ##、##page:myxwiki:ページ##、##page: *** **##page:##** XWikiのページとしてリソースを指示する文字列（必須）。同一の参照をターミナルページとそれ以外のページにも使用できます。もし両方が存在する場合は、ターミナルページ以外のページを指示します。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。リンクはウィキのページに向けられます。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##ページ名の一覧##**：最終的にリンクするuxikino のシンタックスを指示するウィキのページの名称の一覧（必須。スラッシュで分割）。##.##と##..##を使用すると現在のページ、または、 ** **ウィキのドキュメント**：**##[doc:]~[~[(ウィキ名):](スペース名の一覧).](ドキュメント名)##** の形式による参照。例：##doc:Welcome##、##doc:Main.Welcome##、##doc:mywiki:Main.Welcome##、##Welcome## *** **##doc:##** XWikiのターミナルページとしてリソースを指示する文字列（オプション）。 ターミナルページ以外のページを参照できますが、##.WebHome##の部分を付ける必要があります（例：##doc:Sandbox.WebHome##）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ドキュメント名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##Welcome## ** **ウィキのスペース**：**##space:[(ウィキ名):](スペース名の一覧)##** の形式による参照。例：##space:Main##、##space:mywiki:Main##、##space:A.B.C## *** **##space:##** XWikiのターミナルでないページ（スペース）としてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##スペース名の一覧##**：最終的にリンクするスペースを指示するスペースの名称の一覧（必須。ドットで分割）。例：##Main##、##A.B##、##A.B.C## ** **InterWikiのページ**：**##interwiki:[(interWikiエイリアス):](ページ名)##** の形式による参照。例： ##interwiki:wikipedia:XWiki## *** **##interwiki:##** InterWikiリンクとしてリソースを指示する文字列（必須）。 *** **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。例： ##wikipedia## *** **##ページ名##**：リンクするページの名称を含む文字列（必須）。例： ##XWiki## ** **添付ファイル**：**##attach~:~{~{~{(ウィキ名):}(スペース名の一覧).}(ページ名)@}(画像名)##** の形式による参照 *** **##attach~:##** XWikiのドキュメントの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ページ名##**：参照する画像が添付されているウィキのページの名称を含む文字列（オプション）。例： ##Welcome## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **ページの添付ファイル**：**##pageAttach~:~{~{~{(ウィキ名):}(ページ名の一覧)/}(画像名)##** の形式による参照 *** **##pageAttach~:##** XWikiのページの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキが指定されていない場合は、現在のウィキを使用します。例： ##mywiki##。 *** **##ページ名の一覧##**：ドットで分割したウィキのページの名称の一覧（オプション）。ページが指定されていない場合は、現在のページを使用します。例：##Main##、##A/B##、##A/B/C## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **Eメールアドレス**：**##mailto{{{:(}}}Eメールアドレス)##** の形式による参照（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## *** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 *** **##Eメールアドレス##**：指定するEメールアドレス。例： ##john@smith.com## ** **相対パス**：**##path{{{:(}}}相対パス)##** の形式によるサーバー上の参照。例： ##path:$doc.getURL('reset')##はターゲットのアドレス ##http:~/~/server.doMain.com/xwiki/bin/reset/Space/Page## を生成します（ここでは##$doc.getURL('reset')##が##/xwiki/bin/reset/Space/Page##を生成します）。 *** **##path:##** 相対パスとしてリソースを指示する文字列（必須）。 *** **##相対パス##**：リンクするサーバー上のリソースの相対パスを含む文字列（必須）。 ** **UNC（Windowsエクスプローラー）**：**##unc{{{:(}}}パス)##** の形式による参照。リンクは ##file:~/~/## リンクとしてレンダリングされます。例：##unc:C:Windows##、##unc:~~myserverpathimg.png##、##unc:home/user/somefile## *** **##unc:##** UNC（Windowsエクスプローラー）のパスとしてリソースを指示する文字列（必須）。 *** **##パス##**：ユーザーがアクセスできるリソースのローカルパスを含む文字列（必須）。例：##C:Windows##、##~~myserverpathimg.png##、##home/user/somefile## ** **種類の設定がない場合**：以上のリソースのいずれも指定されていない場合（リンクで##type:##リソースの接頭辞が指定されていない場合)、リンクは以下のアルゴリズムを使用して、XWikiのターミナルあるいはターミナルでないページへのリンクとして扱われます： *** 現在のスペースの**##ターミナルページ##**（存在する場合//のみ//）。例： ##~[~[A]]##は##~[~[doc:currentSpace.A]]##と同等に解決されます *** 現在のスペースの**##ターミナル以外のページ##**。例： ##~[~[A]]##は##~[~[space:現在のスペース.A]]##、##~[~[doc:現在のスペース.A.WebHome]]##と同等に解決されます *** もし現在のページがターミナル以外のページで、上記2つに当てはまる既存のページが見つからなかった場合、追加で2つのチェックを行います： **** 親スペースにある同レベルのページとしての**##ターミナルページ##**（存在する場合//のみ//）。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[doc:A.B]]##と同等に解決されます **** 親スペースにある同レベルのページとしての**##ターミナル以外のページ##**。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[space:A.B]]##、##~[~[doc:A.B.WebHome]]##と同等に解決されます *** //注1 - 絶対リンク//: 種類を定めていないリンクがドットで分割した2つ以上のコンポーネントを指定している場合（スペース名とページ名に見えるものになります)、上記のアルゴリズムは、現在のスペースではなく、現在のウィキの相対ページを解決します。例： ##~[~[A.B]]##は##~[~[doc:現在のウィキ:A.B]]##（存在する場合）あるいは##~[~[space:現在のウィキ:A.B]##]（これは##~[~[doc:currentWiki:A.B.WebHome]]##に相当します）を解決し、 ##~[~[doc:現在のウィキ:現在のスペース.A.B]]##または##~[~[doc:現在のウィキ:現在のスペース.A.B.WebHome]]##は解決しません。 *** //注2 - ##.WebHome##の特殊な扱い方//: 種類を定めていないリンクが##.WebHome##で終了する場合、//常に//ターミナルページとして扱います。例： ##~[~[A.WebHome]]##は常に##~[~[doc:A.WebHome]]##と同等に解決し、##~[~[doc:A.WebHome.WebHome]]##は解決しません。 * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション。スペースで分割）。例： ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##クエリー##**：リンクのターゲットアドレスに付けられ、レンダリングするURLで使用されるパラメーターを指定するクエリー文字列（オプション）。例： ##url:http:~/~/doMain.com/path||queryString="mydata1=5&mydata2=Hello"##は、ターゲットのアドレス ##http:~/~/doMain.com/path?mydata1=5&mydata2=Hello## を生成します ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##url:http:~/~/doMain.com/path||anchor="HTableOfContents"##は、ターゲットのアドレス ##http:~/~/doMain.com/path#HTableOfContents## を生成します ** **##ターゲット##**：リンクのターゲットを新しいウィンドウで開くことを可能とするパラメーター（オプション）。例： ##target="~_blank"## |
|
shirahara
Translation replaced |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
= 編集 =
== リンク == === リンク1.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 1.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[WebHome]}}}|[[ウェブのホーム>>WebHome]] |ラベル付きのリンク|{{{[ラベル>WebHome]}}}|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{<a href="$xwiki.getURL("WebHome")"><strong>太字のラベル</strong></a>}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[Main.WebHome]}}}|[[ウェブのホーム>>Main.WebHome]] |サブウィキへのリンク|{{{[subwiki:Main.WebHome]}}}|[[ウェブのホーム>>xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[ラベル>WebHome>_blank]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|document=スペース.ページ|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[ラベル>スペース.ページ#アンカー]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor=anchor]] |ページの見出しへのリンク|((( {{{[ラベル>スペース.ページ#HMyheading]}}} )))|[[ラベル>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}見出しを追加すると、見出しのタイトルの前に"H"（見出しのH）がついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 1.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションで、オプションを使用する場合は##{ }##の2つの文字のうち1つを追加する必要があります。 {{/info}} リンクの完全なフォーマットは **##[ラベル {> または |}] (リソース) [@interWikiエイリアス] [{> または |} ターゲット]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：完全なリンク参照。これは以下のいずれかを指定できます *** **##プロトコル:パス##**形式の**URI**（例：##http:~/~/xwiki.org##、##mailto~:john@smith.com##） *** **##~[~[ウィキ名:] スペース名のリスト.] (ページ名)##**形式の**ウィキのページ**。例：##WebHome##、##Main.WebHome##、##ウィキ:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しのアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##ターゲット##**：HTMLの##A##リンク要素の##ターゲット##属性に対応する文字列（オプション）。この要素はリンクのレンダリングの際に使用されます。既定ではリンクを現在のウィンドウで開きます。例：##_self##、##_blank## === リンク2.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 2.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[[WebHome]]}}}|[[WebHome]] |ラベル付きのリンク|((( {{{[[ラベル>>WebHome]]}}} {{info}}XWikiシンタックスはリンクのラベルで使用できます。{{/info}} )))|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{[[**太字のラベル**>>WebHome]]}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |サブウィキへのリンク|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[[ラベル>>WebHome||target="_blank"]]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{[[image:スペース2.ページ2@img.png>>スペース1.ページ1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{[[[[image:スペース2.ページ2@img.png||width="26" height="26"]]>>スペース1.ページ1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|{{{[[テキスト>>attach:img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|{{{[[テキスト>>attach:スペース.ページ@img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[[ラベル>>スペース.ページ#anchor]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="anchor"]] |ページの見出しへのリンク|{{{[[ラベル>>スペース.ページ#HMyheading]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="HMyheading"]] |現在のページのアンカーへのリンク|{{{[[ラベル>>#anchor]]}}}|[[ラベル>>||anchor="anchor"]] {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 2.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [@interWikiエイリアス] [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：以下の形式によるリンク参照： *** **URL**：**##プロトコル:~/~/パス##**の形式のURL。例：##http:~/~/xwiki.org##、##https:~/~/svn.xwiki.org/## *** **ウィキのページ**：**##~[~[ウィキ名:] スペース名の一覧.] (ページ名)##** の形式による参照。例：##WebHome##、##Main.WebHome##、##mywiki:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## *** **添付ファイル**：**##attach~: [ウィキのページ名@] (添付ファイル名)##** の形式による参照。例：##attach~:img.png##、##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** 添付ファイルとしてリソースを指示する文字列（必須）。 **** **##ウィキのページ名##**：添付ファイルがあるページを参照する文字列（オプション）。上記の"ウィキのページ"を参照。 **** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。 *** **Eメールアドレス**：**##mailto~: (Eメールアドレス)##** の形式（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## **** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 **** **##Eメールアドレス##**：指定するEメールアドレス。例： "##john@smith.com##" ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション）。例： ##target="~_blank"##（新しいウィンドウで開きます） === リンク2.1 === |=機能|=XWikiシンタックス 2.1|=結果 |##ページA##にある##ページB##への絶対リンク|{{{[[ページA.ページB]]}}}|[[ページB>>]] |現在のページから##ページA##への相対リンク|{{{[[ページA]]}}} or {{{[[.ページA]]}}}|[[ページA>>]] |現在のページから、##ページA##にある##ページB##への相対リンク|{{{[[.ページA.ページB]]}}}|[[ページB>>]] |ラベル付きのリンク|((( {{{[[ラベル>>ページA]]}}} {{info}}XWikiシンタックスはリンクラベルで利用できます。{{/info}} )))|[[ラベル>>]] |ラベルでウィキのシンタックスを使用したリンク|{{{[[**太字のラベル**>>ページA]]}}}|[[**太字のラベル**>>]] |画像のリンク|{{{[[image:ページA@img.png>>ページA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |##ウィキA##の##ページA##にある##ページB##への絶対リンク|{{{[[ウィキA:ページA.ページB]]}}}|[[ページB>>]] |新しいウィンドウで開くリンク|{{{[[ページA||target="_blank"]]}}}|[[ページA>>]] |暗示的なURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |明示的なURLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |明示的なURLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |現在のページの添付ファイルへのリンク|{{{[[attach:img.png]]}}}|[[img.png>>]] |異なるページの添付ファイルへのリンク|{{{[[attach:ページA.ページB@img.png]]}}}|[[img.png>>]] |ページのアンカーへのリンク|{{{[[ページA.ページB||anchor="anchor"]]}}}|[[ページB>>]] |ページの見出しへのリンク|((( {{{[[ページA.ページB||anchor="HMyheading"]]}}} {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} )))|[[ページB>>]] |現在のページのアンカーへのリンク|{{{[[ラベル>>||anchor="anchor"]]}}}|[[ラベル>>]] |クエリー文字列付きのページへのリンク|{{{[[ページA.ページB||queryString="param1=value1¶m2=value2"]]}}}|[[ページB>>]] |クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1¶m2=value2"]]}}}|[[ラベル>>]] {{velocity}}$subHeading XWikiシンタックス 2.1 リンク仕様 $subHeading{{/velocity}} {{info}} 凡例：##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：以下の形式によるリンク参照の文字列（必須） ** **URL**：**##[url:](プロトコル:~/~/パス)##** の形式によるURL。例：##http:~/~/xwiki.org##、##url:https:~/~/svn.xwiki.org/## *** **##url:##** URLとしてリソースを指示する文字列（オプション）。 *** **##プロトコル:~/~/パス##**：URLを指定 ** **ウィキのページ**：**##page:[(ウィキ名):](ページ名の一覧)##** の形式による参照。例：##page:ページ##、##page:myxwiki:ページ##、##page:親ページ. *** **##page:##** XWikiのページとしてリソースを指示する文字列（必須）。同一の参照をターミナルページとそれ以外のページにも使用できます。もし両方が存在する場合は、ターミナルページ以外のページを指示します。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。リンクはウィキのページに向けられます。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##ページ名の一覧##**：最終的にリンクするuxikino のシンタックスを指示するウィキのページの名称の一覧（必須。スラッシュで分割）。##.##と##..##を使用すると現在のページ、または、親ページあるいはウィキを指示することもできます。例：##Main##、##A/B##、##A/B/C##、##../同レベルのページ##、##./ ** **ウィキのドキュメント**：**##[doc:]~[~[(ウィキ名):](スペース名の一覧).](ドキュメント名)##** の形式による参照。例：##doc:Welcome##、##doc:Main.Welcome##、##doc:mywiki:Main.Welcome##、##Welcome## *** **##doc:##** XWikiのターミナルページとしてリソースを指示する文字列（オプション）。 ターミナルページ以外のページを参照できますが、##.WebHome##の部分を付ける必要があります（例：##doc:Sandbox.WebHome##）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ドキュメント名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##Welcome## ** **ウィキのスペース**：**##space:[(ウィキ名):](スペース名の一覧)##** の形式による参照。例：##space:Main##、##space:mywiki:Main##、##space:A.B.C## *** **##space:##** XWikiのターミナルでないページ（スペース）としてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##スペース名の一覧##**：最終的にリンクするスペースを指示するスペースの名称の一覧（必須。ドットで分割）。例：##Main##、##A.B##、##A.B.C## ** **InterWikiのページ**：**##interwiki:[(interWikiエイリアス):](ページ名)##** の形式による参照。例： ##interwiki:wikipedia:XWiki## *** **##interwiki:##** InterWikiリンクとしてリソースを指示する文字列（必須）。 *** **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。例： ##wikipedia## *** **##ページ名##**：リンクするページの名称を含む文字列（必須）。例： ##XWiki## ** **添付ファイル**：**##attach~:~{~{~{(ウィキ名):}(スペース名の一覧).}(ページ名)@}(画像名)##** の形式による参照 *** **##attach~:##** XWikiのドキュメントの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ページ名##**：参照する画像が添付されているウィキのページの名称を含む文字列（オプション）。例： ##Welcome## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **ページの添付ファイル**：**##pageAttach~:~{~{~{(ウィキ名):}(ページ名の一覧)/}(画像名)##** の形式による参照 *** **##pageAttach~:##** XWikiのページの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキが指定されていない場合は、現在のウィキを使用します。例： ##mywiki##。 *** **##ページ名の一覧##**：ドットで分割したウィキのページの名称の一覧（オプション）。ページが指定されていない場合は、現在のページを使用します。例：##Main##、##A/B##、##A/B/C## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **Eメールアドレス**：**##mailto{{{:(}}}Eメールアドレス)##** の形式による参照（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## *** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 *** **##Eメールアドレス##**：指定するEメールアドレス。例： ##john@smith.com## ** **相対パス**：**##path{{{:(}}}相対パス)##** の形式によるサーバー上の参照。例： ##path:$doc.getURL('reset')##はターゲットのアドレス ##http:~/~/server.doMain.com/xwiki/bin/reset/Space/Page## を生成します（ここでは##$doc.getURL('reset')##が##/xwiki/bin/reset/Space/Page##を生成します）。 *** **##path:##** 相対パスとしてリソースを指示する文字列（必須）。 *** **##相対パス##**：リンクするサーバー上のリソースの相対パスを含む文字列（必須）。 ** **UNC（Windowsエクスプローラー）**：**##unc{{{:(}}}パス)##** の形式による参照。リンクは ##file:~/~/## リンクとしてレンダリングされます。例：##unc:C:Windows##、##unc:~~myserverpathimg.png##、##unc:home/user/somefile## *** **##unc:##** UNC（Windowsエクスプローラー）のパスとしてリソースを指示する文字列（必須）。 *** **##パス##**：ユーザーがアクセスできるリソースのローカルパスを含む文字列（必須）。例：##C:Windows##、##~~myserverpathimg.png##、##home/user/somefile## ** **種類の設定がない場合**：以上のリソースのいずれも指定されていない場合（リンクで##type:##リソースの接頭辞が指定されていない場合)、リンクは以下のアルゴリズムを使用して、XWikiのターミナルあるいはターミナルでないページへのリンクとして扱われます： *** 現在のスペースの**##ターミナルページ##**（存在する場合//のみ//）。例： ##~[~[A]]##は##~[~[doc:currentSpace.A]]##と同等に解決されます *** 現在のスペースの**##ターミナル以外のページ##**。例： ##~[~[A]]##は##~[~[space:現在のスペース.A]]##、##~[~[doc:現在のスペース.A.WebHome]]##と同等に解決されます *** もし現在のページがターミナル以外のページで、上記2つに当てはまる既存のページが見つからなかった場合、追加で2つのチェックを行います： **** 親スペースにある同レベルのページとしての**##ターミナルページ##**（存在する場合//のみ//）。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[doc:A.B]]##と同等に解決されます **** 親スペースにある同レベルのページとしての**##ターミナル以外のページ##**。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[space:A.B]]##、##~[~[doc:A.B.WebHome]]##と同等に解決されます *** //注1 - 絶対リンク//: 種類を定めていないリンクがドットで分割した2つ以上のコンポーネントを指定している場合（スペース名とページ名に見えるものになります)、上記のアルゴリズムは、現在のスペースではなく、現在のウィキの相対ページを解決します。例： ##~[~[A.B]]##は##~[~[doc:現在のウィキ:A.B]]##（存在する場合）あるいは##~[~[space:現在のウィキ:A.B]##]（これは##~[~[doc:currentWiki:A.B.WebHome]]##に相当します）を解決し、 ##~[~[doc:現在のウィキ:現在のスペース.A.B]]##または##~[~[doc:現在のウィキ:現在のスペース.A.B.WebHome]]##は解決しません。 *** //注2 - ##.WebHome##の特殊な扱い方//: 種類を定めていないリンクが##.WebHome##で終了する場合、//常に//ターミナルページとして扱います。例： ##~[~[A.WebHome]]##は常に##~[~[doc:A.WebHome]]##と同等に解決し、##~[~[doc:A.WebHome.WebHome]]##は解決しません。 * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション。スペースで分割）。例： ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##クエリー##**：リンクのターゲットアドレスに付けられ、レンダリングするURLで使用されるパラメーターを指定するクエリー文字列（オプション）。例： ##url:http:~/~/doMain.com/path||queryString="mydata1=5&mydata2=Hello"##は、ターゲットのアドレス ##http:~/~/doMain.com/path?mydata1=5&mydata2=Hello## を生成します ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##url:http:~/~/doMain.com/path||anchor="HTableOfContents"##は、ターゲットのアドレス ##http:~/~/doMain.com/path#HTableOfContents## を生成します ** **##ターゲット##**：リンクのターゲットを新しいウィンドウで開くことを可能とするパラメーター（オプション）。例： ##target="~_blank"## |
|
shirahara
Translation changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## == リンク == === リンク1.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 1.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[WebHome]}}}|[[ウェブのホーム>>WebHome]] |ラベル付きのリンク|{{{[ラベル>WebHome]}}}|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{<a href="$xwiki.getURL("WebHome")"><strong>太字のラベル</strong></a>}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[Main.WebHome]}}}|[[ウェブのホーム>>Main.WebHome]] |サブウィキへのリンク|{{{[subwiki:Main.WebHome]}}}|[[ウェブのホーム>>xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[ラベル>WebHome>_blank]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|document=スペース.ページ|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[ラベル>スペース.ページ#アンカー]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor=anchor]] |ページの見出しへのリンク|((( {{{[ラベル>スペース.ページ#HMyheading]}}} )))|[[ラベル>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}見出しを追加すると、見出しのタイトルの前に"H"（見出しのH）がついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 1.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションで、オプションを使用する場合は##{ }##の2つの文字のうち1つを追加する必要があります。 {{/info}} リンクの完全なフォーマットは **##[ラベル {> または |}] (リソース) [@interWikiエイリアス] [{> または |} ターゲット]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：完全なリンク参照。これは以下のいずれかを指定できます *** **##プロトコル:パス##**形式の**URI**（例：##http:~/~/xwiki.org##、##mailto~:john@smith.com##） *** **##~[~[ウィキ名:] スペース名のリスト.] (ページ名)##**形式の**ウィキのページ**。例：##WebHome##、##Main.WebHome##、##ウィキ:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しのアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##ターゲット##**：HTMLの##A##リンク要素の##ターゲット##属性に対応する文字列（オプション）。この要素はリンクのレンダリングの際に使用されます。既定ではリンクを現在のウィンドウで開きます。例：##_self##、##_blank## === リンク2.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 2.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[[WebHome]]}}}|[[WebHome]] |ラベル付きのリンク|((( {{{[[ラベル>>WebHome]]}}} {{info}}XWikiシンタックスはリンクのラベルで使用できます。{{/info}} )))|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{[[**太字のラベル**>>WebHome]]}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |サブウィキへのリンク|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[[ラベル>>WebHome||target="_blank"]]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{[[image:スペース2.ページ2@img.png>>スペース1.ページ1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{[[[[image:スペース2.ページ2@img.png||width="26" height="26"]]>>スペース1.ページ1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|{{{[[テキスト>>attach:img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|{{{[[テキスト>>attach:スペース.ページ@img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[[ラベル>>スペース.ページ#anchor]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="anchor"]] |ページの見出しへのリンク|{{{[[ラベル>>スペース.ページ#HMyheading]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="HMyheading"]] |現在のページのアンカーへのリンク|{{{[[ラベル>>#anchor]]}}}|[[ラベル>>||anchor="anchor"]] {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 2.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [@interWikiエイリアス] [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：以下の形式によるリンク参照： *** **URL**：**##プロトコル:~/~/パス##**の形式のURL。例：##http:~/~/xwiki.org##、##https:~/~/svn.xwiki.org/## *** **ウィキのページ**：**##~[~[ウィキ名:] スペース名の一覧.] (ページ名)##** の形式による参照。例：##WebHome##、##Main.WebHome##、##mywiki:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## *** **添付ファイル**：**##attach~: [ウィキのページ名@] (添付ファイル名)##** の形式による参照。例：##attach~:img.png##、##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** 添付ファイルとしてリソースを指示する文字列（必須）。 **** **##ウィキのページ名##**：添付ファイルがあるページを参照する文字列（オプション）。上記の"ウィキのページ"を参照。 **** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。 *** **Eメールアドレス**：**##mailto~: (Eメールアドレス)##** の形式（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## **** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 **** **##Eメールアドレス##**：指定するEメールアドレス。例： "##john@smith.com##" ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション）。例： ##target="~_blank"##（新しいウィンドウで開きます） === リンク2.1 === |=機能|=XWikiシンタックス 2.1|=結果 |##ページA##にある##ページB##への絶対リンク|{{{[[ページA.ページB]]}}}|[[ページB>>]] |現在のページから##ページA##への相対リンク|{{{[[ページA]]}}} or {{{[[.ページA]]}}}|[[ページA>>]] |現在のページから、##ページA##にある##ページB##への相対リンク|{{{[[.ページA.ページB]]}}}|[[ページB>>]] |ラベル付きのリンク|((( {{{[[ラベル>>ページA]]}}} {{info}}XWikiシンタックスはリンクラベルで利用できます。{{/info}} )))|[[ラベル>>]] |ラベルでウィキのシンタックスを使用したリンク|{{{[[**太字のラベル**>>ページA]]}}}|[[**太字のラベル**>>]] |画像のリンク|{{{[[image:ページA@img.png>>ページA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |##ウィキA##の##ページA##にある##ページB##への絶対リンク|{{{[[ウィキA:ページA.ページB]]}}}|[[ページB>>]] |新しいウィンドウで開くリンク|{{{[[ページA||target="_blank"]]}}}|[[ページA>>]] |暗示的なURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |明示的なURLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |明示的なURLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |現在のページの添付ファイルへのリンク|{{{[[attach:img.png]]}}}|[[img.png>>]] |異なるページの添付ファイルへのリンク|{{{[[attach:ページA.ページB@img.png]]}}}|[[img.png>>]] |ページのアンカーへのリンク|{{{[[ページA.ページB||anchor="anchor"]]}}}|[[ページB>>]] |ページの見出しへのリンク|((( {{{[[ページA.ページB||anchor="HMyheading"]]}}} {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} )))|[[ページB>>]] |現在のページのアンカーへのリンク|{{{[[ラベル>>||anchor="anchor"]]}}}|[[ラベル>>]] |クエリー文字列付きのページへのリンク|{{{[[ページA.ページB||queryString="param1=value1¶m2=value2"]]}}}|[[ページB>>]] |クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1¶m2=value2"]]}}}|[[ラベル>>]] {{velocity}}$subHeading XWikiシンタックス 2.1 リンク仕様 $subHeading{{/velocity}} {{info}} 凡例：##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：以下の形式によるリンク参照の文字列（必須） ** **URL**：**##[url:](プロトコル:~/~/パス)##** の形式によるURL。例：##http:~/~/xwiki.org##、##url:https:~/~/svn.xwiki.org/## *** **##url:##** URLとしてリソースを指示する文字列（オプション）。 *** **##プロトコル:~/~/パス##**：URLを指定 ** **ウィキのページ**：**##page:[(ウィキ名):](ページ名の一覧)##** の形式による参照。例：##page:ページ##、##page:myxwiki:ページ##、##page:親ページ.子ページ.サブの子ページ##、##page:../同レベルのページ##、##page:./子ページ## *** **##page:##** XWikiのページとしてリソースを指示する文字列（必須）。同一の参照をターミナルページとそれ以外のページにも使用できます。もし両方が存在する場合は、ターミナルページ以外のページを指示します。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。リンクはウィキのページに向けられます。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##ページ名の一覧##**：最終的にリンクするuxikino のシンタックスを指示するウィキのページの名称の一覧（必須。スラッシュで分割）。##.##と##..##を使用すると現在のページ、または、親ページあるいはウィキを指示することもできます。例：##Main##、##A/B##、##A/B/C##、##../同レベルのページ##、##./子ページ## ** **ウィキのドキュメント**：**##[doc:]~[~[(ウィキ名):](スペース名の一覧).](ドキュメント名)##** の形式による参照。例：##doc:Welcome##、##doc:Main.Welcome##、##doc:mywiki:Main.Welcome##、##Welcome## *** **##doc:##** XWikiのターミナルページとしてリソースを指示する文字列（オプション）。 ターミナルページ以外のページを参照できますが、##.WebHome##の部分を付ける必要があります（例：##doc:Sandbox.WebHome##）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ドキュメント名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##Welcome## ** **ウィキのスペース**：**##space:[(ウィキ名):](スペース名の一覧)##** の形式による参照。例：##space:Main##、##space:mywiki:Main##、##space:A.B.C## *** **##space:##** XWikiのターミナルでないページ（スペース）としてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##スペース名の一覧##**：最終的にリンクするスペースを指示するスペースの名称の一覧（必須。ドットで分割）。例：##Main##、##A.B##、##A.B.C## ** **InterWikiのページ**：**##interwiki:[(interWikiエイリアス):](ページ名)##** の形式による参照。例： ##interwiki:wikipedia:XWiki## *** **##interwiki:##** InterWikiリンクとしてリソースを指示する文字列（必須）。 *** **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。例： ##wikipedia## *** **##ページ名##**：リンクするページの名称を含む文字列（必須）。例： ##XWiki## ** **添付ファイル**：**##attach~:~{~{~{(ウィキ名):}(スペース名の一覧).}(ページ名)@}(画像名)##** の形式による参照 *** **##attach~:##** XWikiのドキュメントの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**：ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ページ名##**：参照する画像が添付されているウィキのページの名称を含む文字列（オプション）。例： ##Welcome## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **ページの添付ファイル**：**##pageAttach~:~{~{~{(ウィキ名):}(ページ名の一覧)/}(画像名)##** の形式による参照 *** **##pageAttach~:##** XWikiのページの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキが指定されていない場合は、現在のウィキを使用します。例： ##mywiki##。 *** **##ページ名の一覧##**：ドットで分割したウィキのページの名称の一覧（オプション）。ページが指定されていない場合は、現在のページを使用します。例：##Main##、##A/B##、##A/B/C## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **Eメールアドレス**：**##mailto{{{:(}}}Eメールアドレス)##** の形式による参照（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## *** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 *** **##Eメールアドレス##**：指定するEメールアドレス。例： ##john@smith.com## ** **相対パス**：**##path{{{:(}}}相対パス)##** の形式によるサーバー上の参照。例： ##path:$doc.getURL('reset')##はターゲットのアドレス ##http:~/~/server.doMain.com/xwiki/bin/reset/Space/Page## を生成します（ここでは##$doc.getURL('reset')##が##/xwiki/bin/reset/Space/Page##を生成します）。 *** **##path:##** 相対パスとしてリソースを指示する文字列（必須）。 *** **##相対パス##**：リンクするサーバー上のリソースの相対パスを含む文字列（必須）。 ** **UNC（Windowsエクスプローラー）**：**##unc{{{:(}}}パス)##** の形式による参照。リンクは ##file:~/~/## リンクとしてレンダリングされます。例：##unc:C:Windows##、##unc:~~myserverpathimg.png##、##unc:home/user/somefile## *** **##unc:##** UNC（Windowsエクスプローラー）のパスとしてリソースを指示する文字列（必須）。 *** **##パス##**：ユーザーがアクセスできるリソースのローカルパスを含む文字列（必須）。例：##C:Windows##、##~~myserverpathimg.png##、##home/user/somefile## ** **種類の設定がない場合**：以上のリソースのいずれも指定されていない場合（リンクで##type:##リソースの接頭辞が指定されていない場合)、リンクは以下のアルゴリズムを使用して、XWikiのターミナルあるいはターミナルでないページへのリンクとして扱われます： *** 現在のスペースの**##ターミナルページ##**（存在する場合//のみ//）。例： ##~[~[A]]##は##~[~[doc:currentSpace.A]]##と同等に解決されます *** 現在のスペースの**##ターミナル以外のページ##**。例： ##~[~[A]]##は##~[~[space:現在のスペース.A]]##、##~[~[doc:現在のスペース.A.WebHome]]##と同等に解決されます *** もし現在のページがターミナル以外のページで、上記2つに当てはまる既存のページが見つからなかった場合、追加で2つのチェックを行います： **** 親スペースにある同レベルのページとしての**##ターミナルページ##**（存在する場合//のみ//）。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[doc:A.B]]##と同等に解決されます **** 親スペースにある同レベルのページとしての**##ターミナル以外のページ##**。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[space:A.B]]##、##~[~[doc:A.B.WebHome]]##と同等に解決されます *** //注1 - 絶対リンク//: 種類を定めていないリンクがドットで分割した2つ以上のコンポーネントを指定している場合（スペース名とページ名に見えるものになります)、上記のアルゴリズムは、現在のスペースではなく、現在のウィキの相対ページを解決します。例： ##~[~[A.B]]##は##~[~[doc:現在のウィキ:A.B]]##（存在する場合）あるいは##~[~[space:現在のウィキ:A.B]##]（これは##~[~[doc:currentWiki:A.B.WebHome]]##に相当します）を解決し、 ##~[~[doc:現在のウィキ:現在のスペース.A.B]]##または##~[~[doc:現在のウィキ:現在のスペース.A.B.WebHome]]##は解決しません。 *** //注2 - ##.WebHome##の特殊な扱い方//: 種類を定めていないリンクが##.WebHome##で終了する場合、//常に//ターミナルページとして扱います。例： ##~[~[A.WebHome]]##は常に##~[~[doc:A.WebHome]]##と同等に解決し、##~[~[doc:A.WebHome.WebHome]]##は解決しません。 * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション。スペースで分割）。例： ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##クエリー##**：リンクのターゲットアドレスに付けられ、レンダリングするURLで使用されるパラメーターを指定するクエリー文字列（オプション）。例： ##url:http:~/~/doMain.com/path||queryString="mydata1=5&mydata2=Hello"##は、ターゲットのアドレス ##http:~/~/doMain.com/path?mydata1=5&mydata2=Hello## を生成します ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##url:http:~/~/doMain.com/path||anchor="HTableOfContents"##は、ターゲットのアドレス ##http:~/~/doMain.com/path#HTableOfContents## を生成します ** **##ターゲット##**：リンクのターゲットを新しいウィンドウで開くことを可能とするパラメーター（オプション）。例： ##target="~_blank"## |
|
shirahara
Translation changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
ページA= 編集 =
== リンク == === リンク1.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 1.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[WebHome]}}}|[[ウェブのホーム>>WebHome]] |ラベル付きのリンク|{{{[ラベル>WebHome]}}}|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{<a href="$xwiki.getURL("WebHome")"><strong>太字のラベル</strong></a>}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[Main.WebHome]}}}|[[ウェブのホーム>>Main.WebHome]] |サブウィキへのリンク|{{{[subwiki:Main.WebHome]}}}|[[ウェブのホーム>>xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[ラベル>WebHome>_blank]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|document=スペース.ページ|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[ラベル>スペース.ページ#アンカー]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor=anchor]] |ページの見出しへのリンク|((( {{{[ラベル>スペース.ページ#HMyheading]}}} )))|[[ラベル>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}見出しを追加すると、見出しのタイトルの前に"H"（見出しのH）がついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 1.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションで、オプションを使用する場合は##{ }##の2つの文字のうち1つを追加する必要があります。 {{/info}} リンクの完全なフォーマットは **##[ラベル {> または |}] (リソース) [@interWikiエイリアス] [{> または |} ターゲット]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：完全なリンク参照。これは以下のいずれかを指定できます *** **##プロトコル:パス##**形式の**URI**（例：##http:~/~/xwiki.org##、##mailto~:john@smith.com##） *** **##~[~[ウィキ名:] スペース名のリスト.] (ページ名)##**形式の**ウィキのページ**。例：##WebHome##、##Main.WebHome##、##ウィキ:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##** **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しのアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##ターゲット##**：HTMLの##A##リンク要素の##ターゲット##属性に対応する文字列（オプション）。この要素はリンクのレンダリングの際に使用されます。既定ではリンクを現在のウィンドウで開きます。例：##_self##、##_blank## === リンク2.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 2.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[[WebHome]]}}}|[[WebHome]] |ラベル付きのリンク|((( {{{[[ラベル>>WebHome]]}}} {{info}}XWikiシンタックスはリンクのラベルで使用できます。{{/info}} )))|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{[[**太字のラベル**>>WebHome]]}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |サブウィキへのリンク|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[[ラベル>>WebHome||target="_blank"]]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{[[image:スペース2.ページ2@img.png>>スペース1.ページ1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{[[[[image:スペース2.ページ2@img.png||width="26" height="26"]]>>スペース1.ページ1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|{{{[[テキスト>>attach:img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|{{{[[テキスト>>attach:スペース.ページ@img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[[ラベル>>スペース.ページ#anchor]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="anchor"]] |ページの見出しへのリンク|{{{[[ラベル>>スペース.ページ#HMyheading]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="HMyheading"]] |現在のページのアンカーへのリンク|{{{[[ラベル>>#anchor]]}}}|[[ラベル>>||anchor="anchor"]] {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 2.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [@interWikiエイリアス] [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：以下の形式によるリンク参照： *** **URL**：**##プロトコル:~/~/パス##**の形式のURL。例：##http:~/~/xwiki.org##、##https:~/~/svn.xwiki.org/## *** **ウィキのページ**：**##~[~[ウィキ名:] スペース名の一覧.] (ページ名)##** の形式による参照。例：##WebHome##、##Main.WebHome##、##mywiki:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##** **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## *** **添付ファイル**：**##attach~: [ウィキのページ名@] (添付ファイル名)##** の形式による参照。例：##attach~:img.png##、##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** 添付ファイルとしてリソースを指示する文字列（必須）。 **** **##ウィキのページ名##**：添付ファイルがあるページを参照する文字列（オプション）。上記の"ウィキのページ"を参照。 **** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。 *** **Eメールアドレス**：**##mailto~: (Eメールアドレス)##** の形式（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## **** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 **** **##Eメールアドレス##**：指定するEメールアドレス。例： "##john@smith.com##" ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション）。例： ##target="~_blank"##（新しいウィンドウで開きます） === リンク2.1 === |=機能|=XWikiシンタックス 2.1|=結果 |##ページA##にある##ページB##への絶対リンク|{{{[[ページA.ページB]]}}}|[[ページB>>]] |現在のページから##ページA##への相対リンク|{{{[[ページA]]}}} or {{{[[.ページA]]}}}|[[ページA>>]] |現在のページから、##ページA##にある##ページB##への相対リンク|{{{[[.ページA.ページB]]}}}|[[ページB>>]] |ラベル付きのリンク|((( {{{[[ラベル>>ページA]]}}} {{info}}XWikiシンタックスはリンクラベルで利用できます。{{/info}} )))|[[ラベル>>]] |ラベルでウィキのシンタックスを使用したリンク|{{{[[**太字のラベル**>>ページA]]}}}|[[**太字のラベル**>>]] |画像のリンク|{{{[[image:ページA@img.png>>ページA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |##ウィキA##の##ページA##にある##ページB##への絶対リンク|{{{[[ウィキA:ページA.ページB]]}}}|[[ページB>>]] |新しいウィンドウで開くリンク|{{{[[ページA||target="_blank"]]}}}|[[ページA>>]] |暗示的なURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |明示的なURLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |明示的なURLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |現在のページの添付ファイルへのリンク|{{{[[attach:img.png]]}}}|[[img.png>>]] |異なるページの添付ファイルへのリンク|{{{[[attach:ページA.ページB@img.png]]}}}|[[img.png>>]] |ページのアンカーへのリンク|{{{[[ページA.ページB||anchor="anchor"]]}}}|[[ページB>>]] |ページの見出しへのリンク|((( {{{[[ページA.ページB||anchor="HMyheading"]]}}} {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} )))|[[ページB>>]] |現在のページのアンカーへのリンク|{{{[[ラベル>>||anchor="anchor"]]}}}|[[ラベル>>]] |クエリー文字列付きのページへのリンク|{{{[[ページA.ページB||queryString="param1=value1¶m2=value2"]]}}}|[[ページB>>]] |クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1¶m2=value2"]]}}}|[[ラベル>>]] {{velocity}}$subHeading XWikiシンタックス 2.1 リンク仕様 $subHeading{{/velocity}} {{info}} 凡例：##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：以下の形式によるリンク参照の文字列（必須） ** **URL**：**##[url:](プロトコル:~/~/パス)##** の形式によるURL。例：##http:~/~/xwiki.org##、##url:https:~/~/svn.xwiki.org/## *** **##url:##** URLとしてリソースを指示する文字列（オプション）。 *** **##プロトコル:~/~/パス##**：URLを指定 ** **ウィキのページ**：**##page:[(ウィキ名):](ページ名の一覧)##** の形式による参照。例：##page:ページ##、##page:myxwiki:ページ##、##page:親ページ.子ページ.サブの子ページ##、##page:../同レベルのページ##、##page:./子ページ## *** **##page:##** XWikiのページとしてリソースを指示する文字列（必須）。同一の参照をターミナルページとそれ以外のページにも使用できます。もし両方が存在する場合は、ターミナルページ以外のページを指示します。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。リンクはウィキのページに向けられます。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##ページ名の一覧##**：最終的にリンクするuxikino のシンタックスを指示するウィキのページの名称の一覧（必須。スラッシュで分割）。##.##と##..##を使用すると現在のページ、または、親ページあるいはウィキを指示することもできます。例：##Main##、##A/B##、##A/B/C##、##../同レベルのページ##、##./子ページ## ** **ウィキのドキュメント**：**##[doc:]~[~[(ウィキ名):](スペース名の一覧).](ドキュメント名)##** の形式による参照。例：##doc:Welcome##、##doc:Main.Welcome##、##doc:mywiki:Main.Welcome##、##Welcome## *** **##doc:##** XWikiのターミナルページとしてリソースを指示する文字列（オプション）。 ターミナルページ以外のページを参照できますが、##.WebHome##の部分を付ける必要があります（例：##doc:Sandbox.WebHome##）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##** *** **##ドキュメント名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##Welcome## ** **ウィキのスペース**：**##space:[(ウィキ名):](スペース名の一覧)##** の形式による参照。例：##space:Main##、##space:mywiki:Main##、##space:A.B.C## *** **##space:##** XWikiのターミナルでないページ（スペース）としてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##スペース名の一覧##**：最終的にリンクするスペースを指示するスペースの名称の一覧（必須。ドットで分割）。例：##Main##、##A.B##、##A.B.C## ** **InterWikiのページ**：**##interwiki:[(interWikiエイリアス):](ページ名)##** の形式による参照。例： ##interwiki:wikipedia:XWiki## *** **##interwiki:##** InterWikiリンクとしてリソースを指示する文字列（必須）。 *** **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。例： ##wikipedia## *** **##ページ名##**：リンクするページの名称を含む文字列（必須）。例： ##XWiki## ** **添付ファイル**：**##attach~:~{~{~{(ウィキ名):}(スペース名の一覧).}(ページ名)@}(画像名)##** の形式による参照 *** **##attach~:##** XWikiのドキュメントの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##** *** **##ページ名##**：参照する画像が添付されているウィキのページの名称を含む文字列（オプション）。例： ##Welcome## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **ページの添付ファイル**：**##pageAttach~:~{~{~{(ウィキ名):}(ページ名の一覧)/}(画像名)##** の形式による参照 *** **##pageAttach~:##** XWikiのページの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキが指定されていない場合は、現在のウィキを使用します。例： ##mywiki##。 *** **##ページ名の一覧##**：ドットで分割したウィキのページの名称の一覧（オプション）。ページが指定されていない場合は、現在のページを使用します。例：##Main##、##A/B##、##A/B/C## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **Eメールアドレス**：**##mailto{{{:(}}}Eメールアドレス)##** の形式による参照（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## *** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 *** **##Eメールアドレス##**：指定するEメールアドレス。例： ##john@smith.com## ** **相対パス**：**##path{{{:(}}}相対パス)##** の形式によるサーバー上の参照。例： ##path:$doc.getURL('reset')##はターゲットのアドレス ##http:~/~/server.doMain.com/xwiki/bin/reset/Space/Page## を生成します（ここでは##$doc.getURL('reset')##が##/xwiki/bin/reset/Space/Page##を生成します）。 *** **##path:##** 相対パスとしてリソースを指示する文字列（必須）。 *** **##相対パス##**：リンクするサーバー上のリソースの相対パスを含む文字列（必須）。 ** **UNC（Windowsエクスプローラー）**：**##unc{{{:(}}}パス)##** の形式による参照。リンクは ##file:~/~/## リンクとしてレンダリングされます。例：##unc:C:Windows##、##unc:~~myserverpathimg.png##、##unc:home/user/somefile## *** **##unc:##** UNC（Windowsエクスプローラー）のパスとしてリソースを指示する文字列（必須）。 *** **##パス##**：ユーザーがアクセスできるリソースのローカルパスを含む文字列（必須）。例：##C:Windows##、##~~myserverpathimg.png##、##home/user/somefile## ** **種類の設定がない場合**：以上のリソースのいずれも指定されていない場合（リンクで##type:##リソースの接頭辞が指定されていない場合)、リンクは以下のアルゴリズムを使用して、XWikiのターミナルあるいはターミナルでないページへのリンクとして扱われます： *** 現在のスペースの**##ターミナルページ##**（存在する場合//のみ//）。例： ##~[~[A]]##は##~[~[doc:currentSpace.A]]##と同等に解決されます *** 現在のスペースの**##ターミナル以外のページ##**。例： ##~[~[A]]##は##~[~[space:現在のスペース.A]]##、##~[~[doc:現在のスペース.A.WebHome]]##と同等に解決されます *** もし現在のページがターミナル以外のページで、上記2つに当てはまる既存のページが見つからなかった場合、追加で2つのチェックを行います： **** 親スペースにある同レベルのページとしての**##ターミナルページ##**（存在する場合//のみ//）。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[doc:A.B]]##と同等に解決されます **** 親スペースにある同レベルのページとしての**##ターミナル以外のページ##**。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[space:A.B]]##、##~[~[doc:A.B.WebHome]]##と同等に解決されます *** //注1 - 絶対リンク//: 種類を定めていないリンクがドットで分割した2つ以上のコンポーネントを指定している場合（スペース名とページ名に見えるものになります)、上記のアルゴリズムは、現在のスペースではなく、現在のウィキの相対ページを解決します。例： ##~[~[A.B]]##は##~[~[doc:現在のウィキ:A.B]]##（存在する場合）あるいは##~[~[space:現在のウィキ:A.B]##]（これは##~[~[doc:currentWiki:A.B.WebHome]]##に相当します）を解決し、 ##~[~[doc:現在のウィキ:現在のスペース.A.B]]##または##~[~[doc:現在のウィキ:現在のスペース.A.B.WebHome]]##は解決しません。 *** //注2 - ##.WebHome##の特殊な扱い方//: 種類を定めていないリンクが##.WebHome##で終了する場合、//常に//ターミナルページとして扱います。例： ##~[~[A.WebHome]]##は常に##~[~[doc:A.WebHome]]##と同等に解決し、##~[~[doc:A.WebHome.WebHome]]##は解決しません。 * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション。スペースで分割）。例： ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##クエリー##**：リンクのターゲットアドレスに付けられ、レンダリングするURLで使用されるパラメーターを指定するクエリー文字列（オプション）。例： ##url:http:~/~/doMain.com/path||queryString="mydata1=5&mydata2=Hello"##は、ターゲットのアドレス ##http:~/~/doMain.com/path?mydata1=5&mydata2=Hello## を生成します ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##url:http:~/~/doMain.com/path||anchor="HTableOfContents"##は、ターゲットのアドレス ##http:~/~/doMain.com/path#HTableOfContents## を生成します ** **##ターゲット##**：リンクのターゲットを新しいウィンドウで開くことを可能とするパラメーター（オプション）。例： ##target="~_blank"## |
|
shirahara
Translation changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## == Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: == リンク == === リンク1.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 1.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[WebHome]}}}|[[ウェブのホーム>>WebHome]] |ラベル付きのリンク|{{{[ラベル>WebHome]}}}|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{<a href="$xwiki.getURL("WebHome")"><strong>太字のラベル</strong></a>}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[Main.WebHome]}}}|[[ウェブのホーム>>Main.WebHome]] |サブウィキへのリンク|{{{[subwiki:Main.WebHome]}}}|[[ウェブのホーム>>xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[ラベル>WebHome>_blank]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{<a href="$xwiki.getURL("スペース1.ページ1")">{image:img.png|document=スペース2.ページ2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|((( {{info}}詳細は[[添付マクロ>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]]を確認してください{{/info}} {{{{attach:text|document=スペース.ページ|file=img.png}}}} )))|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[ラベル>スペース.ページ#アンカー]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor=anchor]] |ページの見出しへのリンク|((( {{{[ラベル>スペース.ページ#HMyheading]}}} )))|[[ラベル>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}見出しを追加すると、見出しのタイトルの前に"H"（見出しのH）がついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 1.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションで、オプションを使用する場合は##{ }##の2つの文字のうち1つを追加する必要があります。 {{/info}} リンクの完全なフォーマットは **##[ラベル {> または |}] (リソース) [@interWikiエイリアス] [{> または |} ターゲット]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：完全なリンク参照。これは以下のいずれかを指定できます *** **##プロトコル:パス##**形式の**URI**（例：##http:~/~/xwiki.org##、##mailto~:john@smith.com##） *** **##~[~[ウィキ名:] スペース名のリスト.] (ページ名)##**形式の**ウィキのページ**。例：##WebHome##、##Main.WebHome##、##ウィキ:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**:ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しのアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##ターゲット##**：HTMLの##A##リンク要素の##ターゲット##属性に対応する文字列（オプション）。この要素はリンクのレンダリングの際に使用されます。既定ではリンクを現在のウィンドウで開きます。例：##_self##、##_blank## === リンク2.0 === |=(% style="width:20%" %)機能|=XWikiシンタックス 2.0|=(% style="width:20%" %)結果 |現在のスペースのページへのリンク|{{{[[WebHome]]}}}|[[WebHome]] |ラベル付きのリンク|((( {{{[[ラベル>>WebHome]]}}} {{info}}XWikiシンタックスはリンクのラベルで使用できます。{{/info}} )))|[[ラベル>>WebHome]] |ラベルにXWikiシンタックスをもつリンク|{{{[[**太字のラベル**>>WebHome]]}}}|[[**太字のラベル**>>WebHome]] |指定したスペースのページへのリンク|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |サブウィキへのリンク|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |新しいウィンドウで開くリンク|{{{[[ラベル>>WebHome||target="_blank"]]}}}|[[ラベル>>WebHome||target="_blank"]] |テキスト内のURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |URLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |URLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |画像リンク|{{{[[image:スペース2.ページ2@img.png>>スペース1.ページ1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |パラメーター付きの画像リンク|{{{[[[[image:スペース2.ページ2@img.png||width="26" height="26"]]>>スペース1.ページ1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |現在のページの添付ファイルへのリンク|{{{[[テキスト>>attach:img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |異なるページの添付ファイルへのリンク|{{{[[テキスト>>attach:スペース.ページ@img.png]]}}}|[[テキスト>>attach:XWiki.XWikiSyntaxLinks@img.png]] |ページのアンカーへのリンク|{{{[[ラベル>>スペース.ページ#anchor]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="anchor"]] |ページの見出しへのリンク|{{{[[ラベル>>スペース.ページ#HMyheading]]}}}|[[ラベル>>XWiki.XWikiSyntax||anchor="HMyheading"]] |現在のページのアンカーへのリンク|{{{[[ラベル>>#anchor]]}}}|[[ラベル>>||anchor="anchor"]] {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} {{velocity}}$subHeading XWikiシンタックス 2.0 リンク仕様 $subHeading{{/velocity}} {{info}} ##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [@interWikiエイリアス] [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：完全なリンク参照は次のシンタックスで設定できます： **##(参照) [?クエリー] [#アンカー]##** ** **##参照##**：以下の形式によるリンク参照： *** **URL**：**##プロトコル:~/~/パス##**の形式のURL。例：##http:~/~/xwiki.org##、##https:~/~/svn.xwiki.org/## *** **ウィキのページ**：**##~[~[ウィキ名:] スペース名の一覧.] (ページ名)##** の形式による参照。例：##WebHome##、##Main.WebHome##、##mywiki:Main.WebHome## **** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。例： ##mywiki## **** **##スペース名の一覧##**:ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## **** **##ページ名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##WebHome## *** **添付ファイル**：**##attach~: [ウィキのページ名@] (添付ファイル名)##** の形式による参照。例：##attach~:img.png##、##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** 添付ファイルとしてリソースを指示する文字列（必須）。 **** **##ウィキのページ名##**：添付ファイルがあるページを参照する文字列（オプション）。上記の"ウィキのページ"を参照。 **** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。 *** **Eメールアドレス**：**##mailto~: (Eメールアドレス)##** の形式（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## **** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 **** **##Eメールアドレス##**：指定するEメールアドレス。例： "##john@smith.com##" ** **##クエリー##**：レンダリングするURLで使用するパラメーターを指定するクエリー（オプション）。例： ##mydata1=5&mydata2=Hello## ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##HTableOfContents## * **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。これはウィキのページの名称にのみ有効です。例： ##wikipedia## * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション）。例： ##target="~_blank"##（新しいウィンドウで開きます） === リンク2.1 === |=機能|=XWikiシンタックス 2.1|=結果 |##ページA##にある##ページB##への絶対リンク|{{{[[ページA.ページB]]}}}|[[ページB>>]] |現在のページから##ページA##への相対リンク|{{{[[ページA]]}}} or {{{[[.ページA]]}}}|[[ページA>>]] |現在のページから、##ページA##にある##ページB##への相対リンク|{{{[[.ページA.ページB]]}}}|[[ページB>>]] |ラベル付きのリンク|((( {{{[[ラベル>>ページA]]}}} {{info}}XWikiシンタックスはリンクラベルで利用できます。{{/info}} )))|[[ラベル>>]] |ラベルでウィキのシンタックスを使用したリンク|{{{[[**太字のラベル**>>ページA]]}}}|[[**太字のラベル**>>]] |画像のリンク|{{{[[image:ページA@img.png>>ページA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |##ウィキA##の##ページA##にある##ページB##への絶対リンク|{{{[[ウィキA:ページA.ページB]]}}}|[[ページB>>]] |新しいウィンドウで開くリンク|{{{[[ページA||target="_blank"]]}}}|[[ページA>>]] |暗示的なURLへのリンク|{{{これはURLです: https://xwiki.org}}}|これはURLです: https://xwiki.org |明示的なURLへのリンク|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |明示的なURLへのラベル付きのリンク|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Eメールアドレスへのリンク|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |現在のページの添付ファイルへのリンク|{{{[[attach:img.png]]}}}|[[img.png>>]] |異なるページの添付ファイルへのリンク|{{{[[attach:ページA.ページB@img.png]]}}}|[[img.png>>]] |ページのアンカーへのリンク|{{{[[ページA.ページB||anchor="anchor"]]}}}|[[ページB>>]] |ページの見出しへのリンク|((( {{{[[ページA.ページB||anchor="HMyheading"]]}}} {{info}}見出しを追加するとき、"H"（見出しのH）と、アルファベットによる見出しのタイトルがついたアンカーが作成されます。例えば、"My heading"という見出しには、"HMyheading"というアンカーが作成されます。{{/info}} )))|[[ページB>>]] |現在のページのアンカーへのリンク|{{{[[ラベル>>||anchor="anchor"]]}}}|[[ラベル>>]] |クエリー文字列付きのページへのリンク|{{{[[ページA.ページB||queryString="param1=value1¶m2=value2"]]}}}|[[ページB>>]] |クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1¶m2=value2"]]}}}|[[ラベル>>]] {{velocity}}$subHeading XWikiシンタックス 2.1 リンク仕様 $subHeading{{/velocity}} {{info}} 凡例：##( )##は必須です。##[ ]##はオプションです。 {{/info}} リンクの完全なフォーマットは **##[ラベル>>] (リソース) [||パラメーター]##** となります。 * **##ラベル##**：描写時にリンク名としてユーザーに表示される文字列です（オプション）。ラベルにはXWikiシンタックスを含めることができます。ラベルの指定がなければ、既定のラベルを生成します。生成のパターンは変更できます。[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください。例： ##マイページ## * **##リソース##**：以下の形式によるリンク参照の文字列（必須） ** **URL**：**##[url:](プロトコル:~/~/パス)##** の形式によるURL。例：##http:~/~/xwiki.org##、##url:https:~/~/svn.xwiki.org/## *** **##url:##** URLとしてリソースを指示する文字列（オプション）。 *** **##プロトコル:~/~/パス##**：URLを指定 ** **ウィキのページ**：**##page:[(ウィキ名):](ページ名の一覧)##** の形式による参照。例：##page:ページ##、##page:myxwiki:ページ##、##page:親ページ.子ページ.サブの子ページ##、##page:../同レベルのページ##、##page:./子ページ## *** **##page:##** XWikiのページとしてリソースを指示する文字列（必須）。同一の参照をターミナルページとそれ以外のページにも使用できます。もし両方が存在する場合は、ターミナルページ以外のページを指示します。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。リンクはウィキのページに向けられます。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##ページ名の一覧##**：最終的にリンクするuxikino のシンタックスを指示するウィキのページの名称の一覧（必須。スラッシュで分割）。##.##と##..##を使用すると現在のページ、または、親ページあるいはウィキを指示することもできます。例：##Main##、##A/B##、##A/B/C##、##../同レベルのページ##、##./子ページ## ** **ウィキのドキュメント**：**##[doc:]~[~[(ウィキ名):](スペース名の一覧).](ドキュメント名)##** の形式による参照。例：##doc:Welcome##、##doc:Main.Welcome##、##doc:mywiki:Main.Welcome##、##Welcome## *** **##doc:##** XWikiのターミナルページとしてリソースを指示する文字列（オプション）。 ターミナルページ以外のページを参照できますが、##.WebHome##の部分を付ける必要があります（例：##doc:Sandbox.WebHome##）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**:ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ドキュメント名##**：リンクしたウィキのページの名称を含む文字列（必須）。例： ##Welcome## ** **ウィキのスペース**：**##space:[(ウィキ名):](スペース名の一覧)##** の形式による参照。例：##space:Main##、##space:mywiki:Main##、##space:A.B.C## *** **##space:##** XWikiのターミナルでないページ（スペース）としてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。そのウィキのページにリンクします。 ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki## *** **##スペース名の一覧##**：最終的にリンクするスペースを指示するスペースの名称の一覧（必須。ドットで分割）。例：##Main##、##A.B##、##A.B.C## ** **InterWikiのページ**：**##interwiki:[(interWikiエイリアス):](ページ名)##** の形式による参照。例： ##interwiki:wikipedia:XWiki## *** **##interwiki:##** InterWikiリンクとしてリソースを指示する文字列（必須）。 *** **##interWikiエイリアス##**：InterWikiマップで規定されている[[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]]のエイリアス（オプション。[[管理者ガイド>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]を参照してください）。例： ##wikipedia## *** **##ページ名##**：リンクするページの名称を含む文字列（必須）。例： ##XWiki## ** **添付ファイル**：**##attach~:~{~{~{(ウィキ名):}(スペース名の一覧).}(ページ名)@}(画像名)##** の形式による参照 *** **##attach~:##** XWikiのドキュメントの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキの指定がなければ、現在のウィキを使用します。例： ##mywiki##。 *** **##スペース名の一覧##**:ドットで分割したスペース名のリスト（オプション）。指定がなければ現在のスペースを使用します。例：##Main##、##A.B##、##A.B.C## *** **##ページ名##**：参照する画像が添付されているウィキのページの名称を含む文字列（オプション）。例： ##Welcome## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **ページの添付ファイル**：**##pageAttach~:~{~{~{(ウィキ名):}(ページ名の一覧)/}(画像名)##** の形式による参照 *** **##pageAttach~:##** XWikiのページの添付ファイルとしてリソースを指示する文字列（必須）。 *** **##ウィキ名##**：ウィキの名称を含む文字列（オプション）。 ウィキのページに添付する画像を指示する参照。ウィキが指定されていない場合は、現在のウィキを使用します。例： ##mywiki##。 *** **##ページ名の一覧##**：ドットで分割したウィキのページの名称の一覧（オプション）。ページが指定されていない場合は、現在のページを使用します。例：##Main##、##A/B##、##A/B/C## *** **##添付ファイル名##**：ウィキに保存されている添付ファイルの名称。例： ##photo.png## ** **Eメールアドレス**：**##mailto{{{:(}}}Eメールアドレス)##** の形式による参照（###アンカー##は有効ではありません）。例： ##mailto~:john@smith.com## *** **##mailto~:##** Eメールとしてリソースを指示する文字列（必須）。 *** **##Eメールアドレス##**：指定するEメールアドレス。例： ##john@smith.com## ** **相対パス**：**##path{{{:(}}}相対パス)##** の形式によるサーバー上の参照。例： ##path:$doc.getURL('reset')##はターゲットのアドレス ##http:~/~/server.doMain.com/xwiki/bin/reset/Space/Page## を生成します（ここでは##$doc.getURL('reset')##が##/xwiki/bin/reset/Space/Page##を生成します）。 *** **##path:##** 相対パスとしてリソースを指示する文字列（必須）。 *** **##相対パス##**：リンクするサーバー上のリソースの相対パスを含む文字列（必須）。 ** **UNC（Windowsエクスプローラー）**：**##unc{{{:(}}}パス)##** の形式による参照。リンクは ##file:~/~/## リンクとしてレンダリングされます。例：##unc:C:Windows##、##unc:~~myserverpathimg.png##、##unc:home/user/somefile## *** **##unc:##** UNC（Windowsエクスプローラー）のパスとしてリソースを指示する文字列（必須）。 *** **##パス##**：ユーザーがアクセスできるリソースのローカルパスを含む文字列（必須）。例：##C:Windows##、##~~myserverpathimg.png##、##home/user/somefile## ** **種類の設定がない場合**：以上のリソースのいずれも指定されていない場合（リンクで##type:##リソースの接頭辞が指定されていない場合)、リンクは以下のアルゴリズムを使用して、XWikiのターミナルあるいはターミナルでないページへのリンクとして扱われます： *** 現在のスペースの**##ターミナルページ##**（存在する場合//のみ//）。例： ##~[~[A]]##は##~[~[doc:currentSpace.A]]##と同等に解決されます *** 現在のスペースの**##ターミナル以外のページ##**。例： ##~[~[A]]##は##~[~[space:現在のスペース.A]]##、##~[~[doc:現在のスペース.A.WebHome]]##と同等に解決されます *** もし現在のページがターミナル以外のページで、上記2つに当てはまる既存のページが見つからなかった場合、追加で2つのチェックを行います： **** 親スペースにある同レベルのページとしての**##ターミナルページ##**（存在する場合//のみ//）。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[doc:A.B]]##と同等に解決されます **** 親スペースにある同レベルのページとしての**##ターミナル以外のページ##**。例： ターミナルでないページ ##A.C## における##~[~[B]]##リンクは##~[~[space:A.B]]##、##~[~[doc:A.B.WebHome]]##と同等に解決されます *** //注1 - 絶対リンク//: 種類を定めていないリンクがドットで分割した2つ以上のコンポーネントを指定している場合（スペース名とページ名に見えるものになります)、上記のアルゴリズムは、現在のスペースではなく、現在のウィキの相対ページを解決します。例： ##~[~[A.B]]##は##~[~[doc:現在のウィキ:A.B]]##（存在する場合）あるいは##~[~[space:現在のウィキ:A.B]##]（これは##~[~[doc:currentWiki:A.B.WebHome]]##に相当します）を解決し、 ##~[~[doc:現在のウィキ:現在のスペース.A.B]]##または##~[~[doc:現在のウィキ:現在のスペース.A.B.WebHome]]##は解決しません。 *** //注2 - ##.WebHome##の特殊な扱い方//: 種類を定めていないリンクが##.WebHome##で終了する場合、//常に//ターミナルページとして扱います。例： ##~[~[A.WebHome]]##は常に##~[~[doc:A.WebHome]]##と同等に解決し、##~[~[doc:A.WebHome.WebHome]]##は解決しません。 * **##パラメーター##**：リンクに渡すパラメーターの一覧（オプション。スペースで分割）。例： ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##クエリー##**：リンクのターゲットアドレスに付けられ、レンダリングするURLで使用されるパラメーターを指定するクエリー文字列（オプション）。例： ##url:http:~/~/doMain.com/path||queryString="mydata1=5&mydata2=Hello"##は、ターゲットのアドレス ##http:~/~/doMain.com/path?mydata1=5&mydata2=Hello## を生成します ** **##アンカー##**：参照したリンクで規定するアンカーを指示するアンカー名（オプション）。XWikiでは見出しと画像のアンカーが自動的に作成されます。例： ##url:http:~/~/doMain.com/path||anchor="HTableOfContents"##は、ターゲットのアドレス ##http:~/~/doMain.com/path#HTableOfContents## を生成します ** **##ターゲット##**：リンクのターゲットを新しいウィンドウで開くことを可能とするパラメーター（オプション）。例： ##target="~_blank"## |
|
shirahara
Translation reverted |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## |
|
shirahara
Translation changed |
= Editing =
== Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## == Links == === 1.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]] |Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]] |Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]] |Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|((( {{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}} {{{{attach:text|document=Space.Page|file=img.png}}}} )))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]] |Link to a Heading in a page|((( {{{[label>Space.Page#HMyheading]}}} )))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}} {{info}} Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used. {{/info}} The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference. This can be either *** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or *** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank## === 2.0 Links === |=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result |Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]] |Link with a label|((( {{{[[label>>WebHome]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>WebHome]] |Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]] |Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]] |Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]] |Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]] |Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]] |Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]] |Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]] |Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]] |Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]] |Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]] {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} {{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}} {{info}} The part in ##( )## is required, while the parts in ##[ ]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##** ** **##reference##**: The link reference in one of the following forms: *** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/## *** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome## **** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki## **** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## **** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome## *** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png## **** **##attach~:##** A required string identifying the resource as attachment. **** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above. **** **##attachmentName##**: Name of the attachment as it is stored in the wiki. *** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## **** **##mailto~:##** A required string identifying the resource as email. **** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##" ** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents## * **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia## * **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window) === 2.1 Links === |=Feature|=XWiki Syntax 2.1|=Result |Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]] |Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]] |Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]] |Link with a label|((( {{{[[label>>PageA]]}}} {{info}}XWiki Syntax is supported inside link labels.{{/info}} )))|[[label>>]] |Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]] |Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]] |Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]] |Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]] |Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org |Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]] |Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]] |Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]] |Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]] |Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]] |Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]] |Link to a Heading in a page|((( {{{[[PageA.PageB||anchor="HMyheading"]]}}} {{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}} )))|[[PageB>>]] |Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]] |Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1¶m2=value2"]]}}}|[[PageB>>]] |Link to the current page with a query string|{{{[[label>>||queryString="param1=value1¶m2=value2"]]}}}|[[label>>]] {{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}} {{info}} Legend: The parts in ##()## are required, while the parts in ##[]## are optional. {{/info}} The full format of a link is **##[label>>] (resource) [||parameters]##** * **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page## * **##resource##**: A required string with the link reference in one of the following forms ** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/## *** **##url:##** An optional string identifying the resource as an URL. *** **##protocol:~/~/path##**: The URL itself ** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage## *** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page. *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child## ** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome## *** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome## ** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C## *** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space). *** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki## *** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C## ** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki## *** **##interwiki:##** A required string identifying the resource as an InterWiki link. *** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia## *** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki## ** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##** *** **##attach~:##** A required string identifying the reference as an XWiki Document attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C## *** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##** *** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment. *** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##. *** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C## *** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png## ** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com## *** **##mailto~:##** A required string identifying the resource as email. *** **##emailAddress##**: Targeted email address. Example: ##john@smith.com## ** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##. *** **##path:##** A required string identifying the resource as a relative path. *** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked. ** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile## *** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path. *** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile## ** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm: *** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]## *** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]## *** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made: **** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]## **** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]## *** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##. *** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##. * **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"## ** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello## ** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents## ** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"## |
 surli
Resource updated |
Parsing of the "
xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.ja.xml" file was enforced.
2 years ago
|
|
surli
Resource updated |
Parsing of the "
xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.ja.xml" file was enforced.
2 years ago
|
| 2 | File in original format as translated in the repository | XWiki Full Page | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2 | All strings, converted files enriched with comments; suitable for offline translation | Android String Resource | CSV | JSON | JSON nested structure file | gettext PO | iOS strings | TBX | TMX | XLIFF 1.1 with gettext extensions | XLIFF 1.1 | XLSX |
xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.ja.xml" file was changed. a year ago