自建站以来,本站一直使用 solstice23 大佬开发的 Argon 主题,尽管原主题在三年前已经进入相对“冻结”的维护期,没有太多功能性更新,仅进行前端代码的重构,但不得不承认,无论是在外观设计、细节打磨还是功能实现方面,Argon主题都是一流的——就连许多主题都不具备的「评论编辑历史」功能它都内建了。
期间,GitHub 上依然有不少热心开发者持续向 Argon 的 dev 分支提交 PR,用于修复 bug 或尝试性地加入新功能,但Mimosa 作为一位喜爱折腾的博主,已经对该主题进行过数十次大大小小的改动了(debug or 添加新功能)。
(bigBulen/Argon-for-Mimosa: A personalized fork of the Argon WordPress theme)
「Commit 千万次,备份第一位。
修改无备份,回滚两行泪。」
一些FAQ
1.为什么要公开这个魔改版本?
自去年起,不少 argon 主题爱好者私下或在评论中问及本主题修改细节。考虑到这些需求,Mimosa 决定将此已修改重构(即这个博客使用的主题)完整公开。
2.与原主题的关系?
- 首先,这并不是对原主题的不尊重,相反,正是因为 Argon 原本足够优秀才有修改价值(认真脸.jpg
- 本版本是原主题的部分重构+轻度魔改。
- 本版本直接在原主题目录改源码,一旦在后台选择“自动更新”或手动恢复原主题,所有修改内容将 被覆盖、丢失甚至出错。因此在此主题中注释掉了自动更新(可在
functions.php
中恢复)。 - 为了安全与版本控制,我会将本版本从原主题中分离出来,作为一个独立的 Fork 版本,未来将由我个人自行维护更新
3.未来的计划?
- 使用GitHub进行版本控制。
- 针对当前 1.x 大版本维护;若原主题做小规模更新,会同步修复。
- 如原作者发布 2.0、大规模功能性更新,本项目或将重定位(废弃)。
只要我Mimosa没有放弃对折腾博客的爱好且使用Argon主题,Argon for Mimosa 将持续迭代有趣功能(或者整合其它大佬制作的功能、原主题的pr更新),详见下文。
版本介绍
正在实现的功能:
- 背景跟随鼠标的视差移动效果
- 更加适配Argon主题的自研问卷&表单系统(待定)
- 追番、galgame列表(待定?)
文章打标签- 修复已知bug:部分文章评论置顶无效
[最新]2025-07-22
新增功能(相对于原主题):
- 可调节背景亮度*
- 页脚字数统计+与文学作品比较字数*
- 实况照片(在文章编辑器中使用)
- 弹窗功能*
- 挂灯笼*
- 开启悼念色*
- 归档页面添加说说
- 首页文章卡片可部分显示文章摘要(详情见下文)
- 左侧栏显示时钟卡片
- 纪念日(主题美化)
- 说说同步rss*
- 密码提示(在文章编辑器中使用)
- 标题锚点
- 左下角音乐播放器(见下文)
注:标*的项目均可在Argon主题设置中管理
优化:
- 文章卡片头图半透明化(防止标题不明显)
- 顶栏半透明渐变效果
- 部分ui的半透明遮罩效果
- 替换全部http为https
- 头像优化
- 若干css字体颜色显示问题
- 若干日间、夜间模式显示问题
[必读]部分功能说明
2025-07-22 v1.0.0
1.时钟&纪念日
注:本功能受隔壁博主ZeroCounter的启发。当然,不止生日,节日、有意义的日子都可以设置的。
- 在侧边栏新增一卡片,根据
birth.json
中配置的纪念日,自动切换当天的壁纸,并将 Banner 副标题显示为拼接“name_cn+suffix”两个变量 - 非生日当天自动回落到主题默认的背景与 Banner 文案,同时该卡片恢复为时钟(左图)。
- 已自动处理深/浅色模式下的文字颜色切换,无需额外配置。
在主题目录/character_collections/birth.json中可配置纪念日显示信息。具体格式:
[
{
"id": "f01",
"birthday": "07-21",
"name_cn": "二阶堂 真红(前缀)",
"suffix": ",生日快乐!(后缀)",
"name_jp": "这是卡片中括号里的别名",
"quote": "这是引言",
"description": "描述,即卡片中最底端的正文",
"alpha" : 0.65(大背景透明度,防止图片太亮以至于文章不明显;填入0~1的小数,1为不透明)
}
]
如:id设置为“f01”,就在argon/character_collections/img/中添加f01.jpg,这张图不仅是日/夜间壁纸,还是卡片的预览图。
id可为任意形式。
日期(birthday字段)必须为yy-dd格式
若不想显示纪念日,birth.json留空即可。
请注意:壁纸仅限更换日间、夜间壁纸,不更换banner壁纸。
2.头图遮罩
将文章卡片的预览图填一层半透明的遮罩,防止影响标题阅读。
透明度可到style.css末尾的头图遮罩注释处按照标识改动。
3.添加实况照片
若需添加实况照片,仅需在文章编辑中选择,依次上传图片和视频即可。(需用工具将原实况照片分离)
4.归档页面添加说说(碎碎念)文章
详情见此文章:Argon主题:文章归档页面添加说说类型 – Mimosa的小站(不需要此功能把相关代码删除即可)
5.首页摘要优化
这里优化了首页的文章卡片,实现了若有人工摘要则显示,若无人工摘要则不显示。
详情见此文章:给博客食用的预制菜-首页文章只显示人工摘要,而非截取文字 * – Mimosa的小站
6.密码提示
注意:仅针对设置密码的文章有效
博客美化
详情可参见这篇文章:给博客食用的预制菜(主题改造记录) – Mimosa的小站