現象
默認安裝的Confluence在使用導出pdf時,如果頁面包含有非英文字符,例如中文,日文,韓文等,相應位置就會出現#字符.
分析
通過查看Confluence的相關文件,可以了解到Confluence是使用FOP(http://xmlgraphics.apache.org/fop/)來輸出pdf文件的,使用的是FOP Version 0.20.5.
FOP 0.20.5功能相對還是比較弱,例如
1.不支持多種字體的組合,也就是不支持font-family="sans-serif,宋體"這種方式,
結果就是每段都要指定,否則就只能用一種了,對于confluence來說就很不好了...
2.不支持程序處理斜體,黑體,這樣就要求字體支持黑體,斜體才能實現黑體斜體的效果.
結果就是中文字體都沒有黑體,斜體,無法直接實現中文的黑體,斜體了
我們再看看Confluence的導出功能,Confluence的導出功能是在WEB-INF\classes\importExportSubsystemContext.xml里面定義的,
| <bean id="pdfExporter" class="com.atlassian.confluence.importexport.impl.PdfExporter" singleton="false"> |
通過
查看PdfExporter這個文件,我們可以了解,Confluence是把字體配置信息寫在了類里面,外部無法直接配置.Confluence的字體配置是使用了Verdana,Verdana字體有四種方式:普通,黑體,斜體,黑體+斜體,這是一種英文的字體,支持英文是沒問題的,但是無法支持中文.
通過查看程序,我們還可以知道Confluence是通過固定的fo模板導出pdf的,模板分別為:WEB-INF\classes\com\atlassian\confluence\pages\Page.pdfexport.vm,Page-hierarchy.pdfexport.vm,Space.pdfexport.vm,通過查看這些模板文件,我們可以看到:
| <fo:flow flow-name="xsl-region-body" font-family="Verdana" font-size="11pt" text-align="justify"> |
類似的語句,也就是說Confluence默認使用這個字體輸出pdf文件.
不完美的解決方案
因為Verdana 不支持中文,所以我們必須修改這些處理,下面的解決的方案雖然不是完美的,但是也部分解決了導出pdf的問題.
方案缺點:
1.不支持多語言,例如對日文,韓文等的支持:期待FOP支持字體組合,或者Confluence支持字體配置
2.使用固定字體,例如宋體:期望Confluence支持字體配置
3.不能支持黑體,斜體(變通方法:通過使用黑體代替宋體的黑體,可以支持黑體) :期望有中文字體支持黑體,斜體,或者FOP內部提供支持
4.英文的黑體,斜體也和中文一樣了:bold使用黑體,斜體不支持了.
方案步驟:
1.下載FOP 0.20.5,解壓,閱讀文檔
2.使用FOP的ttfreader生成字體的xml文件,例如微軟提供的宋體,黑體,或者你喜歡的其他字體,以下均已宋體和黑體為例
注意:FOP自帶的Xalan 2.4.1版本在windows下運行生成xml文件時有點問題,換為confluence自帶的2.7.0問題消失.
把fop.bat復制為ttfreader.bat,修改文件最后一行為:
| java -cp "%LOCALCLASSPATH%" org.apache.fop.fonts.apps.TTFReader %1 %2 %3 %4 %5 %6 %7 %8 |
并且把xalan的jar改為2.7.0的jar.
或者直接使用命令行方式也可,自己拼接吧.
ttfreader -ttcname "SimSun" C:\WINNT\Fonts\simsun.ttc simsun.xml
ttfreader C:\WINNT\Fonts\simhei.ttf simhei.xml 生成了2個字體的文件,把xml文件和2個字體文件復制到confluence的WEB-INF\classes\fonts目錄下.
3.修改PdfExporter
為了簡單,我們使用繼承的方法生成一個新的類,例如:
|
package com.jscud.confluence.importexport.impl;
import java.util.ArrayList;
import java.util.List;
import org.apache.fop.configuration.*;
import com.atlassian.confluence.importexport.impl.PdfExporter;
public class ScudPdfExporter extends PdfExporter
{
public ScudPdfExporter()
{
List fonts = new ArrayList();
CustomFontInfo font_info = new CustomFontInfo(null, "fonts/verdana.xml", true, createFontTriplets(
"Verdana", "normal", "normal"), "fonts/verdana.ttf");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/verdanab.xml", true, createFontTriplets("Verdana",
"bold", "normal"), "fonts/verdanab.ttf");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/verdanai.xml", true, createFontTriplets("Verdana",
"normal", "italic"), "fonts/verdanai.ttf");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/verdanaz.xml", true, createFontTriplets("Verdana",
"bold", "italic"), "fonts/verdanaz.ttf");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/simsun.xml", true, createFontTriplets("SimSun","normal","normal"),
"fonts/simsun.ttc");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/simhei.xml", true, createFontTriplets("SimSun",
"bold", "normal"), "fonts/simhei.ttf");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/simsun.xml", true, createFontTriplets("SimSun","normal","italic"),
"fonts/simsun.ttc");
fonts.add(font_info);
font_info = new CustomFontInfo(null, "fonts/simhei.xml", true, createFontTriplets("SimSun",
"bold", "italic"), "fonts/simhei.ttf");
fonts.add(font_info);
Configuration.put("fonts", fonts, 0);
}
private List createFontTriplets(String name, String weight, String style)
{
List triplets = new ArrayList();
triplets.add(new FontTriplet(name, weight, style));
return triplets;
}
/**
* create font Triplets.
*
* main for chinese font ,not had bold,italic support.
*
* @param name font name
* @return font triplets
*/
protected List createScudFontTriplets(String name)
{
List triplets = new ArrayList();
triplets.add(new FontTriplet(name, "normal","normal"));
triplets.add(new FontTriplet(name, "bold","normal"));
triplets.add(new FontTriplet(name, "normal","italic"));
triplets.add(new FontTriplet(name, "bold","italic"));
return triplets;
}
}
|
編譯此類,并把類復制到Confluence的對應目錄下.
然后修改前面提到的importExportSubsystemContext.xml,修改對應的一行為
| <bean id="pdfExporter" class="com.jscud.confluence.importexport.impl.ScudPdfExporter" singleton="false"> |
(再次體會到依賴注射的好處啊)
4.修改前面提到的模板文件的字體設置
<fo:flow flow-name="xsl-region-body" font-family="Verdana" font-size="11pt" text-align="justify">
改為
<fo:flow flow-name="xsl-region-body" font-family="SimSun" font-size="11pt" text-align="justify">
注意:模板文件中還有一些地方的字體設置要改,自己挖掘吧,不改的話,可能會出現###哦
5.修正生成pdf時的中文換行問題
我們還需要修改模板文件里面的:
<fo:page-sequence master-reference="all-pages">
改為
<fo:page-sequence master-reference="all-pages" language="zh">
這樣中文文字換行就沒問題了
6.重啟web application
試試導出pdf,看到中文了吧
說明
1.本人第一次接觸FOP,感覺是個好東西,不過非常不了解,也許相對上面提到的方法還有更好的方法來解決,如果你知道,請不吝指教.
2.Confluence的國際化還有很長的路要走,不過我也沒怎么研究過...沒源碼就是不好研究
 |
除經特別注明外,本文章版權歸JScud Develop團隊或其作者所有.
署名,非商業用途,保持一致. scud(飛云小俠) JScud Develop |