1 简介

1.1 背景

  • 个人非常喜欢Joe主题，但无法满足我的部分需求，作为PHP、JS小白，改动很吃力

  • Joe再续前缘主题是目前最符合我审美的主题，但存在两个严重BUG：1）启用后无法切换其他主题，会提示插件冲突；2）启用MarkdownParse插件时，会导致代码块无法正常渲染（我非常需要LaTeX公式支持，MarkdownParse很好用且还在更新）

  • Typecho默认主题由官方提供，（对AI来说）设计简单且易懂，又包含了博客网站该有的基本需求，很适合拿来修改

  • Rains主题基于默认主题进行修改，过程中大量使用了GitHub Copilot，几乎每一行代码都是AI写的（感谢科技的进步）

  • 使用了Joe主题部分静态资源，如图文卡片中的缩略图等；展现形式也进行了一定的参考

  • 作者Washy本人网站采用了该主题，可视为演示站

1.2 功能

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

2 更新记录

v1.3

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

v1.2

  • 2025/06/17 发布
  • 主要完善了HFCOM页面的功能

v1.1

  • 2025/06/16 发布
  • 紧急修复诸多手机端适配问题

v1.0

  • 2025/06/16 发布

3 可能会更新的内容

  • 独立页面增加侧边栏
  • 页面没有一键回到顶部按钮
  • 侧边栏 - 作者卡片过于单调，且头像加载不出来时，存在尺寸变动问题
  • 侧边栏 - 文章目录不会随者阅读进度高亮显示
  • 手机端访问 - 文章页LaTeX公式经常性超出页面最大宽度，即公式字号不会自动缩放
  • 手机端访问 - 增加侧边导航条，或者将当前菜单导航条修改到侧边
  • 手机端访问 - HFCOM页面尺寸变形且按钮被遮挡

称之为可能：

  • 一是作者很懒，未必会真的修改（现在的样子基本满足我的需求+更想把时间和精力放在写博客上）
  • 二是作者是PHP、CSS、JS小白，未必有能力修改（AI能改的我才能改）

万一哪天真的修改了，会放到更新记录里面。