Translation status

22,880 Strings
90%
Browse Translate
132,095 Words
84%
813,947 Characters
83%

Strings status

Strings Words Characters
22,880 132,095 813,947
All strings Browse Translate Zen
80 22 104
Read-only strings Browse Translate Zen
21,751 120,027 731,112
Translated strings Browse Translate Zen
1,129 12,068 82,835
Unfinished strings Browse Translate Zen
961 6,461 39,138
Untranslated strings Browse Translate Zen
168 5,607 43,697
Strings marked for edit Browse Translate Zen
1,095 9,585 59,063
Strings with any failing checks Browse Translate Zen
1,083 8,855 54,858
Translated strings with any failing checks Browse Translate Zen
54 1,762 14,105
Translated strings with dismissed checks Browse Translate Zen
727 4,934 29,344
Failing check: Unchanged translation Browse Translate Zen
44 964 5,412
Failing check: Mismatched full stop Browse Translate Zen
2 6 42
Failing check: Mismatched colon Browse Translate Zen
4 44 230
Failing check: Mismatched question mark Browse Translate Zen
10 24 132
Failing check: Mismatched ellipsis Browse Translate Zen
220 1,701 9,120
Failing check: Multiple capitals Browse Translate Zen
6 36 216
Failing check: Inconsistent Browse Translate Zen
1 3 18
Failing check: Has been translated Browse Translate Zen
1 574 3,275
Failing check: Mismatching line breaks Browse Translate Zen
94 1,484 12,262
Failing check: Chars around XML tags Browse Translate Zen
6 39 270
Failing check: Consecutive duplicated words Browse Translate Zen
3 9 38
Failing check: Prohibited initial character Browse Translate Zen
50 484 3,091
Strings with comments Browse Translate Zen
Component Translated Unfinished Unfinished words Unfinished characters Untranslated Checks Suggestions Comments
xwiki-platform-attachment 98% 1 1 7 1 5
xwiki-platform-extension 92% 7 22 126 2
xwiki-platform-help 95% 5 7,627 66,415 1 3 2
xwiki-platform-like 95% 2 11 62 1 5
xwiki-platform-livedata 75% 29 138 756 24 2
xwiki-platform-model 80% 12 127 760 11
xwiki-platform-notifications 98% 3 27 161 1 54
xwiki-platform-security 65% 10 80 540 10 2
xwiki-platform-refactoring 82% 9 71 403 8 1
xwiki-platform-mention 90% 4 35 193 3
xwiki-platform-icon 84% 2 18 115 2 1
xwiki-platform-wiki 96% 10 122 721 3
xwiki-platform-panels 97% 1 9 50 1
xwiki-platform-sandbox 75% 1 574 3,275 1
xwiki-platform-captcha
xwiki-platform-image 79% 10 100 590 3 2
xwiki-platform-rendering 73% 50 547 3,274 38 5
xwiki-platform-index 96% 3 87 435 22
xwiki-platform-search 90% 13 50 285 15
xwiki-platform-tour 92% 5 47 319 2 1
xwiki-platform-administration 92% 11 113 746 6 7 1
xwiki-platform-user 86% 6 60 330 6
stable-17.10.x 95% 317 2,113 12,763 313 358
stable-18.4.x 96% 294 1,973 11,945 294 379
xwiki-platform-skin-ui-Translations-1710x LGPL-2.1-only 95% 1 28 157 1
xwiki-platform-skin-ui-Translations-184x LGPL-2.1-only 95% 1 28 157 1
xwiki-platform-template-api LGPL-2.1-only 85% 1 6 40 1
xwiki-platform-template-api-1710x LGPL-2.1-only 85% 1 6 40 1
xwiki-platform-template-api-184x LGPL-2.1-only 85% 1 6 40 1
xwiki-platform-tour-ui-TourTranslations-1710x LGPL-2.1-only 95% 2 3 15 2
xwiki-platform-tour-ui-TourTranslations-184x LGPL-2.1-only 95% 2 3 15 2
xwiki-platform-tree-macro-TreeTranslations-1710x LGPL-2.1-only 100% 2
xwiki-platform-tree-macro-TreeTranslations-184x LGPL-2.1-only 100% 2
xwiki-platform-uiextension-api-1710x LGPL-2.1-only 64% 5 59 367 5
xwiki-platform-uiextension-api-184x LGPL-2.1-only 64% 5 59 367 5
xwiki-platform-user-directory-ui-UserDirectoryTranslations-1710x LGPL-2.1-only 73% 5 54 293 5
xwiki-platform-user-directory-ui-UserDirectoryTranslations-184x LGPL-2.1-only 73% 5 54 293 5
xwiki-platform-user-profile-ui-UserProfileTranslations-1710x LGPL-2.1-only 96% 1 6 37 1
xwiki-platform-user-profile-ui-UserProfileTranslations-184x LGPL-2.1-only 96% 1 6 37 1
xwiki-platform-wiki-default LGPL-2.1-only
xwiki-platform-wiki-default-1710x LGPL-2.1-only
xwiki-platform-wiki-default-184x LGPL-2.1-only
xwiki-platform-wiki-ui-common WikiManager CommonTranslations LGPL-2.1-only
xwiki-platform-wiki-ui-common-CommonTranslations-1710x LGPL-2.1-only
xwiki-platform-wiki-ui-common-CommonTranslations-184x LGPL-2.1-only
xwiki-platform-wiki-ui-mainwiki WikiManager LGPL-2.1-only 94% 10 122 721 3
xwiki-platform-wiki-ui-mainwiki-Translations-1710x LGPL-2.1-only 100% 3
xwiki-platform-wiki-ui-mainwiki-Translations-184x LGPL-2.1-only 100% 3
xwiki-platform-wiki-ui-wiki WikiManager LGPL-2.1-only
xwiki-platform-wiki-ui-wiki-Translations-1710x LGPL-2.1-only
xwiki-platform-wiki-ui-wiki-Translations-184x LGPL-2.1-only
xwiki-platform-wysiwyg-api-1710x LGPL-2.1-only 66% 1 2 19 1
xwiki-platform-wysiwyg-api-184x LGPL-2.1-only 66% 1 2 19 1
XWiki.AdminTranslations.xml LGPL-2.1-only 95% 6 97 604 2 7 1
XWiki.EditTranslations LGPL-2.1-only
XWiki.Notifications.Code.LegacyNotificationAdministrationTranslations LGPL-2.1-only 83% 1 1 5
XWiki.Notifications.Code.Translations LGPL-2.1-only 99% 2 26 156 1 54
XWiki.Notifications.Macro LGPL-2.1-only
XWiki.OfficeImporterTranslations LGPL-2.1-only
XWiki.RatingsTranslations LGPL-2.1-only
XWiki.TemplateProviderTranslations LGPL-2.1-only 61% 5 16 142 4
XWiki.UserDirectoryTranslations LGPL-2.1-only 73% 5 54 293 5
XWiki.UserProfileTranslations LGPL-2.1-only 96% 1 6 37 1
XWiki.XWikiSyntaxDefinitionLists LGPL-2.1-only
XWiki.XWikiSyntaxEscapes LGPL-2.1-only
XWiki.XWikiSyntaxGeneralRemarks LGPL-2.1-only
XWiki.XWikiSyntaxGroups LGPL-2.1-only 1
XWiki.XWikiSyntaxHeadings LGPL-2.1-only
XWiki.XWikiSyntaxHorizontalLine LGPL-2.1-only
XWiki.XWikiSyntaxHTML LGPL-2.1-only
XWiki.XWikiSyntaxImages LGPL-2.1-only 50% 1 1,336 11,375
XWiki.XWikiSyntaxIntroduction LGPL-2.1-only
XWiki.XWikiSyntaxLinks LGPL-2.1-only 50% 1 2,464 21,752
XWiki.XWikiSyntaxLists LGPL-2.1-only
XWiki.XWikiSyntaxMacros LGPL-2.1-only
XWiki.XWikiSyntaxNewLineLineBreaks LGPL-2.1-only
XWiki.XWikiSyntaxOtherSyntaxes LGPL-2.1-only
XWiki.XWikiSyntaxParagraphs LGPL-2.1-only
XWiki.XWikiSyntaxParameters LGPL-2.1-only
XWiki.XWikiSyntaxQuotations LGPL-2.1-only
XWiki.XWikiSyntaxScripts LGPL-2.1-only
XWiki.XWikiSyntaxTables LGPL-2.1-only
XWiki.XWikiSyntaxTextFormatting LGPL-2.1-only 100% 1
XWiki.XWikiSyntaxTranslations LGPL-2.1-only
XWiki.XWikiSyntaxVerbatim LGPL-2.1-only

Summary

Project website www.xwiki.org
Language Japanese
Language code ja
Text direction Left to right
Case sensitivity Case-insensitive
Number of speakers 117,608,755
08/21/2026

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 22,880 132,095 813,947
Translated 95% 21,751 90% 120,027 89% 731,112
Needs editing 1% 168 4% 5,607 5% 43,697
Read-only 1% 80 1% 22 1% 104
Failing checks 4% 1,095 7% 9,585 7% 59,063
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 4% 961 4% 6,461 4% 39,138
Last 12 months Previous

Activity in last 12 months

36 changes 14 changes 44 changes 62 changes 23 changes 97 changes 19 changes 7,873 changes 21,933 changes 8 changes 7,588 changes 157 changes 12 changes 471 changes 0 changes 7 changes 129 changes 34 changes 29 changes 4,556 changes 7,671 changes 3,345 changes 3 changes 57 changes
AugSepOctNovDecJanFebMarAprMayJunJul

Quick numbers

132 k
Hosted words
22,880
Hosted strings
95%
Translated
4
Contributors
and previous 30 days

Trends of last 30 days

—
Hosted words
+100%
—
Hosted strings
+100%
−1%
Translated
+95%
—
Contributors
+100%
User avatar webhook:github

Resource updated
The “xwiki-platform-core/xwiki-platform-livedata/xwiki-platform-livedata-macro/src/main/resources/ApplicationResources.properties” file was changed. 08/19/2026
User avatar webhook:github

String added in the repository
Filter operator for {0}
 
livedata.panel.filter.operator.hint
08/19/2026
User avatar webhook:github

String added in the repository
Add a filter for a property
 
livedata.panel.filter.addProperty.hint
08/19/2026
User avatar webhook:github

String added in the repository
Entry selection
 
livedata.table.entrySelector.hint
08/19/2026
User avatar weblate:commit

Changes committed
Changes committed 08/02/2026
User avatar weblate:commit

Changes committed
Changes committed 08/02/2026
User avatar weblate:commit

Changes committed
Changes committed 08/02/2026
User avatar webhook:github

Resource updated
The “xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/XWiki/XWikiSyntaxLinks.xml” file was changed. 08/02/2026
User avatar webhook:github

String updated in the repository
= 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 HTML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank##

=== 2.0 Links ===

|=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result
|Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]]
|Link with a label|(((
{{{[[label>>WebHome]]}}}
{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>WebHome]]
|Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]]
|Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
|Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]]
|Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]]
|Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]]
|Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]]
|Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]]

{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}

{{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}}

{{info}}
The part in ##( )## is required, while the parts in ##[ ]## are optional.
{{/info}}

The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##**

* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##**
** **##reference##**: The link reference in one of the following forms:
*** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/##
*** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
**** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki##
**** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
**** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome##
*** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##
**** **##attach~:##** A required string identifying the resource as attachment.
**** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above.
**** **##attachmentName##**: Name of the attachment as it is stored in the wiki.
*** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##
**** **##mailto~:##** A required string identifying the resource as email.
**** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##"
** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello##
** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents##
* **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia##
* **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window)

=== 2.1 Links ===

|=Feature|=XWiki Syntax 2.1|=Result
|Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]]
|Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]]
|Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]]
|Link with a label|(((
{{{[[label>>PageA]]}}}

{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>]]
|Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]]
|Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]]
|Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]]
|Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]]
|Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]]
|Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]]
|Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]]
|Link to a Heading in a page|(((
{{{[[PageA.PageB||anchor="HMyheading"]]}}}

{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}
)))|[[PageB>>]]
|Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]]
|Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1&param2=value2"]]}}}|[[PageB>>]]
|Link to the current page with a query string|{{{[[label>>||queryString="param1=value1&param2=value2"]]}}}|[[label>>]]

{{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}}

{{info}}
Legend: The parts in ##()## are required, while the parts in ##[]## are optional.
{{/info}}

The full format of a link is **##[label>>] (resource) [||parameters]##**

* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: A required string with the link reference in one of the following forms
** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/##
*** **##url:##** An optional string identifying the resource as an URL.
*** **##protocol:~/~/path##**: The URL itself
** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage##
*** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page.
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##
*** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child##
** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome##
*** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##).
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome##
** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C##
*** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space).
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##
*** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C##
** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki##
*** **##interwiki:##** A required string identifying the resource as an InterWiki link.
*** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia##
*** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki##
** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##**
*** **##attach~:##** A required string identifying the reference as an XWiki Document attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##**
*** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##
*** **##mailto~:##** A required string identifying the resource as email.
*** **##emailAddress##**: Targeted email address. Example: ##john@smith.com##
** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##.
*** **##path:##** A required string identifying the resource as a relative path.
*** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked.
** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile##
*** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path.
*** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile##
** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm:
*** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]##
*** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]##
*** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made:
**** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]##
**** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]##
*** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##.
*** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##.
* **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"##
** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello##
** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents##
** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
= 編集 =

== リンク ==

=== リンク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&param2=value2"]]}}}|[[ページB>>]]
|クエリー文字列付きの現在のページへのリンク|{{{[[ラベル>>||queryString="param1=value1&param2=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"##
content
08/02/2026
User avatar webhook:github

Source string changed
= Editing =

== Links ==

=== 1.0 Links ===

|=(% style="width:20%" %)Feature|=XWiki Syntax 1.0|=(% style="width:20%" %)Result
|Link to a page in the current Space|{{{[WebHome]}}}|[[Web Home>>WebHome]]
|Link with a label|{{{[label>WebHome]}}}|[[label>>WebHome]]
|Link with XWiki Syntax in the label|{{{<a href="$xwiki.getURL("WebHome")"><strong>bold label</strong></a>}}}|[[**bold label**>>WebHome]]
|Link to a page with the space specified|{{{[Main.WebHome]}}}|[[Web Home>>Main.WebHome]]
|Link to a subwiki|{{{[subwiki:Main.WebHome]}}}|[[Web Home>>xwiki:Main.WebHome]]
|Link that opens in a new window|{{{[label>WebHome>_blank]}}}|[[label>>WebHome||target="_blank"]]
|Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Link to a URL|{{{[https://xwiki.org]}}}|[[https://xwiki.org]]
|Link to a URL with a label|{{{[XWiki>https://xwiki.org]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[john@smith.net>mailto:john@smith.net]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Image Link|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2}</a>}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Image Link with image parameters|{{{<a href="$xwiki.getURL("Space1.Page1")">{image:img.png|document=Space2.Page2|width=26|height=26}</a>}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link to an attachment on the current page|(((
{{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}}
{{{{attach:text|file=img.png}}}}
)))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an attachment in a different page|(((
{{info}}See [[Attach Macro>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Old%20XWiki%201.0%20syntax%20renderer/Attach%20Macro%20%28Radeox%29]] for details{{/info}}
{{{{attach:text|document=Space.Page|file=img.png}}}}
)))|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an Anchor in a page|{{{[label>Space.Page#anchor]}}}|[[label>>XWiki.XWikiSyntax||anchor=anchor]]
|Link to a Heading in a page|(((
{{{[label>Space.Page#HMyheading]}}}
)))|[[label>>XWiki.XWikiSyntax||anchor=HMyheading]]

{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}

{{velocity}}$subHeading XWiki Syntax 1.0 Link Specification $subHeading{{/velocity}}

{{info}}
Part in ##( )## is required, parts in ##[ ]## are optional and one of the two chars in ##{ }## needs to be added if optional parts are being used.
{{/info}}

The full format of a link is **##[label {> or |}] (resource) [@interWikiAlias] [{> or |} target]##**

* **##label##**: An optional string which will be displayed to the user as the link name when rendered. Example: ##My Page##
* **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##**
** **##reference##**: The link reference. This can be either
*** **A URI** in the form **##protocol:path##** (examples: ##http:~/~/xwiki.org##, ##mailto~:john@smith.com##), or
*** **A wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
**** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki##
**** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
**** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome##
** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello##
** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings. Example: ##HTableOfContents##
* **##interWikiAlias##**: An optional [[Inter Wiki>>en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia##
* **##target##**: An optional string corresponding to the Hhttps://TML ##target## attribute for a HTML ##A## link element. This element is used when rendering the link. It defaults to opening the link in the current window. Examples: ##_self##, ##_blank##

=== 2.0 Links ===

|=(% style="width:20%" %)Feature|=XWiki Syntax 2.0|=(% style="width:20%" %)Result
|Link to a page in the current Space|{{{[[WebHome]]}}}|[[WebHome]]
|Link with a label|(((
{{{[[label>>WebHome]]}}}
{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>WebHome]]
|Link with XWiki Syntax in the label|{{{[[**bold label**>>WebHome]]}}}|[[**bold label**>>WebHome]]
|Link to a page with the space specified|{{{[[Main.WebHome]]}}}|[[Main.WebHome]]
|Link to a subwiki|{{{[[subwiki:Main.WebHome]]}}}|[[xwiki:Main.WebHome]]
|Link that opens in a new window|{{{[[label>>WebHome||target="_blank"]]}}}|[[label>>WebHome||target="_blank"]]
|Link to a URL directly in the text|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Image Link|{{{[[image:Space2.Page2@img.png>>Space1.Page1]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>Main.WebHome]]
|Image Link with image parameters|{{{[[[[image:Space2.Page2@img.png||width="26" height="26"]]>>Space1.Page1]]}}}|[[[[image:XWiki.XWikiSyntaxLinks@img.png||width="26" height="26"]]>>Main.WebHome]]
|Link to an attachment on the current page|{{{[[text>>attach:img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an attachment in a different page|{{{[[text>>attach:Space.Page@img.png]]}}}|[[text>>attach:XWiki.XWikiSyntaxLinks@img.png]]
|Link to an Anchor in a page|{{{[[label>>Space.Page#anchor]]}}}|[[label>>XWiki.XWikiSyntax||anchor="anchor"]]
|Link to a Heading in a page|{{{[[label>>Space.Page#HMyheading]]}}}|[[label>>XWiki.XWikiSyntax||anchor="HMyheading"]]
|Link to an Anchor in the current page|{{{[[label>>#anchor]]}}}|[[label>>||anchor="anchor"]]

{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}

{{velocity}}$subHeading XWiki Syntax 2.0 Link Specification $subHeading{{/velocity}}

{{info}}
The part in ##( )## is required, while the parts in ##[ ]## are optional.
{{/info}}

The full format of a link is **##[label>>] (resource) [@interWikiAlias] [||parameters]##**

* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: The full link reference using the following syntax: **##(reference) [?queryString] [#anchor]##**
** **##reference##**: The link reference in one of the following forms:
*** **URL**: Any URL in the form of **##protocol:~/~/path##**. Examples: ##http:~/~/xwiki.org##, ##https:~/~/svn.xwiki.org/##
*** **Wiki page** reference in the form **##~[~[wikiName:] spaceNameList.] (pageName)##**. Examples: ##WebHome##, ##Main.WebHome##, ##mywiki:Main.WebHome##
**** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. Example: ##mywiki##
**** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
**** **##pageName##**: A required string containing the name of the linked wiki page. Example: ##WebHome##
*** **Attachment** reference in the form **##attach~: [wikiPageName@] (attachmentName)##**. Examples: ##attach~:img.png##, ##attach~:mywiki:Main.WebHome@img.png##
**** **##attach~:##** A required string identifying the resource as attachment.
**** **##wikiPageName##**: An optional string referencing the page that holds the attachment, see "Wiki page" above.
**** **##attachmentName##**: Name of the attachment as it is stored in the wiki.
*** **Email address** in the form **##mailto~: (emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##
**** **##mailto~:##** A required string identifying the resource as email.
**** **##emailAddress##**: Targeted email address. Example: "##john@smith.com##"
** **##queryString##**: An optional query string for specifying parameters that will be used in the rendered URL. Example: ##mydata1=5&mydata2=Hello##
** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##HTableOfContents##
* **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). This is only valid for wiki page names. Example: ##wikipedia##
* **##parameters##**: An optional list of parameters passed to the link. Example: ##target="~_blank"## (open in new window)

=== 2.1 Links ===

|=Feature|=XWiki Syntax 2.1|=Result
|Absolute link to page ##PageB## located in ##PageA##|{{{[[PageA.PageB]]}}}|[[PageB>>]]
|Relative link to page ##PageA## from the current page|{{{[[PageA]]}}} or {{{[[.PageA]]}}}|[[PageA>>]]
|Relative link to page ##PageB## in ##PageA## from the current page|{{{[[.PageA.PageB]]}}}|[[PageB>>]]
|Link with a label|(((
{{{[[label>>PageA]]}}}

{{info}}XWiki Syntax is supported inside link labels.{{/info}}
)))|[[label>>]]
|Link with wiki syntax in the label|{{{[[**bold label**>>PageA]]}}}|[[**bold label**>>]]
|Link on an image|{{{[[image:PageA@img.png>>PageA]]}}}|[[image:XWiki.XWikiSyntaxLinks@img.png>>]]
|Absolute link to page ##PageB## located in ##PageA## in wiki ##WikiA##|{{{[[WikiA:PageA.PageB]]}}}|[[PageB>>]]
|Link that opens in a new window|{{{[[PageA||target="_blank"]]}}}|[[PageA>>]]
|Implicit link to a URL|{{{This is a URL: https://xwiki.org}}}|This is a URL: https://xwiki.org
|Explicit link to a URL|{{{[[https://xwiki.org]]}}}|[[https://xwiki.org]]
|Explicit link to a URL with a label|{{{[[XWiki>>https://xwiki.org]]}}}|[[XWiki>>https://xwiki.org]]
|Link to an email address|{{{[[john@smith.net>>mailto:john@smith.net]]}}}|[[john@smith.net>>mailto:john@smith.net]]
|Link to an attachment on the current page|{{{[[attach:img.png]]}}}|[[img.png>>]]
|Link to an attachment in a different page|{{{[[attach:PageA.PageB@img.png]]}}}|[[img.png>>]]
|Link to an Anchor in a page|{{{[[PageA.PageB||anchor="anchor"]]}}}|[[PageB>>]]
|Link to a Heading in a page|(((
{{{[[PageA.PageB||anchor="HMyheading"]]}}}

{{info}}When you add a Heading, an anchor named "H" followed by the heading title with only alpha characters is created. For example, for a Heading named "My heading", the generated anchor will be "HMyheading".{{/info}}
)))|[[PageB>>]]
|Link to an anchor in the current page|{{{[[label>>||anchor="anchor"]]}}}|[[label>>]]
|Link to a page with a query string|{{{[[PageA.PageB||queryString="param1=value1&param2=value2"]]}}}|[[PageB>>]]
|Link to the current page with a query string|{{{[[label>>||queryString="param1=value1&param2=value2"]]}}}|[[label>>]]

{{velocity}}$subHeading XWiki Syntax 2.1 Link Specification $subHeading{{/velocity}}

{{info}}
Legend: The parts in ##()## are required, while the parts in ##[]## are optional.
{{/info}}

The full format of a link is **##[label>>] (resource) [||parameters]##**

* **##label##**: An optional string which will be displayed to the user as the link name when rendered. The label may contain XWiki Syntax. If no label is specified a default label will be generated. The generation pattern can be changed, see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]. Example: ##My Page##
* **##resource##**: A required string with the link reference in one of the following forms
** **URL**: Any URL in the form of **##[url:](protocol:~/~/path)##**. Examples: ##http:~/~/xwiki.org##, ##url:https:~/~/svn.xwiki.org/##
*** **##url:##** An optional string identifying the resource as an URL.
*** **##protocol:~/~/path##**: The URL itself
** **Wiki page**: A reference in the form **##page:[(wikiName):](pageNameList)##**. Examples: ##page:Page##, ##page:myxwiki:Page##, ##page:ParentPage.ChildPage.SubChildPage##, ##page:../SiblingPage##, ##page:./ChildPage##
*** **##page:##** A required string identifying the resource as an XWiki page. The same reference can be used for either a terminal or non-terminal page, if both exist it will lead to the non-terminal page.
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##
*** **##pageNameList##**: A required list of slash-separated wiki Pages names pointing to the final linked wiki Page syntax. It's also possible to use ##.## and ##..## to indicate current or parent page/wiki. Examples: ##Main##, ##A/B##, ##A/B/C##, ##../Sibling##, ##./Child##
** **Wiki document**: A reference in the form **##[doc:]~[~[(wikiName):](spaceNameList).](documentName)##**. Examples: ##doc:Welcome##, ##doc:Main.Welcome##, ##doc:mywiki:Main.Welcome##, ##Welcome##
*** **##doc:##** An optional string identifying the resource as an XWiki terminal page. A non-terminal page can also be referenced this way, but it must append its ##.WebHome## part (e.g. ##doc:Sandbox.WebHome##).
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##documentName##**: A required string containing the name of the linked wiki page. Example: ##Welcome##
** **Wiki space**: A reference in the form **##space:[(wikiName):](spaceNameList)##**. Examples: ##space:Main##, ##space:mywiki:Main##, ##space:A.B.C##
*** **##space:##** A required string identifying the resource as an XWiki non-terminal page (i.e. a space).
*** **##wikiName##**: An optional string containing the name of a wiki. The link will point to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##
*** **##spaceNameList##**: A required list of dot-separated wiki Space names pointing to the final linked wiki Space (or non-terminal page). Examples: ##Main##, ##A.B##, ##A.B.C##
** **InterWiki page**: A reference in the form **##interwiki:[(interWikiAlias):](pageName)##**. Example: ##interwiki:wikipedia:XWiki##
*** **##interwiki:##** A required string identifying the resource as an InterWiki link.
*** **##interWikiAlias##**: An optional [[Inter Wiki>>https://en.wikipedia.org/wiki/InterWiki]] alias as defined in the InterWiki Map (see the [[Admin Guide>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/]]). Example: ##wikipedia##
*** **##pageName##**: A required string containing the name of the linked page. Example: ##XWiki##
** **Attachment**: A reference in the form **##attach~:~{~{~{(wikiName):}(spaceNameList).}(pageName)@}(imageName)##**
*** **##attach~:##** A required string identifying the reference as an XWiki Document attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##spaceNameList##**: An optional dot-separated list of wiki Space names. If no space is specified the current space is used. Examples: ##Main##, ##A.B##, ##A.B.C##
*** **##pageName##**: An optional string containing the name of the wiki page to which the referenced image is attached. Example: ##Welcome##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Page Attachment**: A reference in the form **##pageAttach~:~{~{~{(wikiName):}(pageNameList)/}(imageName)##**
*** **##pageAttach~:##** An required string identifying the reference as an XWiki Page attachment.
*** **##wikiName##**: An optional string containing the name of a wiki. The image reference will point to an image attached to a page inside that wiki. If no wiki is specified, the current wiki is used. Example: ##mywiki##.
*** **##pageNameList##**: An optional dot-separated list of wiki page names. If no page is specified the current page is used. Examples: ##Main##, ##A/B##, ##A/B/C##
*** **##attachmentName##**: Name of the attachment as it is stored in the wiki. Example: ##photo.png##
** **Email address**: A reference in the form **##mailto{{{:(}}}emailAddress)##** (###anchor## is not valid). Example: ##mailto~:john@smith.com##
*** **##mailto~:##** A required string identifying the resource as email.
*** **##emailAddress##**: Targeted email address. Example: ##john@smith.com##
** **Relative path**: A reference on the server in the form **##path{{{:(}}}relPath)##**. Example: ##path:$doc.getURL('reset')## produces target address ##http:~/~/server.domain.com/xwiki/bin/reset/Space/Page## where ##/xwiki/bin/reset/Space/Page## is produced by ##$doc.getURL('reset')##.
*** **##path:##** A required string identifying the resource as a relative path.
*** **##relPath##**: A required string containing the relative path of the resource on the server that shall be linked.
** **UNC (Windows Explorer)**: A reference in the form **##unc{{{:(}}}path)##**. The link is rendered as a ##file:~/~/## link. Examples: ##unc:C:Windows##, ##unc:~~myserverpathimg.png##, ##unc:home/user/somefile##
*** **##unc:##** A required string identifying the resource as a UNC (Windows Explorer) path.
*** **##path##**: A required string containing the local path of resource accessible by the user. Examples: ##C:Windows##, ##~~myserverpathimg.png##, ##home/user/somefile##
** **Untyped**: If none of the above-mentioned resource types are specified (i.e. no ##type:## resource prefix was specified in the link), then the link will be treated as a link to an XWiki terminal or non-terminal page using the following algorithm:
*** **##Terminal page##** in the current space, //only// if it exists. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[doc:currentSpace.A]]##
*** **##Non-terminal page##** in the current space. Example: ##~[~[A]]## is resolved to the equivalent of ##~[~[space:currentSpace.A]]##, which is the equivalent of ##~[~[doc:currentSpace.A.WebHome]]##
*** If the current page is non-terminal and the previous 2 checks above did not find an existing page, 2 additional checks are made:
**** **##Terminal page##** as sibling in the parent space, //only// if it exists. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[doc:A.B]]##
**** **##Non-terminal page##** as sibling in the parent space, regardless if it exists or not. Example: The ##~[~[B]]## link inside the non-terminal page ##A.C## is resolved to the equivalent of ##~[~[space:A.B]]##, which is the equivalent of ##~[~[doc:A.B.WebHome]]##
*** //Note1 - Absolute links//: If the untyped link has 2 or more dot-separated components specified (i.e. that look like a space name and a page name), the above algorithm will resolve the page relative to the current wiki, and not the current space. Example: ##~[~[A.B]]## can be resolved to either ##~[~[doc:currentWiki:A.B]]## (if it exists) or to ##~[~[space:currentWiki:A.B]##] (equivalent of ##~[~[doc:currentWiki:A.B.WebHome]]##) and not to ##~[~[doc:currentWiki:currentSpace.A.B]]## or ##~[~[doc:currentWiki:currentSpace.A.B.WebHome]]##.
*** //Note2 - Special handling of ##.WebHome##//: If the untyped link ends in ##.WebHome##, it will //always// be handled as a terminal page. Example: ##~[~[A.WebHome]]## will always be resolved to the equivalent of ##~[~[doc:A.WebHome]]## and not to ##~[~[doc:A.WebHome.WebHome]]##.
* **##parameters##**: An optional list of space-separated parameters passed to the link. Example: ##queryString="mydata1=5&mydata2=Hello" anchor="HTableOfContents" target="~_blank"##
** **##queryString##**: An optional query string for specifying parameters that will be appended to the link target address and used in the rendered URL. Example: ##url:http:~/~/domain.com/path||queryString="mydata1=5&mydata2=Hello"## produces target address ##http:~/~/domain.com/path?mydata1=5&mydata2=Hello##
** **##anchor##**: An optional anchor name pointing to an anchor defined in the referenced link. Note that in XWiki anchors are automatically created for headings and images. Example: ##url:http:~/~/domain.com/path||anchor="HTableOfContents"## produces target address ##http:~/~/domain.com/path#HTableOfContents##
** **##target##**: An optional parameter that allows to open link target in new window. Example: ##target="~_blank"##
content
08/02/2026
Browse all changes for this language