本指南介绍 Twilight 模板中可用的高级自定义选项和功能,从全局配置到专门的 Markdown 扩展。
全局配置
twilight.config.yaml 文件是博客配置的核心。以下是一些您可以调整的高级设置:
站点与本地化
-
语言与翻译:使用
site.translate.enable启用客户端翻译。您可以选择不同的翻译服务并配置自动检测。 -
自定义字体:通过在
site.font下提供 CSS 链接或文件路径来添加您自己的字体。
视觉效果
-
主题色:通过调整
site.themeColor.hue(0-360)来更改博客的主色调。 -
壁纸模式:在
banner、fullscreen或none之间选择。您还可以启用carousel来展示多张壁纸,并配合kenBurns效果。 -
波浪效果:使用
site.wallpaper.banner.waves.enable在横幅上切换动画水波纹效果。 -
粒子效果:使用
particle.enable在背景中启用浮动粒子。
UI
-
导航栏透明度:在
semi、full或semifull之间调整site.wallpaper.banner.navbar.transparentMode。 -
侧边栏组件:在
sidebar.components中重新排序或切换侧边栏组件,如profile、announcement、categories、tags、toc和statistics。
Markdown 扩展
GitHub 仓库卡片
您可以添加链接到 GitHub 仓库的动态卡片,页面加载时会从 GitHub API 获取仓库信息。
使用代码 ::github{repo="Spr-Aachen/Twilight"} 创建 GitHub 仓库卡片。
::github{repo="Spr-Aachen/Twilight"}音乐卡片
- 在线音乐
::music{meting="https://api.i-meto.com/meting/api?server=netease&type=song&id=1390882521"}- 本地音乐
::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操作的潜在负面后果。
-
基本语法
:::note突出显示用户即使快速浏览也应注意的信息。::::::tip帮助用户更成功的可选信息。::: -
自定义标题
提示框的标题可以自定义。
我的自定义标题这是一个带有自定义标题的提示框。
:::note[我的自定义标题]这是一个带有自定义标题的提示框。::: -
GitHub 语法
TIP
GitHub 语法 也受支持。
> [!TIP]> GitHub 语法也受支持。 -
剧透隐藏
您可以为文本添加剧透隐藏效果。隐藏的文本也支持 Markdown 语法。
内容
被隐藏了 哇哦 !内容 :spoiler[被隐藏了 **哇哦**]!
更多详情,请查看 文档。
部分信息可能已经过时
Mojito