# ============================================================
# 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              # 首页封面图高度