=== 白羊梦华录 ===
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 主题，沿用极简毛玻璃设计语言：

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

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

* front-page.php —— 网站首页：Hero 大屏（kicker + 主按钮 + 频道入口）+ 最新文章卡片流 +
  频道分类墙 + 页面链接区（独立页面毛玻璃卡）+ 可选「关于」短文
* index.php —— 文章索引 / 博客首页 / 层级兜底（单栏全宽卡片流）
* page-articles.php —— 「文章列表（Articles）」自定义页面模板：后台建页面即可复用为文章列表页
* single.php —— 单篇文章（上下篇导航仅在存在相邻文章时显示，无空白框）
* page.php —— 自定义静态页面
* archive.php —— 所有归档：分类 / 标签 / 作者 / 年 / 月 / 日（单栏全宽卡片流）
* search.php + searchform.php —— 搜索结果
* 404.php —— 404 页
* comments.php —— 评论（嵌套 / 分页 / 中文表单）

文章卡片为横条毛玻璃卡：暗色渐变 + 装饰线稿底图（8 套配色轮换）+ 标题 / 日期 / 两行摘要 /
首分类标签 / 阅读箭头。

== 1.3.0 新增（本版） ==

* 布局修复：页面内容不足一屏时，页脚始终贴住视口底部（电脑与手机端均生效），不再上浮。
* 公告条增强：外观 → 自定义 → 公告条与通知弹窗，可为公告文字选择颜色（取色器）与字号（小 / 常规 / 大）。
* 通知弹窗增强：新增“通知正文来源”页面/文章 ID —— 用 WordPress 编辑器撰写公告内容，
  可插入图片、修改字体 / 字号 / 颜色；未设置 ID 时沿用纯文本正文（多段自动分段）。
* 启用提醒：公告条需“显示公告条 + 填写文字”；通知中心（铃铛 + 弹窗）需“启用通知中心 +
  填写纯文本正文 或 设置富文本页面 ID”。两处内容为空时不会显示，属预期行为。

== 1.2.0 新增（本版） ==
* 修复 single 页“上一篇 / 下一篇”无内容时出现空白毛玻璃框的问题（无相邻文章则不显示）。
* 界面语言在“中文 / English / 日本語”三语间切换；公告条与通知弹窗文案由后台填写。
* 顶部公告条：外观 → 自定义 → 公告条与通知弹窗，可写维护 / 活动提醒文字与链接，访客可一键关闭（记忆在浏览器）。
* 通知弹窗：页头铃铛随时唤起；可设为访问首页时每日自动弹出一次（关闭后当日不再打扰）。
* 首页在“频道”之下新增“页面链接”毛玻璃区：卡片含 PAGE 标签 + 页面标题 + 摘要 + 进入箭头；
  可指定页面 ID 或自动取最近发布的页面。
* 全局缓动统一为苹果式曲线，弹窗 / 公告条 / 卡片 / 按钮过渡更丝滑。

== 安装 ==

本主题随包附带两个可上传压缩包（内容完全一致）：

* `tianyi-thoughts-flat.zip` —— **推荐上传这个**（style.css 位于压缩包根目录，
  可最大程度避免服务器解压差异导致的“主题缺少 style.css”报错）；
* `tianyi-thoughts.zip` —— 带 `tianyi-thoughts/` 外层文件夹的标准结构（备用）。

上传步骤：

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

若上传仍提示“主题缺少 style.css 样式表”，请任选其一：

* 用系统自带解压工具把 zip 解压，将得到的主题文件夹（或解出的全部文件）
  通过 FTP / 主机文件管理器放入 `wp-content/themes/tianyi-thoughts/`，
  再到后台「外观 → 主题」启用；
* 确认上传的是以上两个 zip 之一（不是多层嵌套压缩包或目录拖动压缩）。

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

1. 后台「设置 → 常规」填写 站点标题 / 副标题（副标题即页头口号）。
2. 「外观 → 自定义 → 白羊梦华录主题设置」：
   - 首屏 Hero 与首页：kicker 小字、主按钮文案与链接、首页频道（填分类缩略名，如
     `design,game,talk`；留空自动取文章最多的 3 个分类）、最新文章条数、可选「关于」短文、
     页面链接区（标题与页面 ID）；
   - 品牌与中英双语：站点英文名 / 口号英文版、语言与分享按钮开关（界面另支持日文）；
   - 背景与页脚：全站底图 URL（建议 16:9 大图，留空为黑灰渐变）、页脚友情链接、
     备案号（默认填充示例，可在后台修改）、云朵加载页开关；
   - 公告条与通知弹窗：维护 / 活动提醒的公告文字、链接，以及弹窗标题 / 正文 / 按钮。
3. 「外观 → 菜单」：为「主导航（页头）」与「页脚链接」建立菜单；
   未设置时页头自动回退为频道分类导航，页脚回退为自定义里的链接文本。
4. 「页面 → 新建页面」：把模板选成「文章列表（Articles）」可得到全站文章列表页；
   在「设置 → 阅读」把该页设为「文章页」后，front-page 的「全部文章」按钮即可直达。
5. 发布文章：区块编辑器内可用主题色板与字号；给文章添加「设计 / 游戏 / 杂谈」等分类后，
   首页 Hero 的频道入口与分类墙随即出现。

== 常见问题 ==

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

== 版权 ==

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