Nice URLs in XWiki

This tutorial will tell you how to tune your XWiki platform so that the URLs used and displayed are nice.

If you deploy XWiki as the ROOT app, you must also change in WEB-INF/web.xml the parameter to the empty string, like:

To get rid of /view/, in xwiki.cfg write

xwiki.showviewaction=0

To get rid of /bin/, for the moment you have to change web.xml in a container-dependent way, so that you map the container's default servlet to existing directories, like skins, yui, tinymce and wikieditor, copy the /bin mapping to also be activated for / (copy, don't change, so that /bin works, too), then add in xwiki.cfg

xwiki.defaultactionpath=

This will allow you to access documents with server.com/Space/Document, server.com/Space/ (pointing to Space.WebHome), server.com/Document (pointing to Main.Document), and server.com/ will show Main.WebHome without needing a redirect.

As a bonus, these changes are backwards compatible, meaning that any currently working URL will also work with these changes performed, so you won't have any broken bookmarks.

All these changes aren't completely tested, so there could be some things that aren't working, because of code that parses the URL and counts the number of slashes, or expects an exact URL pattern containing /bin/ or stuff like that. But my unconfirmed guess is that it should all work fine.

If you want to have different action mappings, like server.com/Space/Doc?action=edit, then there's more work, like writing a new URLFactory, changing struts-config.xml, and creating another RequestProcessor.