Wiki source code of Linking and References
Last modified by Eleni Cojocariu on 2026/03/19 08:10
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Pages can be linked using Pages can be linked using different syntaxes or editors. | ||
| 2 | |||
| 3 | == Internal Links == | ||
| 4 | |||
| 5 | An internal link is a link created using a [[Page reference>>||anchor="HPageReference"]] 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.refactoring-operations-pages.move-rename.WebHome]]. | ||
| 6 | |||
| 7 | {{image reference="internal-link.png" size="large" alt="Internal link highlighted in text content"/}} | ||
| 8 | |||
| 9 | == External Links == | ||
| 10 | |||
| 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.refactoring-operations-pages.move-rename.WebHome]]. External links can be easily identified by the small icon displayed next to the link, as shown below: | ||
| 12 | |||
| 13 | {{image reference="external-link-icon.png" size="large" alt="External link icon displayed next to a link"/}} | ||
| 14 | |||
| 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 | |||
| 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); | ||
| 22 | * When calling script APIs that operate on Pages. | ||
| 23 | |||
| 24 | By default, the "Page reference" displayed in the [["Information" tab>>Documentation.UserGuide.Features.DocumentLifecycle.WebHome||anchor="HInformation"]] is relative to the current wiki. | ||
| 25 | |||
| 26 | {{image reference="page-reference.png" size="large" alt="The page reference item from the Information tab"/}} | ||
| 27 | |||
| 28 | You can: | ||
| 29 | |||
| 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 | |||
| 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"]]. |
