Stationery 主题（纸感博客主题）

一款面向 Emlog 博客系统的「纸感 / 信纸」风格主题，别名 lcbk_stationery。设计上模拟纸张、胶带、便签等文具元素，配合可切换的主题色与深色模式，为个人博客提供独特而克制的阅读氛围。

• 主题名称：Stationery 主题
• 当前版本：1.2.7
• 适用系统：Emlog（需启用模板设置插件）
• 版式定位：首页三栏，文章页、其他页面两栏
• 作者：LAO.CHEN（J.Chen）
• 作者站点：https://www.lcbk.cn
• 模板主页：https://www.emlog.net/template/detail/1303

目录

• 主要特性
• 运行环境
• 安装教程
• 主题设置教程
  • 授权设置
  • 头部设置
  • 首页设置
  • 开屏设置
  • 内页设置
  • 边栏设置
• 常用功能使用教程
• 目录结构
• 常见问题 FAQ
• 版本记录
• 版权说明

主要特性

视觉与版式

• 纸感设计语言：全站采用纸张纹理、褶皱边缘（基于 SVG feTurbulence 滤镜）、胶带装饰（tag-style-tape）与信纸式背景，营造「写在本子上」的阅读体验。
• 三栏 / 两栏自适应版式：
  • 首页为三栏：左侧欢迎信息与热门文章卡片、中间文章列表、右侧组件抽屉；
  • 文章页、独立页面、分类归档页为两栏：正文 + 右侧栏（文章页自动出现目录卡）。
• 7 种主题色：橙色、紫色、樱花粉、蓝色、粉色、绿色、黑色，点击即切换并记忆用户选择。
• 深浅色模式：一键切换日间 / 夜间模式，适配不同时段与使用习惯。
• 完全响应式：桌面、平板、手机均提供对应布局；移动端导航与侧栏收纳为抽屉，配合遮罩层点击关闭。
• SVG 图标体系：内置 Remix Icon v4.9.1 图标，导航、社交入口等均可配置图标。
• HTML 输出压缩：页面输出自动压缩（pre / textarea / script / style 内容原样保留），减少传输体积。

文章阅读体验

• 自动锚点 + 文章目录（TOC）：正文中的 h1~h4 标题自动生成 id 锚点，并在右侧栏生成可折叠的多级目录，支持「折叠全部 / 展开全部」。
• 代码块增强：自动识别 language-xx 语言标记并渲染为带行号的代码块，支持一键复制、折叠 / 展开长代码。
• 图片灯箱：集成 Fancybox，正文图片点击可放大浏览。
• 上下文导航：文章页提供同分类随机「相关文章」、上一篇 / 下一篇（含"没有更早的文章了 / 已经是最新的一篇"边界提示）。
• 置顶与分类置顶：文章列表、轮播中均可识别置顶标志并展示角标。
• 加密文章定制页：自定义 pw.php 密码输入页面，与主题风格统一。
• 打赏模块：文章底部可展示微信、支付宝收款二维码，方便读者扫码支持。
• 返回顶部：滚动页面出现返回顶部按钮，平滑回到顶部。

首页开屏（Hero）

• 可开关的首页开屏：开启后在首页顶部呈现品牌横幅，展示博主昵称与简介。
• 开屏导航与个人链接：以「链接名称 || 链接地址」的形式配置快捷入口。
• 可拖动贴纸：开屏内散布可拖动的装饰贴纸（支持自定义贴纸图、文字与跳转链接），并带「打乱贴纸位置」按钮。
• 授权限制：首页开屏为授权功能，未填写有效授权码时后台选项会标记「未授权，此功能不可用」。

站内搜索

• 即时全文搜索：以弹层方式提供站内搜索，输入关键词即时列出匹配文章（标题 / 摘要 / 正文前 200 字索引）。
• 索引自动维护：主题会生成 search.json 搜索索引；发布、删除文章时自动重建，索引超过 1 小时或不存在时自动刷新。
• 快捷键与交互友好：支持键盘 Esc 关闭搜索。

首页轮播图组

• 在首页最新文章区上方提供文章轮播（自动播放，5 秒间隔）。
• 轮播内容来源可切换：最新 / 热门 / 评论最多 / 置顶，或关闭轮播。
• 轮播数量 1–10 篇可调。

侧边栏组件

主题实现了完整的 Emlog 侧边栏组件（在后台「外观 → 组件」中排序与开关）：

• 「博客信息」统计模块可自由勾选展示 文章数 / 评论数 / 分类数 / 标签数。
• 右侧支持配置「右侧热门文章 ID」，将指定文章以欢迎卡形式展示在首页左侧栏。

评论系统

• 支持昵称（必填）、邮箱（可选）、评论内容、验证码。
• 楼中楼回复：支持回复指定楼层并自动 @ 对方，可取消回复。
• 角色称号：游客 / 用户 / 博主（楼主）/ 管理员徽章，可按需在后台隐藏「评论用户称号」。
• 提供友好的引导文案（"成为第一个评论的人吧""谨言慎评，杜绝杂乱发言"等）。
• 与 Emlog 原生评论开关联动（全局或单篇文章关闭评论时不展示评论区）。

页面与站点页面

多语言与字体

• 中英双语：内置 languages/zh_CN、languages/en_US 两套语言包，模板文案均通过 _langTpl() 输出，方便翻译扩展。
• Google Fonts 动态加载（可选）：
  • 支持正文（多字体按优先级）与代码等宽字体分别配置；
  • 支持「裁剪字体 + 裁剪字符集（text= 参数）」，只加载需要的字形，大幅减小字体体积；
  • CDN 域名可自定义（国内环境可填 https://fonts.loli.net）。
• 无障碍与 SEO 友好：语义化 HTML5 标签、关键区域 aria-label、图片 loading="lazy"、外链图片 referrerpolicy="no-referrer" 等。

主题设置系统

主题通过 options.php 提供图形化设置面板（需 Emlog「模板设置」插件支持），设置项按标签页分组，详见下文 主题设置教程。

运行环境

• Emlog 系统（推荐最新稳定版，需支持模板设置插件 / options.php 模板设置机制）
• PHP 7.4+（代码使用类型声明、箭头函数等语法，且符合 Emlog 模板规范）
• MySQL 5.6+
• 推荐浏览器：Chrome / Edge / Firefox 等现代浏览器

提示：开启 Emlog 开发者模式（config.php 中设置 const ENVIRONMENT = 'develop';）可输出更详细的调试信息。

安装教程

方式一：后台在线安装（推荐）

1. 登录 Emlog 后台，进入「外观 → 模板」。
2. 点击「安装模板」，选择主题安装包（ZIP）上传。
3. 安装完成后，在模板列表中点击 启用 Stationery 主题。

方式二：手动上传

1. 将主题安装包解压，得到主题文件夹（内含 header.php、index.php、assets/、languages/ 等）。
2. 将整个文件夹上传到站点目录的 content/templates/ 下。
3. 返回后台「外观 → 模板」，找到该主题并点击 启用。

启用后必做三件事

1. 启用「模板设置」插件：进入后台「插件」，启用 模板设置 插件（若系统已自带则确认其为开启状态）。若未开启，前台会提示「请开启【模板设置】插件」，并给出跳转后台开启的入口。
2. 进入主题设置：进入后台「外观 → 模板 → 设置」（或「模板设置」入口），按下一节完成授权与基础配置。
3. 检查搜索索引：主题会自动生成站点根目录下的 search.json 用于站内搜索；若没有看到效果，发布 / 更新一篇任意文章即可触发索引重建。

主题设置教程

主题设置面板按标签页分组，各分组说明与每一项的配置方法如下。

1. 授权设置

• 主题授权码：输入形如 JChen-XXXX-XXXX-XXXX 的授权码后保存，主题会自动联网验证并显示「已授权 / 未授权 / 等待验证」状态。
  • 购买后请到作者的授权查询页面输入订单号领取授权码。
  • 授权验证结果会本地缓存（约 1 小时），离线环境下仍可正常展示。
  • 可随时点击「刷新验证」重新校验。
• 说明：首页开屏等高级功能依赖有效授权；未授权状态下相关功能不可用，其余主题功能不受影响。

2. 头部设置

图标类名参考 Remix Icon v4.9.1 图标库，例如 ri-home-line、ri-quill-pen-line。

3. 首页设置

4. 开屏设置

开屏为授权功能，未授权时无法开启。

5. 内页设置

6. 边栏设置

侧边栏组件的显示与排序在 Emlog 后台「外观 → 组件」中管理，主题设置里的社交图标、统计项等只是组件内容的补充配置。

常用功能使用教程

1. 导航栏如何带图标

在「头部设置 → 导航图标」中填写：

首页=ri-home-line,随笔=ri-quill-pen-line,折腾=ri-article-line,关于=ri-user-line,工具=ri-quill-pen-line

格式为「导航名称 = 图标类名」，多个用英文逗号分隔。导航名称需与 Emlog 后台「导航」中配置的导航名称一致。

2. 创建「友情页面」

1. 在 Emlog 后台新建一篇独立页面（页面）。
2. 在页面的「模板」下拉框中选择 友情页面（对应主题的 page_links.php）。
3. 页面内容中可书写友情页的引导介绍文字；页面顶部默认使用友链横幅图。
4. 友情链接本身来自 Emlog 后台「链接」管理，保存后前台即可看到聚合展示。

想去掉"只在首页显示友链"限制，可调整 module.php / inc/module.php 中 widget_link 相关注释（见源码注释说明）。

3. 创建「标签页面」

1. 新建独立页面。
2. 在「模板」下拉框中选择 标签页面（对应 page_tags.php）。
3. 前台将展示按使用次数分级（字号 / 颜色分级，6 色循环）的标签云。

4. 让文章拥有特色封面

• 为主题启用「自动文章封面」类能力，或在文章编辑器中为文章设置封面 / 首图（主题会读取文章的封面字段 / 首图）。
• 无封面文章自动回退到「头部设置 → 自定义默认图」配置的默认图。

5. 使用微信 / 支付宝打赏

在「内页设置」分别上传微信收款码、支付宝收款码图片，文章阅读页底部即会自动展示对应打赏入口。

6. 配置首页开屏

1. 确认主题已授权（授权设置显示「已授权」）。
2. 在「开屏设置」开启「首页开屏」。
3. 按需配置「开屏导航」和「贴纸来源」；保存后访问首页即可看到开屏。
4. 开屏贴纸可在前台直接拖动，点击右上角「打乱贴纸位置」按钮可随机重排。

7. 使用站内即时搜索

• 点击站内搜索入口（导航 / 404 页等位置）弹出搜索面板，输入关键词即时出现结果，按 Esc 或点击遮罩关闭。
• 搜索结果来自站点根目录 search.json 索引；若搜索内容不完整，发布 / 更新任一文章即可触发索引重建（索引超过 1 小时会自动刷新）。

8. 切换主题色与深色模式

• 打开右侧抽屉栏（移动端为导航按钮唤出），顶部一排色块即 7 种主题色，点击即时生效；
• 日 / 夜切换按钮位于抽屉工具区或开屏工具区，主题会记住用户的颜色与模式偏好。

目录结构

.
├── 404.php                  # 自定义 404 页面
├── callback.php             # 模板事件回调（安装 / 卸载 / 更新）
├── custom_fields.php        # 预设文章自定义字段（当前为示例，可自行开启）
├── echo_log.php             # 文章阅读页
├── footer.php               # 页面底部（版权、ICP、返回顶部、搜索面板、JS 引入）
├── header.php               # 页面头部（主题声明、导航、开屏、样式变量）
├── index.php                # 首页（轮播 + 文章列表 + 左右侧栏）
├── log_list.php             # 分类 / 标签 / 搜索等列表归档页
├── module.php               # 页面模块与侧边栏组件函数
├── options.php              # 主题设置面板配置（模板设置插件支持）
├── page.php                 # 独立页面模板
├── page_links.php           # 友情页面模板
├── page_tags.php            # 标签页面模板
├── plugins.php              # 系统调用：Google Fonts、CSS 变量、后台图标
├── pw.php                   # 加密文章密码页
├── preview.jpg              # 模板预览图
├── assets/
│   ├── css/                 # 样式（style.css 主样式、comments.css）
│   ├── js/                  # main.js（布局 / 搜索 / 轮播等）、comments.js
│   ├── admin/               # 后台设置面板样式
│   ├── fancybox/            # 图片灯箱
│   ├── images/              # 默认缩略图、开屏背景、logo 等
│   ├── remixicon/           # Remix Icon 图标
│   └── sticker/             # 开屏贴纸图片
├── inc/
│   ├── brand.php            # 站点品牌信息
│   ├── featured.php         # 首页轮播图组
│   ├── functions.php        # 搜索索引、HTML 压缩、TOC、代码块等核心函数
│   ├── hero.php             # 首页开屏
│   ├── left.php             # 首页左侧栏（热门文章欢迎卡）
│   ├── license_client.php   # 主题授权客户端（配置区见文件顶部常量）
│   ├── module.php           # 侧边栏组件函数
│   ├── related.php          # 相关文章
│   ├── right.php            # 右侧栏（主题色切换、组件区、文章目录）
│   └── search.php           # 搜索面板
└── languages/
    ├── zh_CN/main.php       # 简体中文语言包
    └── en_US/main.php       # English 语言包

常见问题 FAQ

Q：启用主题后前台提示「请开启【模板设置】插件」？

主题设置依赖 Emlog 的「模板设置」插件提供 options.php 设置能力。请到后台「插件」页启用它（页面提示里自带跳转后台插件的入口），刷新前台即可。

Q：首页开屏打不开 / 后台提示未授权？

首页开屏是授权功能。请先在「授权设置」填写有效的主题授权码并保存，等待验证通过后回到「开屏设置」开启。授权码格式为 JChen-XXXX-XXXX-XXXX，请通过作者的授权查询页面获取。

Q：改了主题设置不生效 / 前台样式没变化？

• 主题设置保存后会自动重新验证并应用；若仍无变化，请强制刷新浏览器缓存（Ctrl/Cmd + Shift + R）。
• 资源加载带版本号与时间戳参数（main.js?v=1.2.7&t=时间戳），升级 Emlog 或主题版本后会自然更新缓存。

Q：站内搜索没有结果？

搜索依赖站点根目录的 search.json 索引文件：

1. 确认文件已生成（站点根目录存在 search.json）；
2. 若文件缺失或超过 1 小时未更新，访问一次任意页面会触发重建；
3. 发布 / 删除文章时主题也会自动重建索引；
4. 索引默认缓存 1 小时，属正常现象，稍候或再次发布文章即可更新。

Q：Google Fonts 加载慢或失效？

• 检查「启用 Google Fonts」是否开启；
• 国内访问可将「Google Fonts CDN」改为 https://fonts.loli.net；
• 若只想加速关键字体，可使用「裁剪字体（text=）+ 裁剪字符集」只加载少量字形。

Q：文章没有封面图时列表图很丑？

到「头部设置 → 自定义默认图」上传一张与站点风格匹配的图片作为全局默认图。

Q：友链、评论组件等不显示？

侧边栏组件需要在 Emlog 后台「外观 → 组件」中启用并拖到对应位置；主题只是提供组件的渲染样式。友链数据在「链接」管理中维护。

版权说明

本主题由 LAO.CHEN设计开发。站点样式与代码版权归作者所有，商业授权与开屏功能请在授权查询页面了解。