Changes for page Release Notes for XWiki Enterprise 2.0.1
Last modified by Thomas Mortagne on 2023/10/13
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -6,6 +6,214 @@ 6 6 7 7 {{error}}TODO{{/error}} 8 8 9 +=== Colibri skin 10 + 11 +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. 12 + 13 +image:ReleaseNotesXWikiEnterprise20M4@colibri1.png 14 + 15 +Several predefined themes are bundled with XE: 16 + 17 +image:ReleaseNotesXWikiEnterprise20M4@colibri2.png 18 + 19 +=== General UI 20 + 21 +* Make section editing work for any section level. You can configure it using the new property ##xwiki.section.depth## in ##xwiki.cfg## file 22 +* Change button order in preview mode 23 +* Make all skins display the document title as the top level header and ensure there's no duplicate titles displayed. 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) 24 +* Space Index, Document Index and Orphaned Page now use generic livetable tools 25 +* Remove "History" from the edit modes 26 +* TOC macro now starts at first level by default 27 +* Several IE6/7 bugfixes 28 +* Improve group creation form 29 +* Reorganize editor button 30 +* Diff UI improvement 31 +* Improve the Rename form 32 +* Nicer pagination of the document history 33 +* Display a friendly message instead of an error when clicking on History after having created a new page 34 +* The "Rights editor help" panels has been removed 35 +* Improve Import administration section 36 +* Improved document footer section 37 +* Improved tag display and editing 38 + 39 +=== WYSIWYG 40 + 41 +* Upgrade to [[GWT 1.7.0>>http://code.google.com/webtoolkit/releases/release-notes-1.7.0.html#Release_Notes_Current]] 42 +* Faster navigation for image and link insertion 43 +* Add internationalization support 44 +* Improve UX in wysiwyg dialogs / wizards: navigation, error reporting, forms, etc 45 + 46 +==== Double click to edit a macro 47 + 48 +User can now double click on a macro to edit it and double click in the list of macro to insert it. 49 + 50 +==== Nicer macro names in the list of macros 51 + 52 +WYSIWYG does not expose macro identifier anymore but human readable names provided by the different macros. 53 + 54 +==== Macros categories 55 + 56 +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. 57 + 58 +The macros categories are mainly used in WYSIWYG to make it easier to find the macros to use. 59 + 60 +{image:macro-category.png} {image:macro-filter.png} 61 + 62 +=== Rendering 2.0 63 + 64 +* 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). 65 +* New Section editing 66 +* Allow default document syntax to be specified in User profile configuration 67 + 68 +==== Output syntax parameter 69 + 70 +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.) 71 + 72 +See [[URL parsing documentation>>platform:AdminGuide.URL resolution#HoutputSyntaxandoutputSyntaxVersion]]. 73 + 74 +==== New Wiki rendering 2.0 macros 75 + 76 +See [[platform:DevGuide.WikiMacroTutorial]]. 77 + 78 +==== New Tag Cloud Panel 79 + 80 +A panels containing the tag cloud is now provided by default and can be used like any other panel. 81 + 82 +image:ReleaseNotesXWikiEnterprise20M1@tagcloudpanel.png 83 + 84 +==== New Search Interface 85 + 86 +The default search page UI has been improved to be easier to understand and use. 87 + 88 +[[image:ReleaseNotesXWikiEnterprise20M1@newsearchui.png||width=600]] 89 + 90 +==== New info, warning and error macros 91 + 92 +See [[Message macro documentation>>code:Macros.MessageMacro]]. 93 + 94 +==== New Chart macro for XWiki 2.0 syntax 95 + 96 +See [[Chart macro documentation>>code:Macros.ChartMacro20]]. 97 + 98 +==== Script macro improvements 99 +See the [[Script Macro documentation>>code:Macros.ScriptMacro]] for more details. 100 + 101 +* Ability to add JARs attached to a page to the Script Macro class loader. 102 +* 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. 103 + 104 +===== New "wiki" parameter for all script macros 105 + 106 +It's now possible to not parse velocity macro content for wiki syntax by using the wiki="false" parameter. For example: 107 + 108 +{{code}} 109 +{{velocity wiki="false"}} 110 +#set($var = "**not bold**") 111 +$var 112 +{{/velocity}} 113 +{{/code}} 114 + 115 +will render 116 + 117 +{{code}} 118 +**not bold** 119 +{{/code}} 120 + 121 +==== New Python macro 122 + 123 +See [[code:Macros.PythonMacro]] for more details. 124 + 125 +==== Footnote macro 126 + 127 +image:code:Macros.Footnote20Macro@footnote1.png 128 + 129 +See [[Footnote macro documentation>>code:Macros.Footnote20Macro]]. 130 + 131 +==== Formula macro 132 + 133 +Ability to render Mathematical Formulas using the ~{{formula}} macro (see [[documentation page>>code:Macros.FormulaMacro]]). 134 + 135 +You can check for examples on the [Wikipedia Math Markup page>>http://en.wikipedia.org/wiki/Math_markup]]. 136 + 137 +==== Smaller XHTML output 138 + 139 +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. 140 + 141 +==== Renderers are now real components 142 + 143 +The same way it's possible to add any parser it's not possible to add any renderer for a specific output simply by registering it as a component. 144 + 145 +See [[code:Modules.RenderingModule]]. 146 + 147 +==== New plain text parser 148 + 149 +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. 150 + 151 +=== Scheduler improvements 152 + 153 +* Allow to manually trigger a job (execute it once) 154 +* Upgrade to Quartz 1.6.5 155 + 156 +=== Watchlist 157 + 158 +* Add watch/unwatch wiki in the Watch menu 159 +* Improve notification email readability by displaying icons for objects, classes and properties 160 +* Watch List support registering for user activity 161 +* Put document metadata modifications in diffs 162 +* Make the watchlist work across multiple wikis 163 +* Put links to pages in email notifications 164 +* Use activitystream feed building feature to generate watchlist RSS feed 165 +* In virtual mode allow each wiki to have its own watchlist email template document 166 +* big speed improvement by refactoring the watchlist based on activity stream plugin 167 +* add support for class and object diff in the mails 168 +* add support for full wiki watching 169 +* allow to create watchlist notifications for any interval of time 170 +* mails design improvement 171 + 172 +=== New Activity stream 173 + 174 +* Provide a way to delete events after a configurable amount of time 175 +* Allow to store all activity events in the main wiki in virtual mode 176 + 177 +=== New events for XWiki startup/shutdown 178 + 179 +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. 180 + 181 +=== Velocity tools and Velocity properties can be easily changed 182 + 183 +See ##velocity.tools## and ##velocity.properties## parameters in xwiki.properties. 184 + 185 +1.1.1 Component Manager api improvements 186 + 187 +* Add way to directly provide the component instance when register it 188 +* Add way to unregister component 189 + 190 +1.1.1 New xwiki-properties module 191 + 192 +* Java bean populating support 193 +* Java type conversion support 194 +* Java bean validation support 195 + 196 +Among other things this mean the following changes for the 2.0 macros: 197 +* any case is supported for macros parameters names 198 +* public fields are now supported (not only getters and setters) 199 +* java macro parameters bean is validated agains JSR 303 (See ) 200 +* macro properties java bean can implements RawProperties to get custom non converted parameters 201 +* you can add support for any type conversion by implementing Converter component 202 +* any Enum conversion is supported (no need to register each Enum subclass agains ConvertUtils anymore) 203 +* support for Color conversion 204 + 205 +See [Properties module documentation>code:Modules.PropertiesModule]. 206 + 207 +1.1.1 Remote Observation Manager 208 + 209 +It's now possible to make different instances of XWiki or other programs shares events. 210 + 211 +The main use cases for this are: 212 +- clustering 213 +- external monitoring of XWiki 214 + 215 +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. 216 + 9 9 == Known issues 10 10 11 11 * [[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]] ... ... @@ -14,8 +14,36 @@ 14 14 15 15 === General Notes 16 16 17 -{{error}}TODO{{/error}} 225 +{{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,...##. 226 +{{/warning}} 18 18 228 +You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from improvements listed above. 229 + 230 +{{warning}} 231 +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. 232 +{{/warning}} 233 + 234 +=== API Breakages 235 + 236 +The following APIs were modified since XWiki Enterprise 1.9: 237 + 238 +* Rendering Module 239 +** ##>Block.replace()## has been replaced by ##Block.replaceChild()##> 240 +** ##ParseException## constructor and methods have been modified since they were unused 241 +** ##XWikiXHTMLImageRenderer## and ##XWikiXHTMLLinkRenderer## classes have been moved to a XWiki-specific module so that the main Rendering module can be used standalone 242 +** Merged ##SimpleXHTMLImageRenderer## and ##XWikiXHTMLImageRenderer## into ##DefaultXHTMLImageRenderer## which now handles the case where we're inside a wiki or not 243 +** Merged ##SimpleXHTMLLinkRenderer## and ##XWikiXHTMLLinkRenderer## into ##DefaultXHTMLLinkRenderer## which now handles the case where we're inside a wiki or not 244 +** ##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. 245 +** 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. 246 +** Macro have to provide a human readable name in various AbstractMacro helpers constructors 247 +** Big refactor around renderers and the way to use them since they are real components now 248 +** Syntax, SyntaxFactory and SyntaxType classes moved to the proper package (org.xwiki.rendering.syntax) 249 +** Definition lists now take parameters 250 +** Details: 251 +{{code language="none"}} 252 + 253 +{{code}} 254 + 19 19 == Dependencies 20 20 21 21 This release includes the following modules in the specified versions since XWiki Enterprise 1.9.3 was released: