Files
blog/docs/古风官职字符添加指南.md
T
Vaica 2684fec493 feat: 添加古风官职字符到字体子集
- 添加破折号(—)
- 添加庶民、太尉等特殊字符
- 字体大小增加3KB(757KB → 760KB)
2026-06-03 13:53:12 +08:00

2.6 KiB

📜 添加古风官职字符到字体子集

📋 需要添加的字符

古风官职文本中的特殊字符(可能缺失):

— 庶 民 太 尉 谏 给 簿 司 户 录 丞 判 殿

🚀 方法1:运行Python脚本(推荐)

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:重新生成字体子集

cd E:\GitHub\blog

# 重新生成字体子集
python scripts/subset-font-safe.py

🧪 验证添加成功

检查字符列表

# 查看字符列表
type themes\Ying\static\font\used_chars.txt

# 搜索特殊字符
findstr "—" themes\Ying\static\font\used_chars.txt

检查字体文件

# 查看字体文件大小
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

🔄 回滚方案

如果出现问题

# 恢复原始字符列表
git checkout themes/Ying/static/font/used_chars.txt

# 重新生成字体子集
python scripts/subset-font-safe.py

✅ 完成确认

检查清单

  • 字符已添加到 used_chars.txt
  • 字体子集已重新生成
  • 字体文件大小略有增加
  • 新字符可以正常显示

测试

# 启动Hugo
hugo server -D

# 访问包含古风官职的页面
# 检查字符是否正常显示

添加古风官职字符指南完成! 🎉

按照指南操作即可完成字符添加!