一款液态玻璃风格Typecho主题1.1

简约风格：本站
社交风格：https://wz.robes.xin
下载地址：https://wwapr.lanzouu.com/iQnmb3v43e5g

🎨 颜色

配置项	默认值	说明
强调色	#6366F1	主题色，用于按钮、链接、高亮等
背景色	#E0E5EB	页面整体背景色

💧 玻璃

配置项	默认值	说明
模糊度	20px	毛玻璃效果的模糊程度，如 16px、20px
透明度	0.45	卡片透明度，0（全透明）到 1（不透明）

📐 布局

配置项	默认值	说明
侧边栏宽度	230	单位 px，范围建议 200-280
卡片风格	社交风格	「社交风格」显示头像和图片网格；「简约风格」只显示标题和摘要

⚙️ 功能

配置项	默认值	说明
PJAX无刷新	开启	页面切换不刷新，提升体验
图片灯箱	开启	点击图片弹出大图浏览
首页图片数量	最多9张	社交风格下每篇文章最多显示几张图
相册分类ID	6	相册页面显示哪个分类下的文章
首页一言	开启	首页顶部显示随机名言，点击切换
排序切换	开启	首页支持按时间/浏览量/评论数排序

ℹ️ 关于

配置项	默认值	说明
建站日期	（空）	格式：2024-01-01，用于「关于」页面计算运行天数

🔧 高级

配置项	说明
自定义CSS	追加到页面 `<style>` 中，可覆盖任何主题样式
自定义JS	追加到页面底部 `<script>` 中

3. 页面模板

创建独立页面时，选择对应的自定义模板：

关于页面

模板文件： about.php
创建方式： 后台 → 独立页面 → 新建 → 自定义模板选「关于」
功能：
- 个人资料卡片（自动读取博客名称、描述、Logo）
- 数据统计（文章数、评论数、标签数、运行天数）
- 站点信息（运行时间、建站日期、最近更新）
- 建站历程（页面内容中用 h3 标题分段，自动生成时间轴）

建站历程写法示例：

<h3>2024年1月 - 建站</h3>
<p>购买了服务器，搭建了 Typecho 博客……</p>

<h3>2024年3月 - 换主题</h3>
<p>发现了 Robes 主题，决定使用……</p>

友情链接

模板文件： links.php
创建方式： 自定义模板选「友情链接」
前提： 需安装 Typecho 的 Links 插件
功能： 自动读取友链插件数据，按分组展示卡片

朋友圈

模板文件： friends.php
创建方式： 自定义模板选「朋友圈」
功能： 自动抓取友链的 RSS，展示好友最新文章

留言板

模板文件： guestbook.php
创建方式： 自定义模板选「留言」
功能：
- 留言排行榜（显示留言最多的用户 Top 10）
- 评论区（支持嵌套回复、表情面板）

相册

模板文件： gallery.php
创建方式： 自定义模板选「相册」
配置： 在主题设置中指定「相册分类ID」
功能： 瀑布流展示，每个相册卡片显示封面和照片数量

归档页面

模板文件： archive-page.php
创建方式： 自定义模板选「归档」
功能：
- 总览统计（总文章数、总浏览量、总评论数）
- 按年份分 Tab 展示
- 每篇文章显示日期、标题、浏览量、评论数

4. 功能说明

深色模式

点击顶栏右侧的 🌙 按钮切换
首次访问自动跟随系统偏好
记忆用户选择（localStorage）

点赞系统

文章详情页底部有「喜欢这篇文章」按钮
首页卡片也有点赞按钮
自动在数据库创建 likes 字段（首次使用时）
同一访客对同一篇文章只能点赞一次（Cookie 记录）

评论系统

支持嵌套回复（点击「回复」按钮）
表情面板（点击 😀 按钮）
快捷键：Ctrl + Enter 提交评论
评论者等级（根据评论数量自动计算 Lv1-Lv6）
显示评论者操作系统和浏览器
管理员评论带「站长」标签
评论内容最大 2000 字

PJAX 无刷新

页面切换不刷新浏览器，体验更流畅
支持预取（鼠标悬停链接时提前加载）
缓存上限 20 页（LRU 淘汰）
评论提交后自动清除缓存并刷新

图片灯箱

文章内图片和相册图片点击可放大浏览
支持左右切换（多图时）
按 Escape 关闭
点击遮罩层关闭

滚动进度

顶栏右侧圆形进度环显示阅读进度
点击可跳转到顶部/底部

侧边栏

自动识别页面标题匹配图标（如「关于」→ 👤，「相册」→ 🖼️）
分类列表显示文章数
过滤空分类
移动端抽屉式展开

搜索

顶栏搜索框（PC 端）
移动端搜索框在内容区顶部
搜索结果页关键词高亮

代码块

文章内代码块自动添加 macOS 风格三色圆点装饰
右上角复制按钮
复制成功后显示 ✓ 反馈

浏览量统计

自动统计每篇文章的浏览量
Cookie 防刷（同一访客 5 分钟内不重复计数）
归档页面和首页卡片可按浏览量排序

5. 常见问题

Q：相册页面显示空白？

确认主题设置中的「相册分类ID」是否正确。ID 可以在后台 → 管理 → 分类中查看（URL 中的 mid 参数）。

Q：友链页面没有数据？

需要先安装 Typecho 的 Links 插件，并在后台 → 控制台 → 友情链接中添加数据。

Q：如何修改侧边栏图标？

编辑 sidebar.php，找到 $iconMap 数组，按「关键词 → Font Awesome 图标」的格式添加或修改。

Q：PJAX 模式下某些插件不生效？

PJAX 切换页面时不会触发 DOMContentLoaded，如果插件依赖此事件，需要在主题的 rebindAll() 函数中手动调用插件的初始化方法。可在「自定义JS」中监听：

window.addEventListener('pjax:complete', function() {
  // 重新初始化你的插件
});

Q：如何让某个链接不走 PJAX？

给 <a> 标签添加 class="no-pjax"：

<a href="/some-page" class="no-pjax">普通跳转</a>

Q：评论提交后页面不刷新？

PJAX 缓存会在评论成功后自动清除并刷新。如果仍有问题，检查浏览器控制台是否有报错。

Q：深色模式下的颜色不满意？

在自定义CSS中覆盖暗色变量：

html.dark {
  --accent: #818CF8;
  --accent-soft: rgba(129,140,248,0.12);
}