44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
|
# PDF 中文字体离线文件下载记录
|
|||
|
|
|
|||
|
|
## 保存路径确认
|
|||
|
|
|
|||
|
|
- 实施记录保存路径：`docs/reports/implementation/2026-05-11-pdf-font-offline-download.md`
|
|||
|
|
- 离线字体文件保存路径：`deploy/fonts/wqy-microhei.ttc`
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
|
|||
|
|
生产环境无法在线安装中文字体包，需要提前准备 PDF 导出使用的中文字体文件，保证生产配置项 `ccdi.report.pdf-font-path` 指向的字体可以离线放置。
|
|||
|
|
|
|||
|
|
## 修改内容
|
|||
|
|
|
|||
|
|
- 新增离线字体文件：`deploy/fonts/wqy-microhei.ttc`
|
|||
|
|
- 字体来源：Debian 官方包源 `fonts-wqy-microhei_0.2.0-beta-4_all.deb`
|
|||
|
|
- 从离线包中提取路径：`usr/share/fonts/truetype/wqy/wqy-microhei.ttc`
|
|||
|
|
|
|||
|
|
## 生产放置方式
|
|||
|
|
|
|||
|
|
生产服务器解压或上传后，将字体放到配置指定路径：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo mkdir -p /usr/share/fonts/truetype/wqy
|
|||
|
|
sudo cp wqy-microhei.ttc /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
|
|||
|
|
sudo chmod 644 /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果服务器存在 `fc-cache`，可执行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo fc-cache -fv
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 验证记录
|
|||
|
|
|
|||
|
|
- 文件大小：约 4.9M
|
|||
|
|
- 文件类型：TrueType font collection data
|
|||
|
|
- SHA256：
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
2420e8078af796b19a3f6ef13de527a1a91c1e7171eea115926c614ced1009b3
|
|||
|
|
```
|
|||
|
|
|