geek
61bff7beac
- 启用首页副标题（打字机效果） - 修复 nav.logo 被 theme_config 空值覆盖导致不显示的问题 - 头像改为 /images/core.jpg - 重做 logo：去白底并圆形内部填白 - 新增 Markdown 使用指南，整理文章图片到对应目录
136 lines
5.6 KiB
YAML
136 lines
5.6 KiB
YAML
# ============================================================
|
|
# Butterfly 主题配置文件
|
|
# 官方文档: https://butterfly.js.org/
|
|
# ============================================================
|
|
|
|
# ==================== 导航栏 ====================
|
|
# 顶部导航菜单项 (图标来自 Font Awesome)
|
|
nav:
|
|
logo: /images/aaaa.png # Logo 图片 URL (留空则显示站点标题)
|
|
display_title: true # 是否显示站点标题
|
|
|
|
# 站点头像（侧边栏/关于页显示，覆盖主题默认）
|
|
avatar:
|
|
img: /images/core.jpg # 头像图片路径
|
|
effect: false # 鼠标悬停旋转效果
|
|
|
|
menu:
|
|
首页: / || fas fa-home
|
|
归档: /archives/ || fas fa-archive
|
|
分类: /categories/ || fas fa-folder-open
|
|
标签: /tags/ || fas fa-tags
|
|
关于: /about/ || fas fa-heart
|
|
|
|
# ==================== 首页副标题 ====================
|
|
# 首页大标题下方的副标题（打字机效果）
|
|
subtitle:
|
|
enable: true # 是否显示首页副标题
|
|
effect: true # 是否启用打字机动画
|
|
source: 4 # 1:hitokoto 2:yiyan 3:今日诗词 4:固定文本(取自下方 sub)
|
|
sub:
|
|
- 何年是歸日，雨淚下孤舟。 # 固定文本模式下的副标题内容
|
|
typed_option: # 打字机动画参数 (effect 为 true 时生效)
|
|
loop: true
|
|
showCursor: false
|
|
|
|
# ==================== 首页封面 ====================
|
|
# 封面大图 / 横幅设置
|
|
index:
|
|
banner:
|
|
enable: true # 是否开启首页封面
|
|
img: https://api.btstu.cn/sjbz/api.php # 封面图片 URL (随机二次元图)
|
|
|
|
# ==================== 主题配色 ====================
|
|
theme_color:
|
|
enable: true # 是否启用自定义配色
|
|
main: '#2D8CF0' # 主色调 (蓝色)
|
|
paginator: '#2D8CF0' # 分页器颜色
|
|
button_hover: '#EE2C50' # 按钮悬停颜色
|
|
|
|
# ==================== 文章卡片样式 ====================
|
|
# 首页文章列表的显示方式
|
|
card:
|
|
enable: true # 启用卡片样式
|
|
display: spacious # 布局: spacious(宽松) / compact(紧凑)
|
|
margin: 30px # 卡片间距
|
|
|
|
# ==================== 侧边栏 ====================
|
|
sidebar:
|
|
enable: true # 是否显示侧边栏
|
|
position: right # 位置: left / right
|
|
widgets: # 侧边栏组件
|
|
- type: recent_posts # 最新文章
|
|
limit: 5 # 显示篇数
|
|
- type: tags # 标签云
|
|
limit: 10
|
|
|
|
# ==================== 页脚 ====================
|
|
footer:
|
|
enable: true # 是否显示页脚
|
|
since: 2026 # 建站年份
|
|
|
|
# ==================== 社交链接 ====================
|
|
social:
|
|
GitHub: https://github.com/ || fab fa-github
|
|
|
|
# ==================== 文章设置 ====================
|
|
post:
|
|
meta:
|
|
date: true # 显示发布日期
|
|
updated: true # 显示更新日期
|
|
categories: true # 显示分类
|
|
copyright: true # 文章末尾显示版权信息
|
|
|
|
# ==================== 搜索 ====================
|
|
search:
|
|
use: local_search
|
|
placeholder: 搜索文章
|
|
local_search:
|
|
preload: false
|
|
top_n_per_article: 1
|
|
unescape: false
|
|
pagination:
|
|
enable: false
|
|
hitsPerPage: 8
|
|
|
|
|
|
# ==================== 评论 ====================
|
|
comments:
|
|
use: "" # 评论系统 (空=不启用, 可选: twikoo/waline/giscus 等)
|
|
|
|
# ============================================================
|
|
# 以下为自定义美化配置
|
|
# ============================================================
|
|
|
|
# ==================== 自定义 CSS/JS 注入 ====================
|
|
inject:
|
|
head:
|
|
- <link rel="stylesheet" href="/css/custom.css"> # 引入自定义样式
|
|
|
|
# ==================== 代码块样式 ====================
|
|
code_blocks:
|
|
theme: pale night # 代码高亮主题
|
|
macStyle: true # 显示 macOS 风格圆点
|
|
height_limit: 800 # 代码块最大高度 (px), 超出可滚动
|
|
word_wrap: true # 长代码自动换行
|
|
copy: true # 显示复制按钮
|
|
language: true # 显示代码语言标签
|
|
shrink: false # 是否默认折叠代码块
|
|
fullpage: false # 是否允许全屏查看代码
|
|
|
|
# ==================== 页面背景图片设置 ====================
|
|
disable_top_img: false # 是否禁用所有页面的顶图
|
|
default_top_img: transparent # 默认顶图 (透明=无图)
|
|
index_img: transparent # 首页顶图
|
|
archive_img: false # 归档页顶图 (false=不显示)
|
|
tag_img: transparent # 标签页顶图
|
|
tag_per_img: transparent # 单个标签页顶图
|
|
category_img: transparent # 分类页顶图
|
|
category_per_img: transparent # 单个分类页顶图
|
|
footer_img: transparent # 页脚背景图
|
|
|
|
background: https://image.987119.xyz/uploads/2026/07/18c0005c5dac2c14635.webp # 全站背景图
|
|
|
|
index_site_info_top: 200px # 首页站点信息距顶部距离
|
|
index_top_img_height: 400px # 首页封面图高度
|