[修改版]在XWiki中怎么正常顯示中文字符
適用版本XWiki 1.0 beta5或者更高版本。在將來的版本中,也許可以更方便的實現這個配置。英文版配置說明參考這里,說的很詳細。http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Encoding
XWiki
的默認編碼是ISO-8859-1。雖然可以正常顯示中文,但是在XWiki Text
Edit中,中文被顯示為數字編碼。要將默認編碼修改為UTF-8,才能正常顯示中文。但是,有的時候修改不當,在進行roll-back操作的時候,中
文顯示為問號,形如'??????'。
修改XWiki配置文件編碼
在XWiki的根目錄下的WEB-INF文件夾里,修改如下文件中和編碼相關的內容。
- web.xml: encoding = UTF-8
- xwiki.cfg: xwiki.encoding = UTF-8
修改數據庫編碼
- 如果使用的是XWiki自帶的數據庫hsqldb,則不需要修改。
- 如果使用的是MySQL數據庫,找到其配置文件(my.ini如果是windows,在linux下是/etc/mysql/my.cnf),修改在相應的地方添加如下配置項:
[client]
default-character-set=utf8
[mysqld]
default-character-set=utf8
character-set-server = utf8
collation-server = utf8_general_ci
- 如果是其他數據庫,只需要修改其配置文件,使其數據庫編碼和JDBC鏈接編碼都為UTF-8即可。詳細可參見相應數據庫幫助文檔。
修改Java應用服務器編碼
- (這一步可選,似乎不修改也沒有關系,修改了之后控制開反而會出現亂碼)如果使用Jetty或者早起版本的Tomcat作為服務器,需要修改啟動的腳本文件。在windows下都是.bat或者.sh文件。
export JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun"
# Set juli LogManager if it is present
if [ -r "$CATALINA_HOME"/bin/tomcat-juli.jar ]; then
JAVA_OPTS="$JAVA_OPTS "-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager" "-Djava.util.logging.config.file="$CATALINA_BASE/conf/logging.properties " -Dfile.encoding=UTF-8
fi
# Set juli LogManager if it is present
if [ -r "$CATALINA_HOME"/bin/tomcat-juli.jar ]; then
JAVA_OPTS="$JAVA_OPTS "-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager" "-Djava.util.logging.config.file="$CATALINA_BASE/conf/logging.properties " -Dfile.encoding=UTF-8
fi
在XWiki自帶的Jetty的start_xwiki.bat,修改如下:
echo off
set LANG=en_US.UTF-8
set JETTY_PORT=8080
set JETTY_HOME=.
java %JAVA_OPTS% -Dfile.encoding=UTF-8 -Djetty.port=%JETTY_PORT% -Djetty.home=%JETTY_HOME% -jar %JETTY_HOME%/start.jar
set LANG=en_US.UTF-8
set JETTY_PORT=8080
set JETTY_HOME=.
java %JAVA_OPTS% -Dfile.encoding=UTF-8 -Djetty.port=%JETTY_PORT% -Djetty.home=%JETTY_HOME% -jar %JETTY_HOME%/start.jar
- 如果使用的新版的Tomcat,在bin下面沒有.bat文件,只有tomcat5.exe文件。那么在運行tomcat5.exe只有,在系統托盤的圖標上單擊右鍵,選擇Configure。選擇Java標簽,在java option中添加'-Dfile.encoding=UTF-8'。如下圖所示:
- 如果是其他的應用服務器,只要修改相應的配置文件即可。可以查閱相應幫助文檔。
- (這一步是必須的)有時候會有中文url不能正常訪問的問題,那就需要修改$TOMCAT_HOME/conf/server.xml文件,在每一個Connector標簽中加入屬性"URIEncoding="UTF-8"。修改后的代碼形如:
<Connector port="8080" axHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8"/>
hibernate配置文件編碼(可選)
在XWiki的根目錄下WEB-INF文件夾下的hibernate.cfg.xml文件中如下代碼:<property name="connection.url">jdbc:mysql://localhost:3306/xwiki?useUnicode=true&characterEncoding=utf8&useServerPrepStmts=false</property>
感謝
在XWiki的郵件列表得到了大家很多非常有用的建議。非常感謝各位的幫助。總結一下,希望對大家有幫助。