冬天又来临 罗言 00:00 / 00:00
默认分类 · 1 条评论

新主题已达成

ilogs

53 阅 · 2k 字 · 约 5 分钟

ilogs:一个把「阅读」当回事的 Typecho 主题

写在前面

写这篇文章的时候,我正一边听主题自带的播放器,一边在微信里让机器人替我审评论。这大概就是 ilogs 现在的样子:看起来是一栏安静的博客,实际上手伸得挺长。

提前说明:这套主题设计的原作是 全局变量 的作品,原始版本在 ilogs.cn。

我只是把是把原作迁移到 Typecho 上跑的——数据、模板、组件、评论体系都重新接到 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"]![](图1)![](图2)[/gallery]相册网格,1–6 列
[figure src="图"]![](图)\n图注[/figure]带图注的单图
[download url="文件" size="12 MB"]文件名[/download]下载卡片
[^1] + 文末 [^1]: 注脚脚注
点开看效果:折叠区块长什么样

折叠块适合放「补充说明」「常见问题」「配置片段」这类内容——不想让所有读者都看到,但需要的时候能查。

里面照样可以用 ==高亮== 和 [kbd]Esc[/kbd] 这种行内标记。

八、机器人接口

主题配套做了一个插件 ILogsBot,把博客能力暴露成 24 个 MCP 工具:

  • 查询:状态、文章、评论、动态、友链、相册
  • 写入:发文章、改文章、审评论、回评论、发动态、加友链、传图

配合微信通道(OpenClaw)之后,流程是这样:

微信里说「把那条测试评论删了」→ 机器人调工具 → 评论真的没了 → 回你一句「删了」

所有写操作都进审计日志,删除类必须带 confirm,不会手滑就没了。

注意

机器人需要一个大模型账号才能理解人话,这一步要你在后台自己填接口地址和 Key。没配之前,它连上了也不会回你。

九、技术栈

项版本 / 说明
Typecho1.3
PHP8.2 以上(实测 8.3)
框架TTDF 5.0.3
主题版本2.12.x
原作全局变量 · ilogs.cn
本站版本迁移到 Typecho 的版本

主题是单目录的,所有类放在 app/inc,视图放在 app/components,改起来不用满仓库找。

十、最后

这个主题的出发点很朴素:让博客读起来舒服,写起来快,管起来不烦。

ilogs 的原作是 全局变量 的作品,主页在 https://ilogs.cn。喜欢这个设计的话,去原作那边看看。

本站跑的是迁移到 Typecho 的版本,和原作在技术栈上已经不是一套东西了,所以遇到 Typecho 这边的具体问题,找我就行。

如果你也用 Typecho,想找一个「安静但有细节」的主题,可以试试。

去原作者主页看看

看本站实际效果

评论 1

提交后可能需要审核。
网友小宋
网友小宋

真好看

© 心记|Mood · RSS · 陕ICP备2025062050号-1 · 主题 ilogs · 原作 全局变量 · 登录