164 lines
2.6 KiB
Markdown
164 lines
2.6 KiB
Markdown
# 📜 添加古风官职字符到字体子集
|
|
|
|
## 📋 需要添加的字符
|
|
|
|
古风官职文本中的特殊字符（可能缺失）：
|
|
|
|
```
|
|
— 庶 民 太 尉 谏 给 簿 司 户 录 丞 判 殿
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 方法1：运行Python脚本（推荐）
|
|
|
|
```bash
|
|
cd E:\GitHub\blog
|
|
|
|
# 运行合并脚本
|
|
python scripts/merge_ancient_chars.py
|
|
|
|
# 重新生成字体子集
|
|
python scripts/subset-font-safe.py
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 方法2：手动添加字符
|
|
|
|
### 步骤1：编辑字符列表
|
|
|
|
打开文件：`themes/Ying/static/font/used_chars.txt`
|
|
|
|
在文件末尾添加：
|
|
|
|
```
|
|
—庶民太尉谏给簿司户录丞判殿
|
|
```
|
|
|
|
### 步骤2：重新生成字体子集
|
|
|
|
```bash
|
|
cd E:\GitHub\blog
|
|
|
|
# 重新生成字体子集
|
|
python scripts/subset-font-safe.py
|
|
```
|
|
|
|
---
|
|
|
|
## 🧪 验证添加成功
|
|
|
|
### 检查字符列表
|
|
|
|
```bash
|
|
# 查看字符列表
|
|
type themes\Ying\static\font\used_chars.txt
|
|
|
|
# 搜索特殊字符
|
|
findstr "—" themes\Ying\static\font\used_chars.txt
|
|
```
|
|
|
|
### 检查字体文件
|
|
|
|
```bash
|
|
# 查看字体文件大小
|
|
dir themes\Ying\static\font\zql-v2-subset.*
|
|
```
|
|
|
|
**预期：** 字体文件大小应该略有增加（包含新字符）
|
|
|
|
---
|
|
|
|
## 📊 预期效果
|
|
|
|
### 字体大小变化
|
|
|
|
| 指标 | 添加前 | 添加后 | 变化 |
|
|
|------|--------|--------|------|
|
|
| **字符数** | 2,485 | ~2,500 | +15 |
|
|
| **字体大小** | 757KB | ~760KB | +3KB |
|
|
|
|
**说明：** 增加15个字符，字体大小增加约3KB（可忽略）
|
|
|
|
---
|
|
|
|
## 🎯 使用场景
|
|
|
|
### 古风官职系统
|
|
|
|
这些字符用于：
|
|
|
|
```
|
|
正一品 太师 2000
|
|
从一品 太尉 1400
|
|
正二品 参知政事 1050
|
|
...
|
|
正九品 主簿 15
|
|
从九品 司户参军 5
|
|
— 庶民 0
|
|
```
|
|
|
|
**应用场景：**
|
|
- 古风游戏
|
|
- 历史题材文章
|
|
- 等级系统展示
|
|
|
|
---
|
|
|
|
## 💡 后续优化
|
|
|
|
### 如果还有其他特殊字符
|
|
|
|
1. 收集所有需要的特殊字符
|
|
2. 添加到 `used_chars.txt`
|
|
3. 重新运行字体子集化
|
|
|
|
### 自动化
|
|
|
|
**GitHub Actions会自动处理：**
|
|
- 当你发布包含这些字符的文章时
|
|
- 自动重新生成字体子集
|
|
- 自动部署到UpYun
|
|
|
|
---
|
|
|
|
## 🔄 回滚方案
|
|
|
|
### 如果出现问题
|
|
|
|
```bash
|
|
# 恢复原始字符列表
|
|
git checkout themes/Ying/static/font/used_chars.txt
|
|
|
|
# 重新生成字体子集
|
|
python scripts/subset-font-safe.py
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ 完成确认
|
|
|
|
### 检查清单
|
|
|
|
- [ ] 字符已添加到 used_chars.txt
|
|
- [ ] 字体子集已重新生成
|
|
- [ ] 字体文件大小略有增加
|
|
- [ ] 新字符可以正常显示
|
|
|
|
### 测试
|
|
|
|
```bash
|
|
# 启动Hugo
|
|
hugo server -D
|
|
|
|
# 访问包含古风官职的页面
|
|
# 检查字符是否正常显示
|
|
```
|
|
|
|
---
|
|
|
|
**添加古风官职字符指南完成！** 🎉
|
|
|
|
**按照指南操作即可完成字符添加！**
|