Wiki source code of ReleaseNotesXWikiEnterprise20
Version 24.1 by Thomas Mortagne on 2009/09/23
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc start="2"/}}{{/box}} | ||
| 2 | |||
| 3 | = Release Notes for XWiki Enterprise 2.0 | ||
| 4 | |||
| 5 | == New and Noteworthy (since XWiki Enterprise 1.9.3) | ||
| 6 | |||
| 7 | * New Colibri skin | ||
| 8 | * Many UI improvements | ||
| 9 | * Many WYSIWYG improvements | ||
| 10 | * Many rendering improvements | ||
| 11 | * New events distribution and clustering support | ||
| 12 | * Various scripting improvements | ||
| 13 | ** Python support | ||
| 14 | ** Classpath charing between script macros | ||
| 15 | * Big refactor of the Watchlist | ||
| 16 | |||
| 17 | === Colibri skin | ||
| 18 | |||
| 19 | See [[Colibri skin documentation>>code:Skins.ColibriSkin]] for more details. | ||
| 20 | |||
| 21 | XWiki 2.0 introduces a new, lightweight, easily customizable skin. The main goal of the Colibri skin is to provide the proper support for fast and easy modifications of the look and feel of the wiki. The Colibri skin colors and decorative images are defined in ColorTheme objects inside Wiki documents, that can be changed directly in the web interface. | ||
| 22 | |||
| 23 | [[image:code:Skins.ColibriSkin@colibri1.png]] | ||
| 24 | |||
| 25 | Several predefined themes are bundled with XE: | ||
| 26 | |||
| 27 | [[image:code:Skins.ColibriSkin@colibri2.png]] | ||
| 28 | |||
| 29 | === General UI | ||
| 30 | |||
| 31 | * Make section editing work for any section level. You can configure it using the new property ##xwiki.section.depth## in ##xwiki.cfg## file | ||
| 32 | * Change button order in preview mode | ||
| 33 | * Make all skins display the document title as the top level header and ensure there's no duplicate titles displayed. {{warning}}Not all the pages has been converted to new title handling. It will be fixed during the 2.0.x branch life (hopefully for 2.0.1){{/warning}}. | ||
| 34 | * Space Index, Document Index and Orphaned Page now use generic livetable tools | ||
| 35 | * Remove "History" from the edit modes | ||
| 36 | * TOC macro now starts at first level by default | ||
| 37 | * Several IE6/7 bugfixes | ||
| 38 | * Improve group creation form | ||
| 39 | * Reorganize editor button | ||
| 40 | * Diff UI improvement | ||
| 41 | * Improve the Rename form | ||
| 42 | * Nicer pagination of the document history | ||
| 43 | * Display a friendly message instead of an error when clicking on History after having created a new page | ||
| 44 | * The "Rights editor help" panels has been removed | ||
| 45 | * Improve Import administration section | ||
| 46 | * Improved document footer section | ||
| 47 | * Improved tag display and editing | ||
| 48 | |||
| 49 | === WYSIWYG | ||
| 50 | |||
| 51 | See [[WYSIWYG documentation>>platform:Features.WysiwygEditor]] for more details. | ||
| 52 | |||
| 53 | * Upgrade to [[GWT 1.7.0>>http://code.google.com/webtoolkit/releases/release-notes-1.7.0.html#Release_Notes_Current]] | ||
| 54 | * Faster navigation for image and link insertion | ||
| 55 | * Add internationalization support | ||
| 56 | * Improve UX in wysiwyg dialogs / wizards: navigation, error reporting, forms, etc | ||
| 57 | |||
| 58 | ==== Double click to edit a macro | ||
| 59 | |||
| 60 | User can now double click on a macro to edit it and double click in the list of macro to insert it. | ||
| 61 | |||
| 62 | ==== Nicer macro names in the list of macros | ||
| 63 | |||
| 64 | WYSIWYG does not expose macro identifier anymore but human readable names provided by the different macros. | ||
| 65 | |||
| 66 | ==== Macros categories | ||
| 67 | |||
| 68 | Each macro can now be added in a default category the macro author thinks appropriate. It's also possible to overwrite the macro category with configuration. | ||
| 69 | |||
| 70 | The macros categories are mainly used in WYSIWYG to make it easier to find the macros to use. | ||
| 71 | |||
| 72 | image:ReleaseNotesXWikiEnterprise20M4@macro-category.png | ||
| 73 | image:ReleaseNotesXWikiEnterprise20M4@macro-filter.png | ||
| 74 | |||
| 75 | === Rendering 2.0 | ||
| 76 | |||
| 77 | * New Section editing | ||
| 78 | * Allow default document syntax to be specified in User profile configuration | ||
| 79 | |||
| 80 | {{warning}} | ||
| 81 | Not all the pages has been converted to new xwiki/2.0 syntax. It will be fixed during the 2.0.x branch life (hopefully for 2.0.1). | ||
| 82 | {{/warning}} | ||
| 83 | |||
| 84 | ==== Output syntax parameter | ||
| 85 | |||
| 86 | It's now possible to decide which renderer to use to print the document content. For example if you want to generate dome JSON page you can use "?outputSyntax=plain&xpage=plain" to make sure only the content is printed and there is no html syntax printed, just a plain text of what exactly was generated by a velocity macro (without macro markers html comments etc.) | ||
| 87 | |||
| 88 | See [[URL parsing documentation>>platform:AdminGuide.URL resolution#HoutputSyntaxandoutputSyntaxVersion]]. | ||
| 89 | |||
| 90 | ==== New Wiki rendering 2.0 macros | ||
| 91 | |||
| 92 | See [[Wiki macros documentation>>platform:DevGuide.WikiMacroTutorial]] for more details. | ||
| 93 | |||
| 94 | ==== New Tag Cloud Panel | ||
| 95 | |||
| 96 | A panels containing the tag cloud is now provided by default and can be used like any other panel. | ||
| 97 | |||
| 98 | image:ReleaseNotesXWikiEnterprise20M1@tagcloudpanel.png | ||
| 99 | |||
| 100 | ==== New Search Interface | ||
| 101 | |||
| 102 | The default search page UI has been improved to be easier to understand and use. | ||
| 103 | |||
| 104 | [[image:ReleaseNotesXWikiEnterprise20M1@newsearchui.png||width=600]] | ||
| 105 | |||
| 106 | ==== New info, warning and error macros | ||
| 107 | |||
| 108 | See [[Message macro documentation>>code:Macros.MessageMacro]] for more details. | ||
| 109 | |||
| 110 | ==== New Chart macro for XWiki 2.0 syntax | ||
| 111 | |||
| 112 | See [[Chart macro documentation>>code:Macros.ChartMacro20]]. | ||
| 113 | |||
| 114 | ==== Script macro improvements | ||
| 115 | |||
| 116 | See the [[Script Macro documentation>>code:Macros.ScriptMacro]] for more details. | ||
| 117 | |||
| 118 | * It's now possible to add JARs attached to a page to the Script Macro class loader. | ||
| 119 | * All the script macros in the same rendering process (a document and it's included documents) share the same class loader. For example this makes possible to declare a groovy class in a document and use it in other documents which includes it. | ||
| 120 | * It's now possible to not parse velocity macro content for wiki syntax by using the wiki="false" parameter. | ||
| 121 | |||
| 122 | ==== New Python macro | ||
| 123 | |||
| 124 | See [[code:Macros.PythonMacro]] for more details. | ||
| 125 | |||
| 126 | ==== Footnote macro | ||
| 127 | |||
| 128 | See [[Footnote macro documentation>>code:Macros.Footnote20Macro]]. | ||
| 129 | |||
| 130 | [[image:code:Macros.Footnote20Macro@footnote1.png]] | ||
| 131 | |||
| 132 | ==== Formula macro | ||
| 133 | |||
| 134 | Ability to render Mathematical Formulas using the ~{{formula}} macro (see [[documentation page>>code:Macros.FormulaMacro]]). | ||
| 135 | |||
| 136 | You can check for examples on the [[Wikipedia Math Markup page>>http://en.wikipedia.org/wiki/Math_markup]]. | ||
| 137 | |||
| 138 | ==== Smaller XHTML output | ||
| 139 | |||
| 140 | We introduced a light XHTML renderer which avoid having all extra datas needed by the WYSIWYG. You will not get any weird XHTML comment anymore in the rendered page. | ||
| 141 | |||
| 142 | ==== Renderers are now real components | ||
| 143 | |||
| 144 | The same way it's possible to add any parser it's now possible to add any renderer for a specific output simply by registering it as a component. | ||
| 145 | |||
| 146 | See [[code:Modules.RenderingModule]] for more details. | ||
| 147 | |||
| 148 | ==== New plain text parser | ||
| 149 | |||
| 150 | Plain text parser make possible to put in a page some plain text to render it exactly as it. The syntax name of plain text renderer is ##plain/1.0##, you can enable it in xwiki.cfg. | ||
| 151 | |||
| 152 | === Scheduler improvements | ||
| 153 | |||
| 154 | * Allow to manually trigger a job (execute it once) | ||
| 155 | * Upgrade to Quartz 1.6.5 | ||
| 156 | |||
| 157 | === Watchlist | ||
| 158 | |||
| 159 | * Add watch/unwatch wiki in the Watch menu | ||
| 160 | * Improve notification email readability by displaying icons for objects, classes and properties | ||
| 161 | * Watch List support registering for user activity | ||
| 162 | * Put document metadata modifications in diffs | ||
| 163 | * Make the watchlist work across multiple wikis | ||
| 164 | * Put links to pages in email notifications | ||
| 165 | * Use activitystream feed building feature to generate watchlist RSS feed | ||
| 166 | * In virtual mode allow each wiki to have its own watchlist email template document | ||
| 167 | * Big speed improvement by refactoring the watchlist based on activity stream plugin | ||
| 168 | * Add support for class and object diff in the mails | ||
| 169 | * Add support for full wiki watching | ||
| 170 | * Allow to create watchlist notifications for any interval of time | ||
| 171 | * Mails design improvement | ||
| 172 | |||
| 173 | === New Activity stream | ||
| 174 | |||
| 175 | * Provide a way to delete events after a configurable amount of time | ||
| 176 | * Allow to store all activity events in the main wiki in virtual mode | ||
| 177 | |||
| 178 | === New events for XWiki startup/shutdown | ||
| 179 | |||
| 180 | It's now possible for a component or a plugin to register to startup or shutdown events. It's very useful when some plugin need to start and stop an external service. | ||
| 181 | |||
| 182 | === Velocity tools and Velocity properties can be easily changed | ||
| 183 | |||
| 184 | See ##velocity.tools## and ##velocity.properties## parameters in xwiki.properties. | ||
| 185 | |||
| 186 | === Component Manager improvements | ||
| 187 | |||
| 188 | * Added way to programmatically provide the component instance when register it | ||
| 189 | * Added way to programmatically unregister component | ||
| 190 | |||
| 191 | === New xwiki-properties module | ||
| 192 | |||
| 193 | See [Properties module documentation>code:Modules.PropertiesModule]. | ||
| 194 | |||
| 195 | * Java bean populating support | ||
| 196 | * Java type conversion support | ||
| 197 | * Java bean validation support | ||
| 198 | |||
| 199 | Among other things this mean the following changes for the 2.0 macros: | ||
| 200 | * Any case is supported for macros parameters names | ||
| 201 | * Public fields are now supported (not only getters and setters) | ||
| 202 | * Java macro parameters bean is validated agains JSR 303 (See ) | ||
| 203 | * Macro properties java bean can implements RawProperties to get custom non converted parameters | ||
| 204 | * You can add support for any type conversion by implementing Converter component | ||
| 205 | * Any Enum conversion is supported (no need to register each Enum subclass against ConvertUtils anymore) | ||
| 206 | * Support for Color conversion | ||
| 207 | |||
| 208 | === Remote Observation Manager and clustering | ||
| 209 | |||
| 210 | It's now possible to make different instances of XWiki or other programs shares events. | ||
| 211 | |||
| 212 | The main use cases for this are: | ||
| 213 | - clustering | ||
| 214 | - external monitoring of XWiki | ||
| 215 | |||
| 216 | This release include documents events support for code using new Observation Manager and remote events support in document cache so that's it's possible to do basic clustering already. The old code using old notification system will be upgraded during the RC process before the final 2.0 version and support will be added for other types of events. Note that Remote Observation Manager already support any kind of fully Serializable events. | ||
| 217 | |||
| 218 | == Known issues | ||
| 219 | |||
| 220 | * [[Bugs we know about>>http://jira.xwiki.org/jira/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]] | ||
| 221 | |||
| 222 | == Backward Compatibility and Migration Notes | ||
| 223 | |||
| 224 | === General Notes | ||
| 225 | |||
| 226 | {{warning}}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 ##xwiki.store.migration.databases=db1,db2,...##. | ||
| 227 | {{/warning}} | ||
| 228 | |||
| 229 | You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from improvements listed above. | ||
| 230 | |||
| 231 | {{warning}} | ||
| 232 | Always make sure you compare your ##xwiki.cfg## file with the newest version since some configuration parameters were added. Of 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. | ||
| 233 | {{/warning}} | ||
| 234 | |||
| 235 | === API Breakages | ||
| 236 | |||
| 237 | The following APIs were modified since XWiki Enterprise 1.9: | ||
| 238 | |||
| 239 | * Rendering Module | ||
| 240 | ** ##>Block.replace()## has been replaced by ##Block.replaceChild()##> | ||
| 241 | ** ##ParseException## constructor and methods have been modified since they were unused | ||
| 242 | ** ##XWikiXHTMLImageRenderer## and ##XWikiXHTMLLinkRenderer## classes have been moved to a XWiki-specific module so that the main Rendering module can be used standalone | ||
| 243 | ** Merged ##SimpleXHTMLImageRenderer## and ##XWikiXHTMLImageRenderer## into ##DefaultXHTMLImageRenderer## which now handles the case where we're inside a wiki or not | ||
| 244 | ** Merged ##SimpleXHTMLLinkRenderer## and ##XWikiXHTMLLinkRenderer## into ##DefaultXHTMLLinkRenderer## which now handles the case where we're inside a wiki or not | ||
| 245 | ** ##AbstractBlock## constructors has been refactored to make easier to create new common macros. Main change is that the macro author does not have to provide the MacroDescriptor anymore. | ||
| 246 | ** Macro parameters bean are now supposed to use xwiki-properties annotations instead of ##org.xwiki.rendering.macro.descriptor.annotation.*## annotations. Simply change ##org.xwiki.rendering.macro.descriptor.annotation.Parameter*## by ##org.xwiki.properties.annotation.Property*## to upgrade you macro parameters bean. | ||
| 247 | ** Macro have to provide a human readable name in various AbstractMacro helpers constructors | ||
| 248 | ** Big refactor around renderers and the way to use them since they are real components now | ||
| 249 | ** Syntax, SyntaxFactory and SyntaxType classes moved to the proper package (org.xwiki.rendering.syntax) | ||
| 250 | ** Definition lists now take parameters | ||
| 251 | ** Details: | ||
| 252 | {{code language="none"}} | ||
| 253 | |||
| 254 | {{code}} | ||
| 255 | |||
| 256 | == Dependencies | ||
| 257 | |||
| 258 | This release includes the following modules in the specified versions since XWiki Enterprise 1.9.3 was released: | ||
| 259 | |||
| 260 | === Core/Web | ||
| 261 | |||
| 262 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 263 | |##com.xpn.xwiki.platform##|##xwiki-*##|2.0|1.9.3| | ||
| 264 | |##org.xwiki.platform##|##xwiki-*##|2.0|1.9.3| | ||
| 265 | |||
| 266 | === Applications | ||
| 267 | |||
| 268 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 269 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-administration##|1.17|1.12|[[jira>>http://jira.xwiki.org/jira/browse/XAADMINISTRATION]] | ||
| 270 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-blog##|1.12|1.8|[[jira>>http://jira.xwiki.org/jira/browse/XABLOG]] | ||
| 271 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-officeimporter##|1.11|1.9|[[jira>>http://jira.xwiki.org/jira/browse/XAOFFICE]] | ||
| 272 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-panels##|1.24|1.20.1|[[jira>>http://jira.xwiki.org/jira/browse/XAPANELS]] | ||
| 273 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-scheduler##|1.12|1.11| | ||
| 274 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-statistics##|1.5|1.4| | ||
| 275 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-tag##|1.7|1.7| | ||
| 276 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-watchlist##|1.20|1.16| | ||
| 277 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-webdav##|1.2|1.2| | ||
| 278 | |##com.xpn.xwiki.platform.applications##|##xwiki-application-wiki-macro-bridge##|1.2|N/A| | ||
| 279 | |||
| 280 | === Plugins | ||
| 281 | |||
| 282 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 283 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-activitystream##|1.4|N/A| | ||
| 284 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-jodatime##|1.3|1.3| | ||
| 285 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-lucene##|1.10|1.8| | ||
| 286 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-mailsender##|1.13|1.10| | ||
| 287 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-scheduler##|1.12|1.9| | ||
| 288 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-skinx##|1.10|1.9| | ||
| 289 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-tag##|1.7|1.6| | ||
| 290 | |##com.xpn.xwiki.platform.plugins##|##xwiki-plugin-watchlist##|1.20|1.16| | ||
| 291 | |||
| 292 | === Skins | ||
| 293 | |||
| 294 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 295 | |##com.xpn.xwiki.platform.skins##|##xwiki-skin-albatross##|1.24|1.21| | ||
| 296 | |##com.xpn.xwiki.platform.skins##|##xwiki-skin-colibri##|1.3|N/A| | ||
| 297 | |##com.xpn.xwiki.platform.skins##|##xwiki-skin-toucan##|1.28|1.22| | ||
| 298 | |||
| 299 | === Top Level POM | ||
| 300 | |||
| 301 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 302 | |##com.xpn.xwiki.platform##|##xwiki##|27|24| | ||
| 303 | |||
| 304 | === Tools | ||
| 305 | |||
| 306 | |=Group Id|=Artifact Id|=New Version|=Old Version|=JIRA URL | ||
| 307 | |##org.xwiki.platform.tools##|##xwiki-jetty-resources##|1.16|1.14| | ||
| 308 | |##org.xwiki.platform.tools##|##xwiki-rootwebapp##|1.2|1.1| | ||
| 309 | |##org.xwiki.platform.tools##|##xwiki-xar-handlers##|1.9|1.8| | ||
| 310 | |##org.xwiki.platform.tools##|##xwiki-xar-plugin##|1.13|1.12| | ||
| 311 | |##org.xwiki.platform.tools##|##xwiki-configuration-resources##|1.32|1.27| | ||
| 312 | |##org.xwiki.platform.tools##|##xwiki-packager-plugin##|1.13|1.12| | ||
| 313 | |##org.xwiki.platform.tools##|##xwiki-license-resources##|1.1|1.0| | ||
| 314 | |##org.xwiki.platform.tools##|##xwiki-verification-resources##|1.14|1.13| |
