XWiki Enterprise 2.3 Milestone 1

Version 5.2 by Silvia Macovei on 2010/03/24

First milestone of the XWiki Enterprise 2.3 version (Roadmap).

The highlights of this release are: new annotation feature, new colibri color theme editor.

New and Noteworthy (since XWiki Enterprise 2.2.3)


The scope of this feature is to allow users to annotate text in an XWiki document. With the new feature you can:

  • Make annotations by selecting the text and pressing Ctrl + M (Meta + M)


  • Show annotations on your page


  • See an annotation for a text item by hovering over the yellow icon next to it


  • Edit and delete annotations straight from the page


  • Manage annotations from the "Annotations" tab


Color Theme Editor

The new editor allows fast and easy modifications for the look and feel of the wiki. You'll find in this editor 

  • A new way of displaying themes on the "Color Themes" space home


  • The ability to create a new theme from the "Color Theme" space home


  • A palette for each area you are editing with a popup listing everything you can customize at this level


  • A dialog where you can make the desired changes


  • The possibility to undo the latest modifications or reset all changes

Known issues

Backward Compatibility and Migration Notes

General Notes

If you're running in a multiwiki setup you'll also need to define the property xwiki.store.migration.databases=all to your xwiki.cfg file or explicitly name all databases to be migrated as in <tt>xwiki.store.migration.databases=db1,db2,....

You may also want to import the default wiki XAR in order to benefit from the improvements listed above.

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Note you should add xwiki.store.migration=1 so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

Migration Notes

  • The new parser/serializer for document names comes with new features and changes some behaviors:
    • introducing escaping means:
      • \ which is now the escaping character needs to be doubled in full document name, as in Space.Docu
        , which means space Space and document Docu\ment
      • some generated documents names will now contains \ to escape thing like dot in a document name. For example Space.Docu\.ment means space Space and document Docu.ment
    • support for the syntax wikiname:Document has been dropped, so in this example "wikiname:Document" will be seen as the document name because no . has been found
  • If you had Wiki Macros defined in your wiki before, you might want to edit them to check their visibility field since the notion of visibility was introduced in XE 2.2 and the default value is user-visibility.

Get Connected