SuJian 1.0.0 · 素笺首个正式版本

SuJian 1.0.0

SuJian（素笺）是一款简洁、专注阅读的 Typecho 个人博客主题。

这是素笺的首个正式版本，以单栏阅读布局为基础，提供个人博客常用的页面模板、外观配置和友情链接管理功能。

主要功能

• 简洁单栏布局，支持自动摘要与自定义摘要。
• 浅色、深色及跟随系统外观，提供五种主题强调色。
• 响应式导航、搜索和移动端菜单。
• 网站图标与页头 Logo 统一配置，支持 ICO、PNG、SVG。
• 首页 Banner 支持固定图片、固定渐变和随机渐变。
• GitHub 风格正文排版、Typecho 原生评论及相邻文章导航。
• 分类、标签、作者、日期归档、搜索结果与分页模板。
• 可开关的友情链接独立页，逐条配置名字、头像地址、跳转地址和简介。
• SEO 描述、分享图片、Canonical、Open Graph、Twitter Card 和 JSON-LD。
• 自定义页脚、独立 404 页面与列表页链接预加载。

安装方法

1. 下载下方 Assets 中的 Source code (zip)。
2. 解压，将主题文件夹重命名为 SuJian。
3. 上传至 Typecho 的 usr/themes/SuJian/，确保 index.php 直接位于该目录中。
4. 在后台「控制台 → 外观」中启用主题。
5. 进入「设置外观」，配置导航、网站图标、Banner 等内容。

请保留完整的 assets/ 目录，其中包含前台交互和后台友链编辑器资源。默认导航包含作者站点及项目链接，启用后请按需替换。

本版本包含编译好的前端资源，直接安装使用无需 Node.js 或 pnpm。

环境与使用说明

• 兼容目标：Typecho 1.2+、PHP 7.4+。
• 当前本地验证环境：Typecho 1.3.0、PHP 8.0.2，尚未覆盖所有版本及插件组合。
• 建议使用现代浏览器并开启 JavaScript。
• 友情链接默认关闭，开启后还需创建独立页面并选择「友情链接」模板。
• 主题不内置文章置顶管理，需要配合兼容插件使用。
• 切换主题前，建议备份原主题文件、数据库和相关设置。

已知限制

• 友链中的中文域名请使用 Punycode，中文路径请使用百分号编码。
• 关闭友链开关不会跳过输入校验，保存前仍需补全或删除不完整记录。
• 友链头像只校验地址格式，不检测图片可访问性；加载失败时不会自动替换。
• cover 和 thumbnail 仅作为分享图片兼容字段，不生成文章列表封面。

相关链接

• 项目与使用文档
• 在线演示
• 问题反馈

本项目采用 MIT License。