1 简介

1.1 背景

  • 个人非常喜欢Joe主题，但无法满足我的部分需求，且去熟悉整个主题结构从而自定义改动有些吃力
  • Typecho默认主题由官方提供，设计简单且易懂，包含了博客网站该有的大部分需求，很适合拿来修改
  • Rains主题基于默认主题进行修改，实现过程中大量使用了GitHub Copilot和腾讯元宝
  • 使用了Joe主题部分静态资源，如图文卡片中的缩略图等；展现形式也进行了一定的参考
  • 作者Washy网站采用了该主题，可视为演示站

1.2 功能

  • 首页双栏图文卡片样式展示文章列表，卡片meta包含发表日期、浏览量、点赞量、评论量和分类。浏览量、点赞量字段与原版Joe主题一致，不必担心从Joe主题更换过来数据丢失的问题。
  • 文章页增加点赞、打赏按钮，且可在后台独立设置启用与否；行间代码采用highlight实现代码高亮
  • 文章页宽度、p标签字号与Typora GitHub主题一致，保证从Typora中直接复制时不会对排版改变太大
  • 菜单导航条增加作者登录、明/暗切换按钮
  • 侧边栏支持首页、文章页单独开关；并支持在左侧或右侧；侧边栏项目可自行选择开关
  • 后台设置采用了Typecho-Options框架
  • 头像源更换为cn.cravatar.com，同时支持后台自由设置
  • 重写了评论区结构，使其更容易自定义CSS样式

2 更新记录

2026/02/09 - v.16

  • 重写评论区threadedComments()函数，让结构更加简洁，并更换头像源为国内源
  • 重写评论区样式，父评论为卡片样式，子评论在父评论卡片中以横线分割，并取消了子评论的层级缩进
  • 重定义了明亮/黑暗模式下背景、标签、按钮等颜色，使其过度更加自然
  • 调整了post.php页面的部分设计，如面包屑、整体结构、配色等
  • 后台设置增加了点赞打赏按钮的独立开关
  • 增加了static/lib/font-awesome静态库，用于显示一些图标，后续将使用该库图标逐渐替换其它图标

2025/07/28 - v1.5

  • 修复li标签行内代码正常渲染颜色
  • 修改文章侧边栏目录编号判断方式为检测除却最后一个标题外所有标题的第一个字符是否为阿拉伯数字。如果是，则不会添加编号，如果不是，则会根据大纲级别自动添加编号
  • 重构并优化了HFCOM页面

2025/07/14 - v1.4

  • 统一了全站颜色变量，使得配置明亮/黑暗模式时更加方便，并去除了部分冗余代码
  • 调整了文章页点赞按钮、版权信息的位置；修复了文章页引用内字体颜色显示问题
  • 修改页面底部链接跳转为新打开一个标签页，修改Rains主题跳转链接为博客详情页
  • 修改文章卡片中文章详情页跳转为新打开一个标签页
  • 统计页面echarts引用改为本地引用；重构统计页面
  • 首页增加置顶文章，后台输入对应文章cid，多篇文章使用英文分号分隔
  • 独立页面标题下方增加元数据信息，页面底部增加版权信息
  • 精简了static/lib/文件夹，仅保留用得到的文件

2025/06/24 - v1.3

  • 文章页增加跳转编辑页面按钮；统一ul、li标签行间距；增加文章最后修改时间；修复侧边栏目录不到文章底部就会消失的问题；增加行内代码高亮显示
  • 移动端适配文章列表翻页条尺寸，隐藏右上角登陆按钮
  • 分离HFCOM页面后端服务数据文件，修复时间选择框时间默认为UT当天（原为北京时间）

2025/06/17 - v1.2

  • 主要完善了HFCOM页面的功能

2025/06/16 - v1.1

  • 紧急修复诸多手机端适配问题

2025/06/16 - v1.0

  • 首次发布

3 待优化问题汇总

  • 全局
    • 增加一键回到顶部按钮
    • 根据新的配色方案，调整所有页面的颜色调用
  • 独立页
    • 增加侧边栏
  • 文章页
    • 代码高亮样式后台可选
  • 侧边栏
    • 作者卡片过于单调，且头像加载不出来时，存在尺寸变动问题
    • 文章目录不会随者阅读进度高亮显示
  • HFCOM
    • 大屏幕显示时，底部栏未处于页面底部
  • 手机端访问
    • 文章页LaTeX公式经常性超出页面最大宽度，即公式字号不会自动缩放
    • 增加侧边导航条，或者将当前菜单导航条修改到侧边