Wiki source code of ReleaseNotesXWikiEnterprise20

Version 26.1 by Thomas Mortagne on 2009/09/23

version	line-number	content
1.1	1	{{box cssClass="floatinginfobox" title="Contents"}}{{toc start="2"/}}{{/box}}
	2
26.1	3	= Release Notes for XWiki Enterprise 2.0 =
1.1	4
26.1	5	== New and Noteworthy (since XWiki Enterprise 1.9.3) ==
1.1	6
24.1	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
1.1	16
26.1	17	=== Colibri skin ===
9.1	18
12.1	19	See [[Colibri skin documentation>>code:Skins.ColibriSkin]] for more details.
11.1	20
9.1	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
17.1	23	[[image:code:Skins.ColibriSkin@colibri1.png]]
9.1	24
	25	Several predefined themes are bundled with XE:
	26
16.1	27	[[image:code:Skins.ColibriSkin@colibri2.png]]
9.1	28
26.1	29	=== General UI ===
9.1	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
19.1	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}}.
9.1	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
26.1	49	=== WYSIWYG ===
9.1	50
21.1	51	See [[WYSIWYG documentation>>platform:Features.WysiwygEditor]] for more details.
	52
9.1	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
26.1	58	==== Double click to edit a macro ====
9.1	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
26.1	62	==== Nicer macro names in the list of macros ====
9.1	63
	64	WYSIWYG does not expose macro identifier anymore but human readable names provided by the different macros.
	65
26.1	66	==== Macros categories ====
9.1	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
11.1	72	image:ReleaseNotesXWikiEnterprise20M4@macro-category.png
	73	image:ReleaseNotesXWikiEnterprise20M4@macro-filter.png
9.1	74
26.1	75	=== Rendering 2.0 ===
9.1	76
	77	* New Section editing
	78	* Allow default document syntax to be specified in User profile configuration
	79
19.1	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).
20.1	82	{{/warning}}
19.1	83
26.1	84	==== Output syntax parameter ====
9.1	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
26.1	90	==== New Wiki rendering 2.0 macros ====
9.1	91
22.1	92	See [[Wiki macros documentation>>platform:DevGuide.WikiMacroTutorial]] for more details.
9.1	93
26.1	94	==== New Tag Cloud Panel ====
9.1	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
26.1	100	==== New Search Interface ====
9.1	101
	102	The default search page UI has been improved to be easier to understand and use.
	103
26.1	104	[[image:ReleaseNotesXWikiEnterprise20M1@newsearchui.png\|\|width="600"]]
9.1	105
26.1	106	==== New info, warning and error macros ====
9.1	107
11.1	108	See [[Message macro documentation>>code:Macros.MessageMacro]] for more details.
9.1	109
26.1	110	==== New Chart macro for XWiki 2.0 syntax ====
9.1	111
	112	See [[Chart macro documentation>>code:Macros.ChartMacro20]].
	113
26.1	114	==== Script macro improvements ====
10.1	115
9.1	116	See the [[Script Macro documentation>>code:Macros.ScriptMacro]] for more details.
	117
10.1	118	* It's now possible to add JARs attached to a page to the Script Macro class loader.
9.1	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.
10.1	120	* It's now possible to not parse velocity macro content for wiki syntax by using the wiki="false" parameter.
9.1	121
26.1	122	==== New Python macro ====
9.1	123
	124	See [[code:Macros.PythonMacro]] for more details.
	125
26.1	126	==== Footnote macro ====
9.1	127
15.1	128	See [[Footnote macro documentation>>code:Macros.Footnote20Macro]].
	129
18.1	130	[[image:code:Macros.Footnote20Macro@footnote1.png]]
9.1	131
26.1	132	==== Formula macro ====
9.1	133
26.1	134	Ability to render Mathematical Formulas using the ~{~{formula}} macro (see [[documentation page>>code:Macros.FormulaMacro]]).
9.1	135
15.1	136	You can check for examples on the [[Wikipedia Math Markup page>>http://en.wikipedia.org/wiki/Math_markup]].
9.1	137
26.1	138	==== Smaller XHTML output ====
9.1	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
26.1	142	==== Renderers are now real components ====
9.1	143
15.1	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.
9.1	145
15.1	146	See [[code:Modules.RenderingModule]] for more details.
9.1	147
26.1	148	==== New plain text parser ====
9.1	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
26.1	152	=== Scheduler improvements ===
9.1	153
	154	* Allow to manually trigger a job (execute it once)
	155	* Upgrade to Quartz 1.6.5
	156
26.1	157	=== Watchlist ===
9.1	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
22.1	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
9.1	172
26.1	173	=== New Activity stream ===
9.1	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
26.1	178	=== New events for XWiki startup/shutdown ===
9.1	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
26.1	182	=== Velocity tools and Velocity properties can be easily changed ===
9.1	183
	184	See ##velocity.tools## and ##velocity.properties## parameters in xwiki.properties.
	185
26.1	186	=== Component Manager improvements ===
9.1	187
23.1	188	* Added way to programmatically provide the component instance when register it
	189	* Added way to programmatically unregister component
9.1	190
26.1	191	=== New xwiki-properties module ===
9.1	192
22.1	193	See [Properties module documentation>code:Modules.PropertiesModule].
	194
9.1	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:
26.1	200
22.1	201	* Any case is supported for macros parameters names
	202	* Public fields are now supported (not only getters and setters)
	203	* Java macro parameters bean is validated agains JSR 303 (See )
	204	* Macro properties java bean can implements RawProperties to get custom non converted parameters
	205	* You can add support for any type conversion by implementing Converter component
	206	* Any Enum conversion is supported (no need to register each Enum subclass against ConvertUtils anymore)
	207	* Support for Color conversion
9.1	208
26.1	209	=== Remote Observation Manager and clustering ===
9.1	210
	211	It's now possible to make different instances of XWiki or other programs shares events.
	212
	213	The main use cases for this are:
	214	- clustering
	215	- external monitoring of XWiki
	216
	217	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.
	218
26.1	219	== Known issues ==
1.1	220
	221	* [[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]]
	222
26.1	223	== Backward Compatibility and Migration Notes ==
1.1	224
26.1	225	=== General Notes ===
1.1	226
9.1	227	{{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,...##.
	228	{{/warning}}
1.1	229
9.1	230	You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from improvements listed above.
	231
	232	{{warning}}
	233	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.
	234	{{/warning}}
	235
26.1	236	=== API Breakages ===
9.1	237
	238	The following APIs were modified since XWiki Enterprise 1.9:
	239
	240	* Rendering Module
26.1	241	** ##Block.replace()## has been replaced by ##Block.replaceChild()##
9.1	242	** ##ParseException## constructor and methods have been modified since they were unused
	243	** ##XWikiXHTMLImageRenderer## and ##XWikiXHTMLLinkRenderer## classes have been moved to a XWiki-specific module so that the main Rendering module can be used standalone
	244	** Merged ##SimpleXHTMLImageRenderer## and ##XWikiXHTMLImageRenderer## into ##DefaultXHTMLImageRenderer## which now handles the case where we're inside a wiki or not
	245	** Merged ##SimpleXHTMLLinkRenderer## and ##XWikiXHTMLLinkRenderer## into ##DefaultXHTMLLinkRenderer## which now handles the case where we're inside a wiki or not
	246	** ##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.
	247	** 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.
	248	** Macro have to provide a human readable name in various AbstractMacro helpers constructors
	249	** Big refactor around renderers and the way to use them since they are real components now
	250	** Syntax, SyntaxFactory and SyntaxType classes moved to the proper package (org.xwiki.rendering.syntax)
	251	** Definition lists now take parameters
	252	** Details:
26.1	253
9.1	254	{{code language="none"}}
	255
25.1	256	{{/code}}
9.1	257
26.1	258	== Dependencies ==
1.1	259
	260	This release includes the following modules in the specified versions since XWiki Enterprise 1.9.3 was released:
	261
26.1	262	=== Core/Web ===
1.1	263
7.1	264	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
26.1	265	\|##com.xpn.xwiki.platform##\|##xwiki-*##\|2.0\|1.9.3
	266	\|##org.xwiki.platform##\|##xwiki-*##\|2.0\|1.9.3
2.1	267
26.1	268	=== Applications ===
2.1	269
4.1	270	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
8.1	271	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-administration##\|1.17\|1.12\|[[jira>>http://jira.xwiki.org/jira/browse/XAADMINISTRATION]]
4.1	272	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-blog##\|1.12\|1.8\|[[jira>>http://jira.xwiki.org/jira/browse/XABLOG]]
	273	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-officeimporter##\|1.11\|1.9\|[[jira>>http://jira.xwiki.org/jira/browse/XAOFFICE]]
	274	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-panels##\|1.24\|1.20.1\|[[jira>>http://jira.xwiki.org/jira/browse/XAPANELS]]
26.1	275	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-scheduler##\|1.12\|1.11
	276	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-statistics##\|1.5\|1.4
	277	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-tag##\|1.7\|1.7
	278	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-watchlist##\|1.20\|1.16
	279	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-webdav##\|1.2\|1.2
	280	\|##com.xpn.xwiki.platform.applications##\|##xwiki-application-wiki-macro-bridge##\|1.2\|N/A
2.1	281
26.1	282	=== Plugins ===
2.1	283
5.1	284	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
26.1	285	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-activitystream##\|1.4\|N/A
	286	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-jodatime##\|1.3\|1.3
	287	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-lucene##\|1.10\|1.8
	288	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-mailsender##\|1.13\|1.10
	289	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-scheduler##\|1.12\|1.9
	290	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-skinx##\|1.10\|1.9
	291	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-tag##\|1.7\|1.6
	292	\|##com.xpn.xwiki.platform.plugins##\|##xwiki-plugin-watchlist##\|1.20\|1.16
2.1	293
26.1	294	=== Skins ===
3.1	295
6.1	296	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
26.1	297	\|##com.xpn.xwiki.platform.skins##\|##xwiki-skin-albatross##\|1.24\|1.21
	298	\|##com.xpn.xwiki.platform.skins##\|##xwiki-skin-colibri##\|1.3\|N/A
	299	\|##com.xpn.xwiki.platform.skins##\|##xwiki-skin-toucan##\|1.28\|1.22
3.1	300
26.1	301	=== Top Level POM ===
2.1	302
6.1	303	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
26.1	304	\|##com.xpn.xwiki.platform##\|##xwiki##\|27\|24
2.1	305
26.1	306	=== Tools ===
2.1	307
6.1	308	\|=Group Id\|=Artifact Id\|=New Version\|=Old Version\|=JIRA URL
26.1	309	\|##org.xwiki.platform.tools##\|##xwiki-jetty-resources##\|1.16\|1.14
	310	\|##org.xwiki.platform.tools##\|##xwiki-rootwebapp##\|1.2\|1.1
	311	\|##org.xwiki.platform.tools##\|##xwiki-xar-handlers##\|1.9\|1.8
	312	\|##org.xwiki.platform.tools##\|##xwiki-xar-plugin##\|1.13\|1.12
	313	\|##org.xwiki.platform.tools##\|##xwiki-configuration-resources##\|1.32\|1.27
	314	\|##org.xwiki.platform.tools##\|##xwiki-packager-plugin##\|1.13\|1.12
	315	\|##org.xwiki.platform.tools##\|##xwiki-license-resources##\|1.1\|1.0
	316	\|##org.xwiki.platform.tools##\|##xwiki-verification-resources##\|1.14\|1.13

Wiki source code of ReleaseNotesXWikiEnterprise20

Quick Links

Let us know

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected