SuJian 1.0:给自己的博客换一张素笺

img

这次给博客换了一套新主题,名字叫 SuJian,中文名「素笺」

这是它的第一个版本,也是我准备在自己的博客里开始使用的版本。借这篇文章介绍一下它,也给这次换装留个记录。

素笺是一款面向 Typecho 的个人博客主题。它的想法很简单:把页面收拾得清爽一些,让文章好读,让平时写博客、管理页面这些事情少一点折腾。

为什么叫「素笺」

「素笺」是一张简净的纸笺。用这个名字,是希望博客也能保留一点这样的感觉:打开页面,先看到标题和文字,慢慢往下读。

所以这一版选择了单栏布局,文章列表以标题和摘要为主,正文保留清晰的层级与留白。浅色、深色模式都可以使用,也可以跟随系统切换。

至于最后写在这张纸上的内容,当然还是比纸本身更重要。

1.0 里有哪些东西

阅读和日常浏览

首页支持自动摘要,也可以单独填写文章摘要。文章正文采用 GitHub 风格的排版,评论继续使用 Typecho 原生功能,文章底部保留相邻文章导航。

分类、标签、作者、日期归档和搜索结果都有对应的列表展示。导航可以自行配置,文章列表链接也可以选择在当前标签页或新标签页打开。

搜索、移动端菜单和外观选择做了交互增强,但文章与评论仍由 PHP 模板渲染,不需要把博客改造成一个前后端分离的应用。

留一点自己的颜色

素笺默认使用灰色强调色,也提供紫罗兰、靛蓝、翡翠绿和玫瑰红几种选择。

首页 Banner 可以使用固定图片、固定渐变或随机渐变,标题和描述也可以自己填写。想放一张喜欢的图片,或者只留一块简单的颜色,都能在主题设置里完成。

网站图标和页头 Logo 共用一个配置项,填写图片地址即可,支持 ICO、PNG、SVG,以及以 / 开头的站内路径。没有填写时,就使用主题自带的默认图标。

一个单独的友情链接页面

我也给素笺加了友情链接独立页。

后台每条友链只需要填写四项:名字、头像地址、跳转地址、简介。可以逐条添加或删除,不需要手写 JSON;头像和简介不填也可以。

开启功能后,新建一个独立页面,选择「友情链接」模板并发布,再把实际页面地址加入导航就能使用。页面正文还可以写交换友链的说明或申请要求。

这项功能默认关闭。暂时不需要友链的博客,可以先不启用。

其他基础配置

页脚支持自定义内容,主题也提供了 SEO 描述、默认分享图片,以及 Open Graph、Twitter Card 和 JSON-LD 等页面信息。

这些是页面信息的基础整理,并不等于搜索排名或收录保证。另外,主题读取的 coverthumbnail 字段用于分享图片,不会自动变成文章列表封面。

关于实现和安装

素笺以 Typecho 原生 PHP 模板为主体,交互部分使用 React、shadcn/ui 和 Base UI。开发过程中也使用了 AI 辅助,这一点在项目说明中有标注。

对于直接使用主题的人,不需要在服务器上安装 Node.js,也不需要自己编译前端。仓库中包含了编译好的资源,安装时保留完整主题文件即可;只有修改前端组件源码时,才需要重新构建。

安装流程和普通 Typecho 主题一样:

  1. 从项目仓库获取主题,将目录命名为 SuJian
  2. 放到 Typecho 的 usr/themes/ 目录下,注意不要多嵌套一层文件夹。
  3. 在后台「控制台 → 外观」中启用,再进入「设置外观」完成配置。
  4. 把默认导航中的作者站点和项目链接替换成自己的链接,并检查桌面、手机上的显示效果。

主题的兼容目标是 Typecho 1.2+、PHP 7.4+,目前本地验证环境为 Typecho 1.3.0、PHP 8.0.2。这不代表所有版本和插件组合都已经测试过,切换主题前仍建议备份原主题和相关设置。

第一个版本,先从自己使用开始

1.0 先把个人博客常用的页面和配置整理在一起,没有把所有需求都塞进主题。比如文章置顶管理仍需要兼容插件,主题本身不提供置顶管理面板。

目前友链配置也有两点需要注意:中文域名需要使用 Punycode,中文路径需要做百分号编码;如果添加了不完整的友链记录,保存前需要补全或删除,即使已经把友链开关关闭也是一样。详细说明放在项目文档里。

接下来就从自己的日常使用开始,看看哪些地方真的顺手,哪些地方还需要调整。比起继续往设置页里增加选项,我更想先把写文章、读文章和手机浏览这些常用场景打磨好。

项目与体验地址

详细的安装、配置和已知限制以仓库说明为准。遇到问题可以在评论区交流,或者提交 Issue;附上 Typecho、PHP、浏览器版本和复现步骤,会更方便定位。

这就是素笺的第一次亮相。主题先用起来,文章也继续写下去。

Leave a reply

发表评论