vcg

站点与语言

• 语言与翻译：通过 site.translate.enable 开启浏览器端翻译，还可以选择翻译服务并配置语言自动识别。

• 自定义字体：在 site.font 中填写字体 CSS 链接或本地文件路径，即可使用自己的字体。

视觉效果

• 主题颜色：调整 site.themeColor.hue（0～360）即可改变博客的主色调。

• 壁纸模式：可选择 banner、fullscreen 或 none。使用多张壁纸时，还能开启 carousel 轮播和 kenBurns 运镜效果。

• 水波纹效果：通过 site.wallpaper.banner.waves.enable 控制横幅底部的动态水波纹。

• 粒子特效：通过 particle.enable 开启背景中的漂浮粒子。

界面

• 导航栏透明度：将 site.wallpaper.banner.navbar.transparentMode 设置为 semi、full 或 semifull。

• 侧边栏组件：在 sidebar.components 中调整 profile、announcement、categories、tags、toc 和 statistics 等组件的顺序与显示状态。

GitHub 仓库卡片

你可以插入链接到 GitHub 仓库的动态卡片。页面加载时，卡片会通过 GitHub API 获取仓库信息。

使用 ::github{repo="Spr-Aachen/Twilight"} 即可创建一张 GitHub 仓库卡片。

1
::github{repo="Spr-Aachen/Twilight"}

音乐卡片

• 在线音乐

1
::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1390882521"}

• 本地音乐

1
::music{title="深海之息" artist="Youzee Music" cover="https://p1.music.126.net/PhKOqFtljgHDDpKYM2ADUA==/109951169858309716.jpg" audio="assets/music/深海之息.m4a" lrc="assets/music/深海之息.lrc"}

提示块

支持以下提示块类型：note、tip、important、warning、caution。

Note

即使快速浏览，也值得留意的信息。

Tip

能够帮助读者更顺利完成操作的补充信息。

Important

顺利完成操作所必需的重要信息。

Warning

存在潜在风险，需要读者立即注意的内容。

Caution

某项操作可能造成的不良后果。

• 基本语法

  1
  :::note
  2
  即使快速浏览，也值得留意的信息。
  3
  :::
  4
  
  5
  :::tip
  6
  能够帮助读者更顺利完成操作的补充信息。
  7
  :::

• 自定义标题

  提示块的标题可以自行设置。

  自定义标题

  这是一条带有自定义标题的提示。

  1
  :::note[自定义标题]
  2
  这是一条带有自定义标题的提示。
  3
  :::

• GitHub 语法

  Tip

  同样支持 GitHub 提示块语法。

  1
  > [!TIP]
  2
  > 同样支持 GitHub 提示块语法。

• 剧透内容

  可以在正文中加入需要点击后才显示的剧透内容，其中同样支持 Markdown 语法。

  这段内容 默认会被 隐藏！

  1
  这段内容 :spoiler[默认会被 **隐藏**]！

更多细节请参阅 Twilight 文档。