Skip to content

样式设置 ​

样式设置控制 WarmIsland 主题的全局视觉表现,包括配色方案、强调色、圆角风格、容器宽度、动画效果以及自定义 CSS。通过这些配置,你可以快速打造出独一无二的站点外观。

配置项一览 ​

配置项类型默认值说明
color_scheme单选system配色方案:system / light / dark
color_palette下拉warm-island主题配色(官方预设调色板,含深浅两套色板)
accent_color颜色—自定义强调色;留空跟随所选主题配色
border_radius下拉medium圆角风格:small / medium / large
layout_container_width下拉medium容器宽度:narrow / medium / wide
animation_enabled开关true全局动画总开关
animation_breath开关true呼吸动画效果
animation_scroll_reveal开关true滚动渐入动画
click_effect_enabled开关false鼠标点击效果总开关
click_effect_type下拉values点击效果类型(8 种效果 + 关闭,仅在总开关开启时显示)
custom_css代码—自定义 CSS 代码

详细说明 ​

配色方案(color_scheme) ​

控制站点的明暗模式,提供三种选择:

值说明
system跟随系统偏好,自动适配用户操作系统的深色/浅色模式设置
light始终使用浅色模式
dark始终使用深色模式

TIP

选择 system 时,主题会监听操作系统的 prefers-color-scheme 媒体查询,实时响应用户的系统设置变化。访问者也可以通过导航栏的主题切换按钮手动覆盖当前模式。

主题配色(color_palette) ​

v1.2.0 起主题内置配色系统,提供 11 套官方预调配色,每套均包含浅色与深色两套完整色板(背景、文字、分隔线、强调色、玻璃拟态、阴影色调等会整体联动):

值名称色彩倾向
warm-island暖屿 · 赤陶(默认)暖橘陶土,米白纸感
matcha抹茶清新草绿,米绿纸感
indigo黛蓝沉稳蓝调,冷白纸感
sakura樱粉柔和粉调,樱白纸感
violet暮紫温柔紫调,淡紫纸感
sea海盐青碧蓝绿,浅青纸感
amber琥珀蜂蜜金黄,暖黄纸感
plum梅酒酒红梅紫,粉白纸感
graphite石墨中性灰黑,极简无彩
cocoa可拿铁咖啡可可,奶咖纸感
azure天青明快天蓝,浅蓝纸感

WARNING

下方「强调色」留空时,将使用所选配色自带的强调色。老站点升级前如果保存过强调色(默认 #d4764e),切换配色后强调色不会变化——清空强调色并保存即可恢复跟随配色。

强调色(accent_color) ​

强调色是 WarmIsland 主题的灵魂,它会影响全站以下元素的颜色:

  • 链接悬停色
  • 按钮背景色
  • 标签高亮色
  • 进度条颜色
  • 选中状态颜色
  • Hero 区域渐变色的组成部分

留空时跟随上方「主题配色」自带的强调色(暖屿·赤陶配色即 #d4764e 暖橘色)。

TIP

选择强调色时,建议同时考虑浅色和深色模式下的可读性。可以在 CSS 变量 页面查看所有受影响的变量,进行更精细的调整。

yaml
# 常见强调色参考
accent_color: "#d4764e"  # 暖橘(默认)
accent_color: "#6366f1"  # 靛蓝
accent_color: "#10b981"  # 翠绿
accent_color: "#f43f5e"  # 玫红
accent_color: "#8b5cf6"  # 紫罗兰

圆角风格(border_radius) ​

控制全站组件的圆角大小,影响卡片、按钮、输入框等元素:

值说明适用场景
small小圆角,偏硬朗风格技术博客、极简风格
medium中等圆角,平衡美观与严谨通用场景(默认)
large大圆角,柔和亲切生活博客、个人日记

容器宽度(layout_container_width) ​

控制页面主内容区域的最大宽度:

值说明
narrow窄容器,适合以文字阅读为主的站点
medium中等宽度,兼顾阅读体验与信息密度(默认)
wide宽容器,适合图片较多的站点或需要更大展示空间的场景

动画效果 ​

WarmIsland 提供了丰富的动画效果,所有动画都可以独立开关:

全局动画总开关(animation_enabled) ​

关闭后,以下所有动画效果将一并禁用。适合追求极致性能或偏好静态页面的用户。

呼吸动画(animation_breath) ​

启用后,Hero 区域的背景光球会产生缓慢的呼吸脉动效果,营造温暖柔和的氛围感。光球的大小和透明度会周期性变化。

滚动渐入(animation_scroll_reveal) ​

启用后,页面元素在滚动进入视口时会以淡入+上移的方式渐次出现,增强浏览的节奏感。

TIP

滚动渐入动画基于 Intersection Observer API 实现,对性能影响极小。如果页面内容较多,建议保持开启以提升浏览体验。

鼠标点击效果(click_effect_enabled / click_effect_type) ​

click_effect_enabled 默认关闭;开启后 click_effect_type 才会显示,可选 8 种效果: 社会主义核心价值观、随机彩色爱心、烟花、烟花波纹、粒子、星星、星星拖尾、粒子拖尾, 另可选「关闭」。特效在访客点击时由浏览器本地绘制,不加载远程脚本、不发送任何数据。

自定义 CSS(custom_css) ​

在此处编写自定义 CSS 代码,会注入到全站所有页面的 <style> 标签中。可以用来覆盖主题默认样式或添加全新样式。

css
/* 示例:自定义卡片悬停效果 */
.post-card:hover {
  transform: translateY(-4px);
  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
}

/* 示例:隐藏特定元素 */
.hero-scroll-indicator {
  display: none;
}

TIP

如需更系统地自定义样式,推荐使用 CSS 变量 方式,只需修改变量值即可影响全站,无需逐个覆盖选择器。详见 自定义 CSS 页面。

相关页面 ​

基于 GPL-3.0 许可发布