Wiki source code of Limitations when Moving/Renaming a Page (for Users)
Last modified by Eleni Cojocariu on 2026/08/11 12:11
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | [[Moving/renaming a Page>>documentation.xs.user.base.page.page-refactoring-operations.move-rename.WebHome]] has some limitations, mainly affecting how [[references are updated>>documentation.xs.user.base.page.linking-references.updating-links.WebHome]] to point to the new Page location. | ||
| 2 | |||
| 3 | * [[Image references are broken when contained in a renamed terminal Page>>https://jira.xwiki.org/browse/XWIKI-18634]] | ||
| 4 | * Links inside macro content are only updated for macros whose content is explicitly declared as [[wiki syntax>>Documentation.UserGuide.Features.XWikiSyntax.WebHome]]. As a result: | ||
| 5 | ** Links inside scripting macros (##Velocity##, ##Groovy##, ##HTML## with wiki syntax enabled, etc.) are not updated. | ||
| 6 | ** Macros that accept wiki syntax but do not declare it (e.g., built using older APIs) also do not have their links updated. | ||
| 7 | * Backlinks located inside macro content are not updated, unless the macro uses wiki syntax, or provides a dedicated ##MacroRefactoring## implementation. | ||
| 8 | ** For example, a Java macro that stores a page reference in a parameter (e.g., ##page="Space.PageName##") can implement [[##MacroRefactoring##>>https://github.com/xwiki/xwiki-platform/blob/master/xwiki-platform-core/xwiki-platform-rendering/xwiki-platform-rendering-xwiki/src/main/java/org/xwiki/rendering/macro/MacroRefactoring.java]] to ensure that parameter is also updated when the referenced page is moved or renamed. |
