# Wiki source code of Release Notes for XWiki Enterprise 3.4

Version 4.1 by Marius Dumitru Florea on 2012/01/24

1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 XWiki Enterprise 3.4 is a stabilization release as we're approaching the end of the [[3.x cycle>>enterprise:Main.Roadmap#HXWikiEnterprise3.xCycle]] so its main goal was to improve the Extension Manager and App Within Minutes features. However, this release also comes with a new look and a new default wiki page syntax.
6
7 = New and Noteworthy (since XWiki Enterprise 3.3 version) =
8
9 Checkout the full unabridged [[list of issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/11290/SearchRequest-11290.html?tempMax=1000]] fixed in this release and, if you're interested in statistics, the [[JIRA dashboard>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=10790]].
10
11 == New color themes ==
12
13 XWiki Enterprise 3.4 comes with a new default color theme and other three (Mint, Ruby and Dusk) that you can choose from. All four use CSS3 rules and new color variables in order to be able to have gradients. All color themes that were previously available are now considered deprecated and have been published as extensions: [[Default>>extensions:Extension.Default33 ColorTheme]], [[Bordo>>extensions:Extension.Bordo ColorTheme]], [[Nature>>extensions:Extension.Nature ColorTheme]], [[BlueSky>>extensions:Extension.BlueSky ColorTheme]], [[Inner Dark>>extensions:Extension.Inner Dark ColorTheme]], [[Nightfall>>extensions:Extension.Nightfall ColorTheme]] and [[Peach>>extensions:Extension.Peach ColorTheme]].
14
15 {{warning}}This means that custom build color themes or skins build on top of Colibri may not be compatible with the recent changes when doing an upgrade.{{/warning}}
16
17 In order to solve this problem you have two solutions: adjust your custom color themes with the new changes or don't upgrade the following wiki pages when upgrading the XAR: ##ColorThemes.DefaultColorTheme## and ##XWiki.AdminSheet## and the following CSS files from Colibri skin: ##colibri.css## and ##ie-all.css##.
18
19 [[[[image:colorthemes34.png||style="border:1px solid gray; padding: 0.2em; width:600px;"]]>>attach:ReleaseNotesXWikiEnterprise34RC1@colorthemes34.png]]
20
21 == XWiki Syntax 2.1 is the default page syntax ==
22
23 Even though the XWiki Syntax 2.1 has been available for a long time already, it was marked experimental. We've now made it final which means no more changes will be brought to the XWiki Syntax 2.1 (any new change will be made in a new XWiki Syntax 2.2).
24
25 What it also means is that when you create a new page from now on, it'll be created in XWiki Syntax 2.1 syntax by default (you can still choose another syntax using the Syntax chooser in edit mode, see [[Page Editing>>platform:Features.PageEditing#HChoosingaSyntax]]).
26
27 As a reminder here are below the differences between XWiki Syntax 2.0 and XWiki Syntax 2.1.
28
29 === Changes to the link syntax from XWiki Syntax 2.0 ===
30
31 The query string and the anchor (URL fragment) are no longer specified in the reference section of the link syntax:
32
33 (% class="box code" %)
35
37
38 (% class="box code" %)
40
41 The canonical representation of a link reference is prefixed with the reference type:
42
43 (% class="box code" %)
44 ~[~[Source repository>>**url:**https:~/~/github.com/organizations/xwiki]]
45 ~[~[Syntax Help>>**doc:**platform:Main.XWikiSyntax]]
46
47 InterWiki links have a dedicated reference type:
48
49 (% class="box code" %)
50 ~[~[XWiki on Wikipedia>>**interwiki:**wikipedia:XWiki]]
51
52 Two new reference types: relative path and [[UNC (Universal Naming Convention)>>http://en.wikipedia.org/wiki/Path_%28computing%29#Uniform_Naming_Convention]].
53
54 (% class="box code" %)
55 ~[~[Edit this page>>**path:**$doc.getURL('edit')]] 56 ~[~[File system access>>**unc:**~\~\myserver\path\to\file.txt]] 57 58 See the [[full link specification>>platform:Main.XWikiSyntax#HXWikiSyntax2.1LinkSpecification]] for more details. 59 60 === Changes to the image syntax from XWiki Syntax 2.0 === 61 62 You can pass the query string of the image URL as a special image parameter: 63 64 (% class="box code" %) 65 ~[~[image~:MyPage@myPicture.png||**queryString**="parameter=value"]] 66 67 You can use a relative path as the image reference. This is useful to display images from the skin: 68 69 (% class="box code" %) 70 image~:**path:**$xwiki.getSkinFile('logo.png')
71
72 It is now possible to reference an icon from the [[XWiki Icon Set>>http://www.famfamfam.com/lab/icons/silk/previews/index_abc.png]]:
73
74 (% class="box code" %)
75 image~:**icon:**chart_pie
76
77 See the [[full image specification>>platform:Main.XWikiSyntax#HXWikiSyntax2.1ImageSpecification]] for more details.
78
79 {{todo/}}
80
81 = Bug fixes and improvements =
82
83 {{todo/}}
84
85 = For Developers =
86
87 {{todo/}}
88
90
91 The following dependencies have been upgraded:
92
93 * AETHER 1.13.1
94 * Groovy 1.8.5
95 * Hibernate 3.6.9
96 * jdeb 0.9
97 * Restlet 2.0.11
98 * Selenium 2.17
99 * Selenium Maven Plugin 2.2
100 * SmartGWT 3.0
101
102 == Translations ==
103
104 The following translations have been updated:
105
106 {{language codes="de, es, fr, hi, hr, lv, ru, sv, uk, zh_TW"/}}
107
108 = Tested Browsers =
109
110 Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]):
111
112 {{browser name="firefox" version="9.0.1"/}}
113
114 {{browser name="chrome" version="16"/}}
115
116 = Test Report =
117
118 You can check the [[manual test report>>TestReports.ManualTestReportXE34]] to learn about what was tested and the results on various browsers.
119
120 = Known issues =
121
122 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
123
124 = Backward Compatibility and Migration Notes =
125
126 == General Notes ==
127
128 {{warning}}
129 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,...//.
130 {{/warning}}
131
132 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
133
134 {{warning}}
135 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were added. Note that 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.
136 {{/warning}}
137
138 == Issues specific to XWiki Enterprise 3.4 ==
139
140 === Default wiki access method changed to path-based ===
141
142 In virtual mode, XWiki can work in two ways: based on domain names, where each virtual wiki is accessed from a different DNS domain, like ##__wikiname__.myfarm.net##, and path-based, where each virtual wiki is accessed on a different path of the same domain, like ##www.myfarm.net/wikis/__wikiname__/##. Since the former mode is harder to set up, since it requires a custom DNS server, we have enabled the second mode by default in this release.
143
144 {{warning}}
145 When merging the xwiki.cfg for the migration process, keep in mind that the value of 'xwiki.virtual.usepath' has been changed to a default of 1 instead of 0. If your wiki is set to virtual mode and is using subdomains to access subwikis, make sure to set 'xwiki.virtual.usepath' to 0.
146 {{/warning}}
147
148 == API Breakages ==
149
150 The following APIs were modified since version 3.3:
151
152 {{code language="none"}}
153 {{/code}}