Rain Log

站点与本地化#

• 语言与翻译：通过 site.translate.enable 开启客户端翻译功能，可选择不同翻译服务并配置自动检测用户语言。

• 自定义字体：在 site.font 下提供字体 CSS 链接或文件路径，即可添加自定义字体。

视觉效果#

• 主题色：通过调整 site.themeColor.hue（范围 0~360）更改博客主色调。

• 壁纸模式：可选 banner（横幅）、fullscreen（全屏）或 none（纯色）。支持多张壁纸轮播，并可开启 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"} 即可创建仓库卡片：

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

音乐卡片#

• 在线模式

1
::music{meting="https://api.i-meto.com/meting/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"}

提示块（Admonitions）#

支持以下五种类型：note tip important warning caution

NOTE

这里是普通说明信息，即使快速浏览也应注意。

TIP

这是可选的技巧提示，帮助你更顺利地完成操作。

IMPORTANT

这是关键信息，用户必须了解才能继续。

WARNING

这是重要警告，提示存在潜在风险。

CAUTION

这是危险提示，说明某操作可能带来的负面后果。

• 基础语法

  1
  :::note
  2
  这里是普通说明信息，即使快速浏览也应注意。
  3
  :::
  4
  
  5
  :::tip
  6
  这是可选的技巧提示，帮助你更顺利地完成操作。
  7
  :::

• 自定义标题

  提示块的标题可以自定义：

  我的自定义标题

  这是一个带自定义标题的 note 提示块。

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

• GitHub 风格语法

  TIP

  也支持 GitHub 风格的提示块语法。

  1
  > [!TIP]
  2
  > 也支持 GitHub 风格的提示块语法。

• 折叠文字（Spoiler）

  可以在文章中隐藏部分文字，支持 Markdown 语法。

  这段内容 被隐藏了 点击查看 ！

  1
  这段内容 :spoiler[被隐藏了 **点击查看**] ！

更多详情请查阅 官方文档。