本文僅面向非維運平台部署的帆軟項目
維運平台部署的項目,在工程外掛目錄/customlib/fonts資料夾,可用於存放客戶自訂的字體檔案,等同於直接放置在/usr/share/fonts下
1. 概述
1.1 問題描述
工程部署在Linux 系統中時,有時我們存取工程會遇到中文亂碼。
1.2 原因分析
出現這個情況有多種原因:
1)工程所在的伺服器,沒有設定中文為預設語言。
2)工程所在的伺服器,沒有安裝範本對應的字體包。
本文以 centos 系統為例。其他 Linux 版本安裝步驟有所不同,請根據你的系統需求自行調整。
2. 設定預設語言環境
1)檢查伺服器是否安裝中文語言環境,如果沒有則需要安裝
2)檢查中文語言環境是否是預設語言環境,如果不是需要設定
2.1 安裝中文語言環境
首先檢查當前伺服器系統是否已安裝中文語言環境,如果沒有就需要安裝中文語言環境。
1)查看當前系統是否已安裝中文語言環境
命令 | 說明 |
---|---|
locale -a | grep zh_TW | 回傳值:該命令會列出系統中所有可用的中文語言環境
|
2)安裝中文語言環境
如果上一步檢查出,系統未安裝中文語言環境,請根據你的伺服器網路環境,安裝中文語言環境。
伺服器 | 操作 |
---|---|
外網 |
|
內網 | 1)下載kde-l10n-Chinese安裝包
2)安裝語言環境
|
2.2 設定中文為預設語言環境
伺服器系統中安裝了中文語言環境後,還需要將其設定為預設語言環境。
1)查看預設語言環境是否是中文
命令 | 說明 |
---|---|
locale | 回傳值:將顯示當前的語言環境變數,其中 LANG 表示預設字元編碼
|
2)設定中文為預設語言環境
臨時方法無需重啟Linux系統,只需要關閉重新開啟終端即可。
永久方案需要重啟Linux系統,請按需選擇。
臨時方案 | 1)登入終端 開啟終端,並使用管理者權限登入到系統。 2)設定預設語言環境
3)重新存取終端
4)確認設定成功
|
永久方案 | 1)登入終端
2)修改配置
3)儲存檔案
4)重啟Linux系統
5)確認設定成功
|
3. 安裝缺失字體
本文以 CentOS 系統為例。其他 Linux 版本安裝步驟有所不同,請根據你的系統需求自行調整。
1)確認範本顯示異常的字體。
2)先為伺服器安裝字體管理工具,才能安裝字體。
3)自行獲取字體檔案,將字體安裝到Linux、Tomcat、JDK中。
3.1 檢查缺失字體
1)檢查缺失字體
使用設計器開啟有問題的範本檔案。查看有問題的字體部分,確認可能缺失的字體。例如缺失黑體。
2)獲取字體檔案
請從信任的來源獲取所需的字體檔案,帆軟不提供此部分資源。
通常字體檔案是以 .ttf 或 .otf 擴展名結尾的檔案。
3.2 安裝字體管理工具
如需在Linux系統安裝字體,必須確定系統中已有字體管理工具。
請根據你的伺服器網路環境,選擇合適的方式安裝字體管理工具。
伺服器 | 操作 |
---|---|
外網 | 1)安裝字體渲染庫
2)安裝字體目錄索引生成工具
|
內網 | 1)下載fontconfig和ttmkfdir安裝包
2)安裝字體管理工具
|
3.3 安裝字體-Linux
本範例將字體安裝到/usr/local/share/fonts目錄下,該目錄一般需要較高使用者權限方可安裝,請酌情調整。
步驟 | 操作 | |
---|---|---|
1 | 準備字體檔案 | 請從信任的來源獲取所需的字體檔案,帆軟不提供此部分資源 通常字體檔案是以 .ttf 或 .otf 擴展名結尾的檔案 |
2 | 上傳字體檔案 |
sudo mkdir -p /usr/local/share/fonts/myfonts
chmod -R 755 /usr/local/share/fonts/myfonts
將準備的字體檔案上傳到該資料夾中 |
3 | 更新字體快取 |
|
4 | 驗證字體安裝 |
|
3.4 安裝字體-Tomcat&JDK
步驟 | 操作 | |
---|---|---|
1 | 準備字體檔案 | 請從信任的來源獲取所需的字體檔案,帆軟不提供此部分資源 通常字體檔案是以 .ttf 或 .otf 擴展名結尾的檔案 |
2 | 關閉工程 | 請參考「關閉或重啟FineReport工程」文檔,關閉工程 |
3 | 上傳字體檔案 | 1)將字體檔案上傳至%Tomcat_HOME%/webroot/WEB-INF/fonts資料夾中
2)將字體檔案上傳至%JDK_HOME%/jre/lib/fonts資料夾中
|
4 | 重啟工程 | 請參考「關閉或重啟FineReport工程」文檔,啟動工程 |