字体与主题

字体配置

Vergil 支持自定义字体，配置在 src/data/site-config.ts 的 fonts 字段中。

默认字体

fonts: {
    display: 'maokenZhuyuanTi',  // 标题字体
    body: 'lxgwwenkai',          // 正文字体
    ui: 'maokenZhuyuanTi',       // UI 字体
    mono: 'monoFonts'            // 代码字体
}

添加自定义字体

1. 将字体文件放入 public/fonts/ 目录
2. 在 src/data/site-config.ts 的 fontsRegistry 中注册：

fontsRegistry: {
    myFont: {
        cssName: 'My Font',
        family: 'sans-serif',
        path: '/fonts/my-font.woff2',
        format: 'woff2'
    }
}

3. 在 fonts 配置中引用：

fonts: {
    display: 'myFont',
    body: 'myFont'
}

单篇文章自定义字体

在文章信息头中覆盖字体：

---
title: 特殊排版文章
fonts:
  display: 'maokenZhuyuanTi'
  body: 'lxgwwenkai'
---

主题切换

Vergil 支持暗色/亮色模式切换，点击网站右上角的太阳/月亮图标即可切换。

配色方案

Vergil 提供 11 种配色方案（A-K），在主题切换面板中选择：

• 点击右上角主题图标
• 选择喜欢的配色方案
• 系统会自动保存你的选择

暗色模式

在配色方案旁边有单独的暗色/亮色切换开关，独立于配色方案。

默认主题

如果你想设置网站默认的配色方案和暗色模式，可以在 src/data/site-config.ts 中配置（高级用法）。