Wiki source code of Configure Interwiki Links
Last modified by Eleni Cojocariu on 2026/09/25 02:50
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Define the aliases an Interwiki link reaches another website through, once for the whole instance, in the ##xwiki.properties## [[configuration file>>doc:documentation.xs.admin.configuration.WebHome]]. | ||
| 2 | 1. Stop the XWiki instance. | ||
| 3 | 1. Open ##xwiki/WEB-INF/xwiki.properties##, find the ##rendering.interWikiDefinitions## block and add one uncommented line per alias:((( | ||
| 4 | {{code language="none"}} | ||
| 5 | rendering.interWikiDefinitions = wikipedia = https://en.wikipedia.org/wiki/ | ||
| 6 | rendering.interWikiDefinitions = jira = https://jira.xwiki.org/browse/ | ||
| 7 | {{/code}} | ||
| 8 | ))) | ||
| 9 | 1. Restart the XWiki instance, then write the links in a page, as {{code language="none"}}[[label>>interwiki:alias:reference]]{{/code}}:((( | ||
| 10 | {{code language="none"}} | ||
| 11 | * [[Interwiki links>>interwiki:wikipedia:Interwiki_links]] | ||
| 12 | * [[XWIKI-24689>>interwiki:jira:XWIKI-24689]] | ||
| 13 | {{/code}} | ||
| 14 | ))) | ||
| 15 | 1. Save the page and check that each link reaches its site. XWiki appends the reference to the alias's address, with nothing in between, so the first link above is served by {{code language="none"}}https://en.wikipedia.org/wiki/Interwiki_links{{/code}}:((( | ||
| 16 | {{image reference="interwiki-links-page.png" size="extra" alt="A wiki page whose two bullets are Interwiki links, rendered as ordinary external links"/}} | ||
| 17 | ))) |
