Wiki source code of Encoding

Last modified by Vincent Massol on 2020/06/25

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 Below you have the configuration for UTF-8.
6
7 = Servlet Container =
8
9 == Tomcat ==
10
11 Since Tomcat 8.0.x, the [[##URIEncoding## property is ##UTF8## by default>>http://tomcat.apache.org/tomcat-8.0-doc/config/http.html#Common_Attributes]]:
12
13 > This specifies the character encoding used to decode the URI bytes, after %xx decoding the URL. If not specified, UTF-8 will be used unless the org.apache.catalina.STRICT_SERVLET_COMPLIANCE system property is set to true in which case ISO-8859-1 will be used.
14
15 == Jetty ==
16
17 {{code}}
18 echo off
19 rem set LANG=fr_FR.ISO8859-1
20 set LANG=en_US.UTF-8
21 set JETTY_PORT=8080
22 set JETTY_HOME=.
23 java %JAVA_OPTS% -Djetty.port=%JETTY_PORT% -Djetty.home=%JETTY_HOME% -Dfile.encoding=UTF-8 -jar %JETTY_HOME%/start.jar
24 {{/code}}
25
26 Instead of the config system variable LANG you can use JVM properties.
27
28 {{code}}
29 -Duser.language=en
30 -Duser.country=US
31 {{/code}}
32
33 in server startup script.
34
35 == [[Glassfish>>http://glassfish.java.net/]] ==
36
37 To run XWiki with UTF-8 in Glassfish you will need to recreate the XWiki WAR file and do a change to the glassfish config. First, in the Administration GUI under Domain => General => Locale enter **en_US.UTF-8**.
38
39 Now you will need to add all the aforementioned changes from this document to the files in the war file, create a new warfile, and deploy that one to your glassfish installation. This is required due to the fact that Glassfish will not accept changes to a deployed web.xml file. So you need to deploy a ready changed **web.xml** file inside your war file because all subsequent changes to the deployed **web.xml** file in the filesystem are totally ignored.
40
41 Create a new directory that we will use as a temporary place to edit our war file:
42
43 {{code}}
44 mkdir xwikitmp
45 {{/code}}
46
47 Unpack the warfile (replace ##<suffix>## with the proper name for the version of XWiki you're using):
48
49 {{code}}
50 cd xwikitemp;jar xvf ../xwiki-<suffix>.war
51 {{/code}}
52
53 Edit the files as mentioned in the beginning of this article:
54
55 * wiki.cfg
56 * web.xml
57 * hibernate.cfg.xml
58
59 Now let's create a new warfile which contains all the changes:
60
61 {{code}}
62 jar cvf ../xwiki-<suffix>.war .
63 {{/code}}
64
65 Now you can deploy your new .war file to Glassfish and it will have all the changes in it and wll be correctly deployed.
66
67 = Web server =
68
69 == Apache ==
70
71 Make sure that the Apache configuration file ##httpd.conf## contains the following line:
72
73 {{code}}
74 AddDefaultCharset UTF-8
75 {{/code}}
76
77 = System config =
78
79 Add the following variables to your system:
80
81 {{code}}
82 LANG = en_US.UTF-8
83 {{/code}}
84
85 [[Credits>>http://markmail.org/message/qitvntzz7cwpyo2w]]
86
87 = OpenOffice import =
88
89 If OpenOffice import turns characters into question marks or HTML Entity you need to edit **registrymodifications.xcu** located in user profile used by the OO server by adding:
90
91 {{code}}
92 <item
93 oor:path="/org.openoffice.Office.Common/Filter/HTML/Export"><prop
94 oor:name="Encoding" oor:op="fuse"><value>76</value></prop></item>
95 {{/code}}
96
97 [[Credits>>http://lists.xwiki.org/pipermail/users/2011-November/021004.html]]
98
99 = Tools =
100
101 * The [[Admin Tools extension>>extensions:Extension.Admin Tools Application]] can be helpful to identify the values of the XWiki encoding configuration parameters on a running server.

Get Connected