=== 白羊梦华录 ===
Contributors: baiyang
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, one-column, custom-menu, custom-logo, featured-images, threaded-comments, translation-ready

个人博客 / 手搓记录主题。黑 · 白 · 灰 · 红（#E53935）极简配色 + 毛玻璃（Glassmorphism），
作者：白羊先生不在家。

== 描述 ==

「白羊梦华录」是一套经典（PHP 模板）WordPress 主题，主题目录名与压缩包名均为 `baiyang`：

* 配色与字体：黑 #000 / 白 #FFF / 灰 #888 / 浅灰 #F5F5F5 / 红 #E53935；
  PingFang SC / Microsoft YaHei 等中文字体栈。
* 交互：云朵加载页、固定毛玻璃页头、中 / 英 / 日界面切换（记忆在 localStorage）、
  站内搜索面板（键盘导航 + 回车跳转，兜底原生搜索）、一键分享（微信二维码 / QQ / 微博 /
  小红书 / 复制链接）、顶部公告条与通知弹窗（铃铛随时唤起、可插图富文本）、
  右下角返回顶部悬浮按钮、reveal 滚动进入动画（移动端自动停用）。
* 全局动效采用苹果式缓出曲线，弹窗 / 公告条 / 卡片 / 按钮过渡丝滑不生硬。
* 文章编辑增强：主题色板（黑/白/灰/浅灰/红）、四档字号预设、深色编辑界面
  （assets/css/editor.css），图片、超链接、粗体、动态图标等区块随 WordPress
  区块编辑器原生支持，并在前端按本站排版渲染。
* 已适配 WordPress 7.1（Tested up to），并启用外观工具（appearance-tools）等较新支持项。

模板覆盖（WordPress 模板层级）：

* front-page.php —— 首页：Hero 大屏 + 最新文章卡片流 + 频道分类墙 + 页面链接区 + 可选「关于」
* index.php —— 文章索引 / 博客首页 / 层级兜底（单栏全宽卡片流）
* page-articles.php —— 「文章列表（Articles）」自定义页面模板
* single.php —— 单篇文章：标题置于页头，正文全宽居中，标签与上一篇/下一篇置于页尾
* page.php —— 自定义静态页面（宽画幅）
* archive.php —— 所有归档：分类 / 标签 / 作者 / 年 / 月 / 日（单栏全宽卡片流）
* search.php + searchform.php —— 搜索结果
* 404.php —— 404 页
* comments.php —— 评论（嵌套 / 分页 / 中文表单）

== 最近更新（1.3.0） ==

* 手机端文章页重构：标题移至页头（含日期与分类），正文卡片全宽、左右留白最小化、
  行距字号按手机阅读标准重排；标签与上一篇/下一篇收纳到页尾，不再挤占正文空间。
* 页脚常规布局：位于页面底部，内容不足一屏时自动贴住视口底部（sticky footer 布局），
  滚动时随内容正常滚动，电脑端与移动端一致。
* 全站宽画幅容器（列表 1280px / 首页 1400px / 正文 1180px）。
* 首页「最新文章 / 频道 / 页面链接」三区上下间距收紧。
* 单篇上下篇卡片重排（宽松内距、标题两行截断）；无相邻文章时不渲染空白框。
* 公告条支持文字颜色与字号设置；通知弹窗支持以页面/文章承载富文本正文（可插图）。
* 界面语言中 / 英 / 日三语切换。

== 安装 ==

本主题随包附带两个压缩包（内容一致，仅结构不同）：

* **`baiyang.zip`** —— **优先上传这个**：扁平包，`style.css` 直接位于压缩包根目录，
  可最大程度避免“主题缺少 style.css 样式表”报错；
* `baiyang-folder.zip` —— 带 `baiyang/` 外层文件夹的标准结构（备用）。

上传步骤：

1. 后台「外观 → 主题 → 添加新主题 → 上传主题」，选择 **`baiyang.zip`**；
2. 启用「白羊梦华录」。

若仍提示“主题缺少 style.css 样式表”，请按以下顺序排查：

1. 清空浏览器 / 面板缓存后重新下载 `baiyang.zip`（约 99 KB）再传一次；
2. 换 `baiyang-folder.zip` 再传一次（两包解压结果相同，可交叉验证）；
3. 手动安装（100% 可用，不经过 WP 解压器）：本地解压 zip，把解出的全部文件
   通过 FTP / 主机文件管理器放入 `wp-content/themes/baiyang/`，
   再到后台「外观 → 主题」启用；
4. 确认上传的是上述两个 zip 之一，而不是把 zip 又压进了一层（嵌套压缩包）。

== 快速上手（推荐顺序） ==

1. 后台「设置 → 常规」填写 站点标题 / 副标题（副标题即页头口号）。
2. 「外观 → 自定义 → 白羊梦华录主题设置」：
   - 首屏 Hero 与首页：kicker 小字、主按钮文案与链接、首页频道（分类缩略名，逗号分隔；
     留空自动取文章最多的 3 个分类）、最新文章条数、可选「关于」短文、页面链接区
     （标题与页面 ID）；
   - 品牌与中英双语：站点英文名 / 口号英文版、语言与分享按钮开关（界面另支持日文）；
   - 背景与页脚：全站底图 URL、页脚友情链接、备案号、云朵加载页开关；
   - 公告条与通知弹窗：公告文字 / 链接 / 颜色 / 字号，弹窗标题、纯文本或富文本页面 ID、
     按钮与自动弹出开关。
3. 「外观 → 菜单」：为「主导航（页头）」与「页脚链接」建立菜单。
4. 「页面 → 新建页面」：模板选「文章列表（Articles）」可得到全站文章列表页；
   在「设置 → 阅读」把该页设为「文章页」后，首页「全部文章」按钮即可直达。
5. 发布文章：区块编辑器内可用主题色板与字号；给文章添加「设计 / 游戏 / 杂谈」等分类后，
   首页 Hero 的频道入口与分类墙随即出现。

== 常见问题 ==

* 首页主按钮默认滚动到「最新文章」；在自定义里填 URL 可改跳任意地址。
* 搜索面板检索最近 200 篇文章 + 100 个页面 + 前 50 分类/标签；更多内容请用回车进入原生搜索页。
* 分享二维码使用 api.qrserver.com 在线生成，离线时自动隐藏二维码，仍可复制链接。
* 语言切换只作用于主题界面文案（英文站名 / 口号可在自定义里填），文章内容不自动翻译。
* 通知弹窗每日自动弹出记录存于 localStorage；页头铃铛始终可手动打开查看。
* 公告条需「开关 + 文字」才显示；通知中心需「开关 + 纯文本正文或富文本页面 ID」。
* 底图背景请使用自己的图片地址；全站固定背景，建议选用明度较低的暗色图。
* 移动端为保证流畅：滚动进入动画关闭、滚动区毛玻璃降级、背景图不做淡入过渡。

== 版权 ==

主题 UI 源自内部静态原型（index.html / articles.html 的设计语言），按 GPL v2 发布。
