新主题已达成
ilogs
53 阅 · 2k 字 · 约 5 分钟
ilogs:一个把「阅读」当回事的 Typecho 主题
写在前面
一、先说设计取向
ilogs 是窄栏的:正文固定在 620px,左右两边的留白不是浪费,而是让眼睛不用横着跑。
下面这些细节贯穿全站:
- 数字一律用
等宽字体,日期、阅读数、评论数、页码对得整整齐齐 - 分隔线是 6px 实 / 6px 空的横向虚线,两端还会淡出,不会硬生生切断
- 强调色只有一个(默认蓝
#2563eb),什么时候该用蓝,一眼就知道 - 深浅色跟随系统,也可以手动切(右上角那个月亮)
整站的留白、字距、行高是按同一套标尺排的,所以你在任何一页都不会觉得「换了个站」。
二、阅读体验
开场动画
首次进入首页时,图标和站名会先在屏幕正中停一下,然后一起飞向左上角的页头位置,落到真实位置上时无缝换手,看不出接缝。
飞完就不再出现,同一次会话里不会再打扰你。
全站音乐播放器
页头下面那条一直在的播放器,是用 Meting API 驱动的:
- 后台填接口地址、平台、类型和歌单 ID 就行,不用改代码
- 左侧是会转的唱片,暂停时停住,播放时旋转
- 支持上一首 / 下一首 / 音量记忆 / 播放列表,状态存在本地
- 关键在最后一条:切页面不断播
图片查看器
文章、动态、相册里的图片点击后会全屏查看,加入了ViewImages图片灯箱,支持左右切换、手势缩放。不用额外装灯箱插件。
无感切换
站内跳转走 PJAX:不闪白、不重新加载、滚动位置记住。按 [kbd]Ctrl[/kbd] + [kbd]K[/kbd] 可以直接唤起站内搜索。
三、内容不止「文章」
| 形态 | 说明 |
|---|---|
| 文章 / 独立页 | 常规 Typecho 内容,支持分类、标签、缩略图 |
| 动态 | 类似说说:短文本 + 最多 9 张图,支持点赞、评论、置顶 |
| 相册 | 多张照片、逐张图注,可给相册加访问密码 |
| 友链 | 带头像、分组、描述,前台可自助提交 |
| 留言板 | 除了留言本身,还有一面全站留言者墙 |
留言墙这里有个小设计:它统计的是全站所有评论者(不是只统计留言板),按邮箱去重,谁在你博客出现过,墙上就有他一个位置。
动态还有一个细节:如果是机器人发的,时间后面会跟一个「来自微信 Bot」的小标签。
四、评论这一块,下了点功夫
- 时间显示成相对时间:刚刚 / 12 分钟前 / 3 天前,鼠标停一下看完整时间
- 没头像就用首字方块:不会出现灰色小剪影,也不会裂图
- 评论者悬浮卡:鼠标停在头像上,弹出名片——评论次数、身份、主页、RSS、最近几篇博文
那张名片里的博文是异步拉取的,走「日志列表 API」,并且缓存一小时,不会每次悬停都去打接口。
重要
悬浮卡里的数据来自第三方接口,需要你在后台填接口凭据;没填就会显示「没有找到这个人的订阅源」,不影响其它功能。
邮件通知
评论、回复、友链申请,三类事件可以分别通知:
- 有人评论 → 通知站长
- 你的评论被回复 → 通知那位评论者
- 有人提交友链 → 通知站长
三套邮件模板都在后台,可以直接预览,不用先发一封测试邮件猜效果。SMTP 支持 SSL 465 / STARTTLS 587 / 明文 25 三种方式。
五、头像:自建代理
这一项看起来不起眼,但影响首屏体感。
主题不再直接去 cravatar 拉图,而是走自己站上的代理:
- 抓到的头像存本地,缓存 30 天
- 缓存键带尺寸,
96和34各存各的,不会小图被大图顶掉 - 抓不到时:有邮箱的给彩色图案,没填邮箱的给灰色人形,永远不会裂图
- 镜像按顺序重试,失败结果只缓存 5 分钟,不会一坏坏一小时
六、后台:可视化管理
除了 Typecho 自带后台,主题还提供一个 /manage 页面(仅管理员):
- 动态:发布、编辑、删除、置顶、排序
- 相册:建相册、传照片、改图注、排序
- 友链:增删改,带分页预览
顶部分了三栏切换(动态 / 相册 / 友链,带数量),一次只看一类,不再是一屏到底的表单。保存后会回到你刚才那一栏。
七、短代码
编辑器上方有一排按钮,对应这些标记。下面是把它们列全的速查表:
| 语法 | 作用 |
|---|---|
[note]内容[/note] | 提示框,另有 tip / warning / important / caution / danger |
[tip\小标题]内容[/tip] | 带自定义标题的提示框 |
==文字== | 高亮 |
[kbd]Ctrl[/kbd] | 键帽 |
| 三个反引号代码块 | 代码高亮 |
[button url="..." type="blue"]文字[/button] | 按钮,颜色可选 light/blue/green/grey/red/yellow/dark |
[collapse title="标题" open="1"]内容[/collapse] | 折叠区块 |
[gallery columns="3"][/gallery] | 相册网格,1–6 列 |
[figure src="图"]\n图注[/figure] | 带图注的单图 |
[download url="文件" size="12 MB"]文件名[/download] | 下载卡片 |
[^1] + 文末 [^1]: 注脚 | 脚注 |
点开看效果:折叠区块长什么样
折叠块适合放「补充说明」「常见问题」「配置片段」这类内容——不想让所有读者都看到,但需要的时候能查。
里面照样可以用 ==高亮== 和 [kbd]Esc[/kbd] 这种行内标记。
八、机器人接口
主题配套做了一个插件 ILogsBot,把博客能力暴露成 24 个 MCP 工具:
- 查询:状态、文章、评论、动态、友链、相册
- 写入:发文章、改文章、审评论、回评论、发动态、加友链、传图
配合微信通道(OpenClaw)之后,流程是这样:
微信里说「把那条测试评论删了」→ 机器人调工具 → 评论真的没了 → 回你一句「删了」
所有写操作都进审计日志,删除类必须带 confirm,不会手滑就没了。
注意
机器人需要一个大模型账号才能理解人话,这一步要你在后台自己填接口地址和 Key。没配之前,它连上了也不会回你。
九、技术栈
| 项 | 版本 / 说明 |
|---|---|
| Typecho | 1.3 |
| PHP | 8.2 以上(实测 8.3) |
| 框架 | TTDF 5.0.3 |
| 主题版本 | 2.12.x |
| 原作 | 全局变量 · ilogs.cn |
| 本站版本 | 迁移到 Typecho 的版本 |
主题是单目录的,所有类放在 app/inc,视图放在 app/components,改起来不用满仓库找。
十、最后
这个主题的出发点很朴素:让博客读起来舒服,写起来快,管起来不烦。
ilogs 的原作是 全局变量 的作品,主页在 https://ilogs.cn。喜欢这个设计的话,去原作那边看看。
本站跑的是迁移到 Typecho 的版本,和原作在技术栈上已经不是一套东西了,所以遇到 Typecho 这边的具体问题,找我就行。
如果你也用 Typecho,想找一个「安静但有细节」的主题,可以试试。
真好看