Wiki source code of Linking and References
Last modified by Eleni Cojocariu on 2026/08/11 12:11
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
4.1 | 1 | Pages can be linked using different syntaxes or editors. |
| |
1.1 | 2 | |
| 3 | == Internal Links == | ||
| 4 | |||
| |
5.2 | 5 | An internal link is a link created using a [[Page reference>>||anchor="HPageReferences"]] to point to another Page in the wiki. They can be tracked as [[backlinks>>||anchor="HBacklinks"]] and can be automatically updated when the target Page is [[moved/renamed>>documentation.xs.user.base.page.page-refactoring-operations.move-rename.WebHome]]. |
| |
1.1 | 6 | |
| |
1.6 | 7 | {{image reference="internal-link.png" size="large" alt="Internal link highlighted in text content"/}} |
| 8 | |||
| |
1.5 | 9 | == External Links == |
| 10 | |||
| |
5.2 | 11 | An external link is any link that uses a direct URL (e.g., direct URLs, bookmarks, links shared from outside the wiki). They are not affected by Page [[move/rename>>documentation.xs.user.base.page.page-refactoring-operations.move-rename.WebHome]]. External links can be easily identified by the small icon displayed next to the link, as shown below: |
| |
1.5 | 12 | |
| |
1.6 | 13 | {{image reference="external-link-icon.png" size="large" alt="External link icon displayed next to a link"/}} |
| 14 | |||
| |
1.1 | 15 | == Page References == |
| 16 | |||
| 17 | A Page reference uniquely identifies a Page by its location within the wiki structure. A Page reference represents the path to a Page, using separators to describe its position relative to a wiki and parent Pages. | ||
| 18 | |||
| 19 | Page references are commonly used: | ||
| 20 | |||
| |
1.4 | 21 | * As values of macro parameters that expect a page reference (for example, the [[Include macro's>>extensions:Extension.Include Macro||anchor="HParametersdefinition"]] ##reference## parameter); |
| |
1.1 | 22 | * When calling script APIs that operate on Pages. |
| 23 | |||
| |
1.4 | 24 | By default, the "Page reference" displayed in the [["Information" tab>>Documentation.UserGuide.Features.DocumentLifecycle.WebHome||anchor="HInformation"]] is relative to the current wiki. |
| |
1.1 | 25 | |
| |
1.5 | 26 | {{image reference="page-reference.png" size="large" alt="The page reference item from the Information tab"/}} |
| |
1.2 | 27 | |
| 28 | You can: | ||
| 29 | |||
| |
1.1 | 30 | * Use the button on the left to obtain a global (absolute) reference; |
| 31 | * Use the button on the right to copy the Page reference to the clipboard. | ||
| 32 | |||
| 33 | == Backlinks == | ||
| 34 | |||
| |
3.9 | 35 | Backlinks represent the inverse relationship of links: they indicate which Pages contain links pointing to a given Page. Backlinks are discovered and maintained through internal mechanisms such as [[link indexing>>documentation.xs.user.base.page.linking-references.link-indexing.WebHome]], and they are only available for links that XWiki can interpret (internal links using [[XWiki syntax>>Documentation.UserGuide.Features.XWikiSyntax.WebHome||anchor="HLinks"]]). You can view the backlinks of a Page in the [["Information" tab>>Documentation.UserGuide.Features.DocumentLifecycle.WebHome||anchor="HInformation"]]. |
