WikiWord Transformation
![]() | A rendering transformation to automatically generate page links for WikiWords |
Type | JAR |
Category | Rendering Transformation |
Developed by | |
Active Installs | 3 |
Rating | |
License | GNU Lesser General Public License 2.1 |
Compatibility | XWiki 2.6RC1+ |
Table of contents
Description
A WikiWord consists of two or more words with initial capitals and put together.
When this transformation is active, it automatically generates links for WikiWords. The links are pointing to wiki pages. If those pages don't exist you'll see a question mark symbol on the link, allowing you to create the new page by clicking on it.
For example the following text:
Becomes, when rendered:
And if the pages exist you'll see instead:
Performance considerations
Note that in order to discover WikiWords, this transformation needs to check all words in the page being rendered and is thus relatively costly in term of performance. Although that's probably unnoticeable for small pages it may slow down the page display for large pages.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).
You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.
This transformation is not active by default.
To activate it, edit WEB-INF/xwiki.properties, look for a property named rendering.transformations and make sure it's uncommented and contains the value wikiword.
For example:
Dependencies
Dependencies for this extension (org.xwiki.rendering:xwiki-rendering-transformation-wikiword 17.1.0):