Vuecho 文档主题（RyeBlog）

VuePress 风格文档主题，移植自 Typecho 主题 Vuecho（MIT License）。

特性

• VuePress 设计语言：绿色主调（#3eaf7c）、Inter 字体栈、细边框卡片
• 查询文档式布局：内容页左侧为全部文档列表（按分类分组、当前篇高亮、可折叠），右侧为正文
• 首页 Hero：VuePress 式渐变 Hero（官方站首页宣传页）+ 特性卡片 + 学习目录
• 页内目录锚点条：正文顶部横向展示当前文章小标题（toc-list）
• 品牌 logo：assets/xuecha.png（600×600），带版本号防 CDN/浏览器缓存
• 代码块 / 表格 / 引用 / 卡片全套 VuePress 排版

安装

• 直接放入 usr/theme/vuecho/（含 theme.css + theme.js + home.php + post.php + assets/xuecha.png）
• 后台「外观」→ 启用「Vuecho 文档主题」

首页（文档站宣传页）

启用后首页自动渲染为文档站宣传页（非文章列表）：

• Hero 宣传区：品牌 logo + 站名大标题 + 副标题 + 双按钮（快速上手 / 开始学习）
• 特性卡片 ×3：介绍这个网站能学到什么（如：真实经验 / 健康喝茶 / 五因子评茶）
• 学习目录：最近文章按文档条目列表展示（序号 + 标题 + 分类 + 标签）

文案与链接全部在后台「站点设置 → 首页宣传区（文档主题）」配置，留空即隐藏对应区块/按钮。

内容页（查询文档式阅读）

文章/独立页为「左侧文档列表 + 右侧正文」布局：

• 左侧文档栏：全部已发布文章，按分类分组显示，当前文章高亮（绿色左条）；顶栏「«」按钮可折叠侧栏
• 右侧正文：文章标题 + 元信息 + 页内目录锚点条 + 正文 + 标签 + 上下篇 + 评论区
• 侧栏标题后台可配：「站点设置 → 首页宣传区（文档主题）→ 文档侧栏标题」

建议配置

• 后台「站点设置 → 首页宣传区（文档主题）」：填写 Hero 副标题、双按钮、3 条特性、学习目录标题、文档侧栏标题
• 品牌 logo：替换 usr/theme/vuecho/assets/xuecha.png 即可（600×600 PNG，修改后自动换版本号）

文件

| 文件 | 说明 |
|---|---|
| home.php | 文档站首页模板（Hero + 特性 + 学习目录，后台可配） |
| post.php | 文章/独立页模板（左侧文档列表 + 右侧正文，自包含布局） |
| theme.css | VuePress 风格样式（变量映射 + 组件覆盖 + 首页样式 + 文档侧栏） |
| theme.js | 侧栏模块折叠 + TOC 滚动高亮 |
| assets/xuecha.png | 品牌 logo（可替换） |