Robes Typecho 主题使用文档1.1

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

📦 安装方法

1. 下载主题压缩包 robes-updated.tar.gz
2. 解压后将 robes 文件夹上传至 Typecho 的 usr/themes/ 目录
3. 登录 Typecho 后台 → 控制台 → 外观 → 可用主题 → 启用 Robes

⚙️ 主题设置

进入 外观 → 设置外观，共 6 个分类 Tab：

一、基本设置

二、外观样式

三、布局导航

四、功能开关

五、社交链接

填写用户名或完整链接，自动补全前缀。留空则不显示。

社交链接显示在 关于页面 的个人资料卡片底部。

六、自定义

🖼️ 文章内图片排版

在文章正文中使用短代码实现多图排列：

九宫格图片

[photos]
图片URL1
图片URL2
图片URL3
[/photos]

支持 1-9 张图片，自动排列为网格。

单张大图

图片URL

💬 评论功能

• 头像使用 Cravatar（兼容 Gravatar）
• 支持 Emoji 表情选择
• 支持回复嵌套
• 评论区自动识别友链博主（显示特殊标识）

🌙 深色模式

4 种模式可选：

选择「用户切换」或「跟随系统」时，用户的选择会保存在 localStorage 中。

页面模板

创建页面时在「自定义模板」下拉框中选择对应模板。

关于页面

模板名： 关于
建议 slug： about

功能：

• 个人资料卡片 — 显示 Logo/头像、博客名、站点描述、社交链接
• 数据统计卡片 — 自动统计文章数、评论数、标签数、运行天数
• 站点信息卡片 — 运行时间（自动计算）、建站日期、最近更新日期、主题名称
• 建站历程 — 页面正文内容自动渲染为时间线

建站历程用法： 在页面正文中使用 h3 标签分段，自动生成时间线：

<h3>2024年1月</h3>
<p>搭建了博客，选择了 Robes 主题。</p>

<h3>2024年6月</h3>
<p>完成了第一次改版，加入了暗色模式。</p>

<h3>2025年1月</h3>
<p>重构了评论系统，加入了等级和好友检测。</p>

友链页面

模板名： 友链 / Friends
建议 slug： links / friends

功能：

• 自动读取 Typecho 友情链接插件（Links_Plugin）的数据
• 每个友链卡片显示：头像、名称、描述
• 自动检测友链是否可访问（在线/离线状态指示灯）
• 头像加载失败时自动回退为首字

前置要求： 需安装 寒泥友情链接插件（Links_Plugin）

页面正文 中可写友链说明、申请格式等自定义内容。

朋友圈页面

模板名： 朋友圈
建议 slug： friends / moments

功能：

• 自动抓取所有友链的 RSS 订阅，展示最新文章
• 每个好友卡片显示：头像、名称、描述、最近 3 篇文章
• 按最新文章时间排序
• RSS 地址自动探测（支持 /feed、/feed.xml、/rss、/atom.xml 等路径）
• 结果缓存 2 小时，RSS 地址缓存 7 天
• 缓存目录：usr/cache/friends/

页面正文 中可写朋友圈介绍等自定义内容。

留言板页面

模板名： 留言 / Guestbook
建议 slug： guestbook / message

功能：

• 内嵌评论表单
• 活跃榜 — 自动统计评论数最多的前 10 位访客，显示排名、头像、评论数
• 页面正文可写留言须知等

相册页面

模板名： 相册 / Gallery
建议 slug： gallery / photo

功能：

• 自动读取指定分类下的文章，提取文章中的图片作为相册
• 瀑布流布局，不同卡片交替不同高度（4:3、3:4、1:1、16:10）
• 每个相册卡片显示：封面图、图片数量角标、标题、日期、评论数
• 点击进入文章详情页

使用方法：

1. 创建一个分类（记下分类 ID）
2. 在该分类下发布文章，文章中插入图片
3. 在主题设置中填写「相册分类 ID」
4. 创建相册页面，选择「相册」模板

归档页面

模板名： 归档
建议 slug： archive / timeline

功能：

• 顶部统计卡片：文章总数、总浏览量、年份数
• 按年份分组的 Tab 切换
• 每篇文章显示：日期、标题、浏览量、评论数
• 默认显示最新年份

说说页面

模板名： 说说 / Shuoshuo
建议 slug： shuoshuo / talking

功能：

• 类似微博/朋友圈的短内容展示
• 每条说说显示：内容、时间、点赞数
• 支持图片

首页功能

一言语录

• 开启后首页顶部显示随机语录
• 内置 10 条经典语录
• 点击切换下一条（带淡入淡出动画）
• 语录以斜体显示，左侧有强调色引号装饰

排序切换

开启后首页显示 3 个排序 Tab：

排序在前端即时切换，无需刷新页面。

卡片风格

社交风格（默认）：

• 头像 + 昵称 + 时间
• 文章摘要
• 图片网格（受首页图片数量限制）
• 评论数 + 分享按钮

简约风格：

• 纯标题 + 摘要
• 日期 + 浏览量 + 评论数
• 更紧凑的布局

搜索功能

• 顶栏中央有搜索框，输入关键词回车搜索
• 移动端搜索框在内容区内显示
• 搜索结果页显示搜索关键词和结果数量
• 搜索关键词在结果中自动高亮显示

404 页面

• 显示大号 404 文字
• 「页面走丢了」提示
• 内嵌搜索框，可直接搜索
• 「返回首页」和「返回上页」按钮
• 随便看看 — 自动推荐 4 篇随机文章，带封面图