Last modified by Thomas Mortagne on 2017/03/24

Hide last authors
Sergiu Dumitriu 1.1 1 #startfloatingbox()
2 *Contents*
Vincent Massol 37.6 3 #toc ("2" "4" "")
Sergiu Dumitriu 1.1 4 #endfloatingbox()
5
Jean-Vincent Drean 47.1 6 1 Release Notes for XWiki Enterprise 1.9
Sergiu Dumitriu 1.1 7
Jean-Vincent Drean 47.1 8 Final version of XWiki Enterprise 1.9 ([Roadmap>enterprise:Main.Roadmap]).
Sergiu Dumitriu 1.1 9
Jean-Vincent Drean 47.1 10 1.1 Summary of changes since XWiki Enterprise 1.8.4
Sergiu Dumitriu 1.1 11
Vincent Massol 37.6 12 1.1.1 1 UI improvements
Vincent Massol 37.5 13
Vincent Massol 52.2 14 This version contains several improvements enhancing the usability and productivity on the wiki.
Sergiu Dumitriu 1.1 15
Sergiu Dumitriu 39.5 16 Many thanks to Marta Gîrdea, who supervised the development of most of these improvements.
17
Vincent Massol 37.6 18 1.1.1.1 Quick ~~Jump to any Page~~ navigation
Vincent Massol 50.5 19
Sergiu Dumitriu 1.1 20 It is now possible to jump from any page to any other page, using a modal dialog aided by a suggest-powered search. To start, just press <tt>Ctrl+G</tt> or <tt>Meta+G</tt> (the meta key is the one between <tt>Alt</tt> and <tt>Ctrl</tt>, usually with a Windows logo on it, or the one with the Apple logo on Macs), or click on the text from the ~~Quick Links~~ panel.
21
22 {image:jmp1.png}
23
24 The modal dialog appears in the upper part of the page, and provides an input where the users must introduce the full name of the document they wish to view.
25
26 {image:jmp2.png}
27
28 Start typing, and a suggest box will offer documents matching your search criterion (at most 10 documents are displayed for the moment). You can use this suggest as any other suggest box in XWiki: ~~Up~~ and ~~Down~~ move the selection, while ~~Enter~~ puts the currently selected value in the input.
29
30 {image:jmp3.png}
31
32 To go to the selected page, just press ~~Enter~~ once more (this will open the document in view mode), or use one of the two buttons on the dialog, or press <tt>Ctrl+V</tt> or <tt>Meta+V</tt> to view, and <tt>Ctrl+E</tt> or <tt>Meta+E</tt> to edit the target document. ~~Esc~~ simply closes the dialog without changing the current page.
33
34 {image:jmp4.png}
35
36 {image:jmp5.png}
37
38 Known issues:
39 - Some of the shortcuts are not available on all systems and browsers (for example Chrome), and they inhibit some of the browser's native shortcuts (for example <tt>Ctrl+G</tt> on Firefox normally searches for the next occurrence of the searched term, but <tt>F3</tt> does the same thing).
40 - The suggest box searches only on the document name. The next release will bring support for quick search by the document's title.
41 - The suggest box displays at most 10 documents. It should be possible to fetch more results when pressing the Down arrow after the last item.
42 - The edit button does not open form-based documents in the inline editing mode, but in the configured editor (wiki or WYSIWYG). This will probably be fixed in the next release.
43 - Typing just the name of a document, without the space, does not open a document in the current space, but in the ~~view~~ space. This will be fixed in the next release.
44 - It is not possible to enter more than one search term, separated by spaces, since the suggest searches for an exact match of the input string. This will be fixed once the overall REST-based search will be improved.
45
Vincent Massol 37.6 46 1.1.1.1 Faster ~~Save and Continue~~ using AJAX
Vincent Massol 50.5 47
Sergiu Dumitriu 1.1 48 Save and Continue doesn't refresh the page anymore, but makes an AJAX request to save the document. When pressing the ~~Save &amp; Continue~~ button, or the <tt>Alt+Shift+S</tt> shortcut, a message appears at the bottom of the screen, indicating that the document is being saved.
49
50 {image:sac1.png}
51
52 Since this action is performed using AJAX, much less processing is required on the server, and much less data is transfered between the server and the client. Before you even notice it, the message quickly transforms into a ~~Saved~~ notification, then fades away.
53
54 {image:sac2.png}
55
56 {image:sac4.png}
57
58 If an error occurs, you will be notified of the problem by a similar notification message:
59
60 {image:sac3.png}
61
62 As a related minor improvement, the ~~Cancel~~ button also behaves faster. Until now, it used to submit the entire form back to the server, although the data was discarded. Now, a simple request without any data is made, thus reducing the network traffic and the total response time.
63
Vincent Massol 37.6 64 1.1.1.1 Improved ~~Full Screen~~ editing
Sergiu Dumitriu 1.1 65
66 XWiki had a full screen editing mode since 2007, when it was implemented thanks to a [Google Summer of Code>dev:GoogleSummerOfCode.WebHome] student. But it had several limitations that made it less useful than it should have been:
67 - It had a particular look that didn't integrate well with the current skin
68 - It didn't have the action buttons allowing to save or preview the document
69 - It only worked with the main content editor, and only for wiki editing and the old WYSIWYG editor
70 - It had several minor bugs on different browsers
71
Sergiu Dumitriu 37.2 72 {image:fs0.png|The old FullScreen editor}
73
Sergiu Dumitriu 1.1 74 This feature was completely rewritten, addressing all of these issues. To start editing in full screen, press the button available in the toolbars of the wiki editor and the WYSIWYG editors:
75
76 {image:fs1.png}
77
78 {image:fs2.png}
79
80 {image:fs3.png}
81
82 The editor will then take the entire available space, preserving only the toolbar and the action buttons. You can now save the document right from the full screen interface, and even take advantage of the new AJAX Save and Continue to quickly save and remain in full screen. To return to the normal view mode, push one of the two available buttons (one in the toolbar, and one next to the action buttons).
83
84 {image:fs4.png}
85
86 You can also edit in full screen any textarea in inline mode and in the object editor:
87
88 {image:fs5.png}
89
90 Other notable enhancements:
91 - Improved support for browsers (tested in IE 6, 7 and 8, Chrome, Safari, Opera, and of course Firefox).
92 - Returning from Preview restores the maximized editor (and in most browsers except IE also when hitting the browser's Back button).
93 - Reuses the skin styles and integrates nicely with both Albatross and Toucan
94
95 Current limitations:
96 - Because of some IE bugs, the button will appear after a short delay.
97 - Because of other IE bugs, when exiting full screen the edited field will be displayed a bit larger for about half a second.
98 - Because of some other IE bugs, when exiting full screen the window will be scrolled to the top of the document (this should be fixed in the next release).
99
Sergiu Dumitriu 46.2 100 1.1.1.1 New ~~Live Table~~ UI
Jerome 38.1 101
Jerome 38.2 102 The ~~Live Table~~ displaying all documents and all attachments in the Document Index page, as well as Users, Groups and Rights entries in the administration has been extended functionally and revamped from a design and user experience point of view. We have dropped the pseudo scroll bar in favor of a pagination mechanism. Columns are now sortable, which allows for example to sort the document or attachment index by date (ascending or descending).
Jerome 38.1 103
104 {image:livetable1.png}
105
106 This Live Table as been made a reusable component, available for applications developers to bind to their application business data in a breathe (just one velocity macro call is enough to create such a table). Read more in the JavaScript improvement section of the release notes, or checking out the live table [developer documentation page>platform:DevGuide.LiveTable], that includes a video introducing the table capabilities.
107
Sergiu Dumitriu 46.4 108 1.1.1.1 Improved ~~comments~~ UI and functionality
109
110 The XWiki comments have also been improved, now allowing users to reply to existing comments, and have threaded discussions. Just click the "Reply" button to respond to any comment.
111
112 {image:comm1.png}
113
114 The comment form will appear under the replied comment.
115
116 {image:comm2.png}
117
118 The data will be sent via AJAX, to improve the continuity and speed.
119
120 {image:comm3.png}
121
122 Comment deletion is also done using AJAX requests:
123
124 {image:comm4.png}
125
126 {image:comm5.png}
127
128 1.1.1.1 Multiple ~~attachment~~ upload in one request
Vincent Massol 50.5 129
Sergiu Dumitriu 46.4 130 Uploading more than one file at once is difficult in web interfaces, since it is impossible to select more than one file in the dialog provided by the browser. It was even more difficult in XWiki, since the user had to scroll down to the attachment area, expand the upload form, browse for a file, submit, wait a lot for the file to be uploaded, and then go back and do all the steps again, several times. We made things a bit easier, by allowing to insert all the wanted files in the form (as distinct file input field), then submit only once.
131
132 A first improvement is that the upload form is now expanded by default. You will notice the ~~Add another file~~ and the red ~~X~~ buttons. You can add as many fields as you like (keeping in mind that the wiki has a limit on the total size of the upload data), and you can later remove any field wrongly selected. Pressing the ~~Cancel~~ button will restore the form to its initial state, with only one empty file field.
133
134 {image:att2.png}
135 {image:att3.png}
136
137 Another minor improvement related to attachments is that the icons indicating the type of an attachment have been updated to use the Silk set, and more file types visually indicated by specific icons are covered.
138
139 {image:att1.png}
140
Vincent Massol 37.6 141 1.1.1.1 New UI for the ~~Class and Object editors~~
Sergiu Dumitriu 1.1 142
143 The Class and Object editors have been revamped to improve the usability.
144
145 For the object editor, the accordion has been replaced with expandable tree-like structures, with quick buttons for editing only one object at a time, and for deleting an object (which is performed using AJAX, thus much faster, without loosing the context).
146
147 {image:obj1.png}
148
149 To start editing properties, click on the object's name to expand it, click again to collapse it. The same principle be used to expand/collapse classes and object properties (note that for collapsing properties you will have to click on the (-) sign next to the property name, since clicking on the property name itself gives focus to the corresponding input field). Using this tree, several objects can be opened at a time, so when you have to edit two objects at the same time, you don't have to continuously move from one object to the other.
150
151 {image:obj2.png}
152
153 A feature that was implemented a long time ago, but remained hidden in the UI until now, is the ability to edit just one object. With the new UI, this feature, which greatly improves the speed when dealing with documents with many objects, is exposed as an intuitive button next to the ~~Delete Object~~ button. Combined with the FullScreen editing support for textarea properties, and with the AJAX Save and Continue, editing large properties inside the wiki is much more productive.
154
155 {image:obj3.png}
156
157 The class editor also underwent major changes. The first thing to notice is that when editing a document that doesn't define a class yet, a list of existing classes is displayed instead of the blank screen from previous versions.
158
159 {image:class1.png}
160
161 Notice the way classes are grouped by the space they belong to. The same grouping was also applied for the ~~Add Object~~ panel in the object editor, and the ~~Class Switcher~~ panel in the class editor. This separation makes it easier to find the desired class in a wiki with many classes.
162
163 {image:class2.png}
164
165 Like with the object editor, the class editor also changed the accordion with a tree-like structure. It is now possible to keep more than one property opened at a time, and to collapse and expand only the needed metaproperties.
166
167 A major inconvenience with the old class editor was that it was hard to determine the type of a property, without looking carefully at its meta-properties. Now, this is fixed both by listing the type next to the name, and by using a suggestive icon.
168
169 {image:class4.png}
170
171 Another improvement is that non-functional and rarely used metaproperties have been removed to reduce the perceived complexity of configuring a class, at least until their support will be improved (~~tooltip~~, ~~customDisplay~~, ~~unmodifiable~~, ~~contenttype~~). The ~~number~~ property is also hidden when JavaScript is enabled, since the property reordering can now be performed using simple Drag and Drop.
172
173 {image:class3.png}
174
Sergiu Dumitriu 46.4 175 1.1.1.1 Improved ~~toolbar in the wiki editor~~
Vincent Massol 50.5 176
Sergiu Dumitriu 46.4 177 The toolbar for the wiki editing mode has been improved, adding support for the xwiki/2.0 syntax, adding more buttons, and replacing the icons with images from the Silk icon set.
Sergiu Dumitriu 40.1 178
Sergiu Dumitriu 46.4 179 {image:wt1.png}
Sergiu Dumitriu 40.1 180
Sergiu Dumitriu 46.4 181 {image:wt2.png}
Sergiu Dumitriu 40.1 182
Sergiu Dumitriu 46.4 183 Current limitations:
184 - When switching the syntax from 1.0 to 2.0, before reloading the document the toolbar for the old syntax is used. This should be fixed in a future release.
Sergiu Dumitriu 40.1 185
Vincent Massol 37.6 186 1.1.1.1 Preliminary support for ~~Autosave~~
Sergiu Dumitriu 1.1 187
188 A feature frequently asked for is the ability to autosave documents, so that when a problem occurs after a long editing session, at least all but the most recent changes should be recovered. While more changes in the underlying structure of XWiki are needed in order to implement it properly, for the moment we have a preliminary implementation for this feature.
189
190 When editing in the wiki mode, you will notice a checkbox allowing to enable the Autosave feature:
191
192 {image:as1.png}
193
194 {image:as2.png}
195
196 By default, a document version will be saved every 5 minutes, but this can be changed by editing the number:
197
198 {image:as3.png}
199
200 Current limitations:
201 - The autosave only works with the wiki editor; support for the new WYSIWYG will be added shortly.
202 - Autosave actually saves the document, creating real versions, so anybody can see the created drafts.
203 - Each autosave creates a distinct version, so a long editing session with a short autosave interval will create lots of minor versions.
204 - A new version will be saved even if no changes occurred since the last autosave.
205
Vincent Massol 37.6 206 1.1.1 2 PDF export improvements
Vincent Massol 37.5 207
Vincent Massol 50.5 208 Some important features were added and several issues addressed related to the PDF export feature:
Sergiu Dumitriu 1.1 209 - PDFs now contain a ~~cover page~~ and a ~~table of contents~~ page.
210 {image:pdf1.png}
211 {image:pdf2.png}
212 - Changed the default font to FreeSerif, as it looks better on paper.
213 {image:pdf3.png}
214 - Scaled images preserve the custom dimensions in PDFs also, with the exception that the aspect ratio is always preserved to be the same as the original image, and:
215 - Images are prevented from overflowing the paper, by being automatically scaled down to the maximum available space.
216 - The export works when running the container as a user with no home directory, since now the cache is correctly created in the temporary directory.
217 - A few style changes.
218
Vincent Massol 37.6 219 1.1.1 3 JavaScript improvements
Vincent Massol 37.5 220
Sergiu Dumitriu 1.1 221 We started to cleanup and improve our JavaScript widgets and APIs, to make the code smaller, more modular, more easy to understand, to have a common architecture.
222
Vincent Massol 37.6 223 1.1.1.1 New ~~notifications~~
Vincent Massol 37.5 224
Sergiu Dumitriu 1.1 225 XWiki now sends custom events when certain actions occur:
226 - <tt>xwiki:dom:loading</tt> and <tt>xwiki:dom:loaded</tt> when the document is loaded. The former is fired right after the DOM is loaded, and is supposed to be the signal that marks the start of the page's lifecycle. This is the event that should start all scripts making important DOM changes that other scripts should see. The latter is sent right after it, and is supposed to be the signal that triggers most of the scripts loaded at startup. *It is recommended to bind startup scripts to this event* instead of <tt>window.load</tt> or <tt>document.dom:loaded</tt>.
227 - <tt>xwiki:docextra:activated</tt> and <tt>xwiki:docextra:loaded</tt> when loading tabs for the document extra data (attachments, comments, history, etc.). The former is called each time one of the tabs is selected. The latter is called only for the first activation, when the corresponding data has arrived.
Sergiu Dumitriu 37.4 228 - <tt>xwiki:actions:cancel</tt>, <tt>xwiki:actions:preview</tt> and <tt>xwiki:actions:save</tt> are sent when pushing one of the form action buttons. As extra information the second parameter sent to event listeners contains the original click event (if any, and which can be stopped to prevent the action from completing), the form being submitted, and a boolean <tt>continue</tt> parameter for the <tt>xwiki:actions:save</tt> event, to distinguish between ~~Save and View~~ and ~~Save and Continue~~.
Sergiu Dumitriu 1.1 229 Other events will be added in the future as needed.
230
Jerome 39.2 231 A complete documentation for those events and their memo data is available on [the JavaScript API page on XWiki's platform development guide>platform:DevGuide.JavaScriptAPI].
Jerome 39.1 232
Vincent Massol 37.6 233 1.1.1.1.1 Usage example
Vincent Massol 37.5 234
Sergiu Dumitriu 1.1 235 [Prototype.js>http://www.prototypejs.org/] is the framework recommended for XWiki development. It eases listening for and sending event using the [Event>http://www.prototypejs.org/api/event] "class" and three new methods for the [document>http://www.prototypejs.org/api/document] object.
236
237 To listen for a custom event, do:
238 {code}
239 document.observe("xwiki:dom:loaded", function() {
240 alert("The document has loaded");
241 });
242 {code}
243
244 Prototype allows more complicated tricks, like binding to a custom object and registering additional parameters using [bindAsEventListener>http://www.prototypejs.org/api/function/bindAsEventListener].
245
246 To send an event, do:
247 {code}
Jerome 39.3 248 document.fire("xwiki:mymodule:myaction", {"someParam": true, "anotherOne": myObject});
Sergiu Dumitriu 1.1 249 {code}
250
Vincent Massol 37.6 251 1.1.1.1 New reusable ~~components~~
Vincent Massol 37.5 252
Sergiu Dumitriu 1.1 253 To support the new UI features, the following new components have been added:
254 - <tt>XWiki.widgets.ModalPopup</tt>: a simple modal dialog with no default content, which is supposed to be used as the base class for notifications. See [the source code>http://svn.xwiki.org/svnroot/xwiki/platform/web/trunk/standard/src/main/webapp/resources/js/xwiki/widgets/modalPopup.js] for details.
255 - <tt>XWiki.actionButtons.AjaxSaveAndContinue</tt>: as the name says, this is responsible for the improved save and continue functionality. It responds to the <tt>xwiki:actions:save</tt> event with the <tt>continue</tt> flag set to true. See [the source code>http://svn.xwiki.org/svnroot/xwiki/platform/web/trunk/standard/src/main/webapp/resources/js/xwiki/actionbuttons/actionButtons.js] for details.
256 - <tt>XWiki.widgets.Suggest</tt>: this is the old suggest, for which thorough cleanup work has started. See [the source code>http://svn.xwiki.org/svnroot/xwiki/platform/web/trunk/standard/src/main/webapp/resources/js/xwiki/suggest/ajaxSuggest.js] for details.
257 - <tt>XWiki.widgets.JumpToPage</tt>: the first subclass of the <tt>ModalPopup</tt>, it is responsible for the new ~~Jump to Page~~ feature. See [the source code>http://svn.xwiki.org/svnroot/xwiki/platform/web/trunk/standard/src/main/webapp/resources/js/xwiki/widgets/jumpToPage.js] for details.
Vincent Massol 53.2 258 - <tt>XWiki.widgets.LiveTable</tt>: the JavaScript class supporting the AJAX Live Table front-end mechanisms, used currently by the Document Index UIs and administration Users, Groups and Rights UIs. You can browse [the source code>http://svn.xwiki.org/svnroot/xwiki/platform/web/trunk/standard/src/main/webapp/resources/js/xwiki/table/livetable.js] for details, or [read the livetable velocity macro documentation>platform:DevGuide.LiveTable] for a out-of-the-box macro that can map a live table to an XWiki class of objects.
Sergiu Dumitriu 1.1 259
Vincent Massol 37.6 260 1.1.1.1 Cleanup
Sergiu Dumitriu 1.1 261 We started cleaning up the old JavaScript code, replacing custom code with methods provided by [Prototype.js>http://www.prototypejs.org/], removing unused code, applying a common codestyle, introducing a standard naming convention, introducing a standard directory policy, etc. The first components affected are the Suggest, the behavior for the form action buttons, and the XWiki object itself.
262
Vincent Massol 37.6 263 1.1.1.1 ~~Deprecation~~ strategy
Sergiu Dumitriu 1.1 264 We added a <tt>compatibility.js</tt> script file that contains deprecated code and aliases from old methods/classes to the corresponding new ones.
265
Vincent Massol 37.6 266 1.1.1 4 Switched to UTF-8 as the default encoding
Sergiu Dumitriu 1.1 267
Vincent Massol 50.5 268 The default encoding of XWiki has changed to UTF-8 to better integrate in the multi-national web. If you want to go back to the old encoding, you must edit <tt>WEB-INF/xwiki.cfg</tt> and <tt>WEB-INF/web.xml</tt> and change the encoding parameters.
269
Sergiu Dumitriu 1.1 270 #warning("If you were using a database with character encodings in ISO-8859-1, you will have to either switch XWiki back to ISO-8859-1, or convert your databases to UTF8.")
271
272 The default HSQLDB database bundled with the standalone XWiki distributions are not affected by the encoding, so they should work after an upgrade without any changes.
273
Vincent Massol 37.6 274 1.1.1 5 Mailsender improvements
Vincent Massol 50.4 275
Vincent Massol 50.5 276 The SMTP setting (username, password, server port, and extra Javamail properties which allow to enable SSL) are easier to configure (now accessible in the Administration -&gt; General tab), and are by default visible in the wiki. Previously, they had to be manually added to the ~~XWiki.XWikiPreferences~~ class. These settings are also used with the registration confirmation email.
Sergiu Dumitriu 1.1 277
278 {image:smtp.png}
279
Vincent Massol 50.4 280 Thanks to Paul Guralivu and Lilianne Blaze for providing patches.
Sergiu Dumitriu 1.1 281
Vincent Massol 50.4 282 1.1.1 6 New Office Importer feature: document splitting
Sergiu Dumitriu 46.2 283
Jean-Vincent Drean 47.1 284 The Office Importer application now allows to split documents into multiple wiki pages during import.
Sergiu Dumitriu 46.3 285
Jean-Vincent Drean 47.1 286 <img style="border: solid 2px #CCC;" src="$doc.getAttachmentURL("officeimporter.jpg")" />
287
Vincent Massol 51.1 288 1.1.1 7 XWiki 2.0 Syntax is enabled by default
Jean-Vincent Drean 47.1 289
Vincent Massol 51.1 290 This means that new pages are created using the XWiki 2.0 Syntax and thus benefit from the new WYSIWYG editor too. See [Migration notes for more details>#HDefaultSyntaxchangedtoXWiki20Syntax].
291
292 1.1.1 8 Other improvements
293
Vincent Massol 50.4 294 * Document syntax can be changed from the WYSIWYG editor.
Vincent Massol 51.1 295 * Upgraded to Groovy 1.6.3.
296 * Group Sheets are now using the Livetable widget.
297 * Upgrade to Jython 2.5rc3 (used in the Code macro since we're using Pygments for pretty-displaying).
298 * Simple Users don't see technical spaces anymore.
299 * New behavior for Velocity Macro for New Lines and White space (see [Migration notes for more details>#HVelocitymacrocleaning28SyntaxXWiki2029]).
300 * WYSIWYG improvement: Indenting multiple items at once in a list
Jean-Vincent Drean 47.1 301
Sergiu Dumitriu 1.1 302 1.1 Known issues
303
Thomas Mortagne 55.1 304 * [Bugs we know about>https://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]
Sergiu Dumitriu 1.1 305
Vincent Massol 50.1 306 1.1 Backward Compatibility and Migration Notes
Sergiu Dumitriu 1.1 307
308 #warning("If you're running in a multiwiki setup you'll also need to define the property <tt>xwiki.store.migration.databases=all</tt> to your <tt>xwiki.cfg</tt> file or explicitly name all databases to be migrated as in <tt>xwiki.store.migration.databases=db1,db2,...</tt>.")
309
310 You may also want to [import the default wiki XAR>Main.Download] in order to benefit from improvements listed above.
311
312 #warning("Always make sure you compare your <tt>xwiki.cfg</tt> file with the newest version since some configuration parameters were added. Of note, you should add <tt>xwiki.store.migration=1</tt> so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.")
313
Sergiu Dumitriu 52.1 314 1.1.1 Servlet 2.4 compliant container required
315
316 XWiki 1.8 and earlier were compatible with the 2.3 servlet specification. XWiki 1.9 now requires a servlet 2.4 compliant server to work, please check your container specifications.
317
Vincent Massol 50.1 318 1.1.1 Default Encoding changed to UTF-8
319
320 The default encoding was changed from ISO-8859-1 to UTF-8. If you were using the old default encoding and a database using character encodings, you must convert the database data, too, or switch XWiki back to the old encoding
321
322 1.1.1 Default Syntax changed to XWiki 2.0 Syntax
323
324 The default syntax is now 'xwiki/2.0' which means that new documents will be created with this syntax.
325
326 Note that XWiki Enterprise documents (user profile, recent changes, etc) are still using the "xwiki/1.0" syntax, they will be migrated during the 2.0 release cycle.
327
Jean-Vincent Drean 48.1 328 1.1.1 Escaping in parameters (Syntax XWiki 2.0)
329
Thomas Mortagne 53.1 330 The syntax for escaping special characters in parameters changed from \\\ to ~ to follow the general XWiki 2.0 syntax rule. For example instead of writing
Jean-Vincent Drean 48.1 331
332 {code}
333 {{macro param="val\"ue"/}}
Vincent Massol 50.2 334 {code}
Jean-Vincent Drean 48.1 335
336 to have a quote in the parameter value you will write
337
338 {code}
339 {{macro param="val~"ue"/}}
Vincent Massol 50.2 340 {code}
Thomas Mortagne 49.1 341
342 1.1.1 Velocity macro cleaning (Syntax XWiki 2.0)
343
Vincent Massol 50.5 344 The velocity content is now "cleaned" before being executed to be able to organize the code in a more readable way. Each group of white spaces and new lines is replace with a single space and you can force a new line or a space with respectively $nl ot $sp. See [code:Macros.VelocityMacro].
Thomas Mortagne 49.1 345
346 You can return to no cleaning by setting <tt>core.velocity.filter=none</tt> in <tt>xwiki.properties</tt> file.
347

Get Connected