原创内容，转载请注明出处：https://www.myzhenai.com.cn/post/5001.html
主题仓库：https://github.com/RucLinux/Mylove/

Mylove 是面向 WordPress 的博客主题，采用三栏布局：左侧导航、中间正文、右侧信息栏。内置伪静态与 .html 后缀、归档与相册虚拟路由、Markdown、评论与打赏等扩展。

运行环境： WordPress 6.0 及以上，PHP 8.0 及以上（以主题 style.css 中 Requires 为准）。文本域： mylove。

分发版说明： 不包含站点特定的备案号、统计 ID。页脚备案与「网站统计」请在后台 外观 → 备案管理、外观 → Mylove 设置 填写；第三方统计脚本请用 外观 → 统计代码。

许可协议： GPL-2.0-or-later。

主题信息

一、安装与基础

1. 将主题文件夹上传到 wp-content/themes/（文件夹名可自定，不必与压缩包名相同）。
2. 在 外观 → 主题 中启用 Mylove。
3. 外观 → 菜单：创建菜单并指派到 Primary Menu（位置键名 primary）。
4. 外观 → 小工具：侧栏区域 Right Sidebar（sidebar-right）。主题默认已输出热门/评论/随机 Tab、博客信息、标签云等；可继续追加小工具。
5. Logo： 支持站点图标与 custom-logo；左侧圆形 Logo 优先使用主题内 images/logo.png（若存在）。

二、外观下的三个菜单

提示： 修改链接后若前台异常，到 设置 → 固定链接 再点一次「保存更改」。

三、固定链接与 .html

预设含：默认 ?p=123、/%postname%.html、年月路径、/archives/%post_id%.html，以及自定义前缀生成 /前缀/文章名.html。

可分别为分类、标签、独立页面开启 .html。若根目录文章与页面同时为 .html，后台会提示同名冲突，建议文章使用带前缀的路径（如 /post/%postname%.html）。

四、虚拟路由

• /archives/ 或 /archives.html：文章归档树。若已存在 slug 为 archives 的固定页面，则优先使用该页与 page-archives.php。
• /album/、/album/page/2/ …：虚拟相册；若存在分类别名 image，下列出该分类文章。

访问分类 slug 为 image 的归档时使用 category-image.php（顶部九宫格 + 列表）。

五、固定页面模板

六、文章与阅读体验

• 列表缩略图、浏览量（元数据 _xghome_post_views）、编辑侧栏 Markdown 模式。
• Highlight.js 高亮 <pre><code>。
• 主题对正文内 <code> 做换行整理（减轻 wpautop 插入的 <br />），多行行内 code 使用类 xghome-code-multiline，呈整块背景。
• 打赏：Mylove 设置中开关与微信/支付宝收款码图片 URL。
• 文章二维码：API 列表（每行 URL，可用 {url}）；留空则不显示。
• 单篇文末可显示最后修改时间。
• 纪念日灰度：每年 9 月 18 日、12 月 13 日 全站灰度（九一八、国家公祭日）。

七、评论、头像与表情

评论表单：「联系方式」一栏；手机号写入评论 meta。

评论头像包

在主题目录创建 images/avatar/，其下每个子文件夹为一套装，套装内放入 png / jpg / jpeg / gif / webp / svg 图片（至少一张才会出现在下拉里）。到 外观 → Mylove 设置 → 评论头像包 选择套装；选「默认头像（Gravatar）」则不用本地图。同一访客在同一套装内显示为固定一张图（由邮箱等生成映射）。

表情

在主题目录创建 images/emoji/，其下每个子文件夹对应表情面板上的一个标签页（文件夹名为标签名），内放表情图片（扩展名同上）。前台文章评论区可展开表情面板，点击后向评论框插入 <img>。编辑文章（post）时，正文编辑器下方有「文章表情」，点击插入到正文；页面无此区块。若目录为空或无有效图片，主题不显示表情选择器。

八、媒体、水印与防采集

媒体最大宽高、图片/文字水印、视频解析接口（支持 {url}）。防采集选项注入 window.XGHOME_ANTI_SCRAPE，无法完全禁止复制。

九、布局与其它

可关闭顶栏增强；可左右栏互换（菜单列与小工具列对调）。左侧 Logo 圆圈约 40～120px 可调。

十、静态资源与缓存

主要 assets/css/theme.css、assets/js/theme.js。版本号在 functions.php 的 xghome_classic_enqueue_assets 中（当前示例：主题样式 1.0.9，脚本 1.0.5，Highlight 11.10.0）。更新主题后可提高版本号避免浏览器强缓存。

十一、常见问题

• 归档或相册 404： 设置 → 固定链接 保存；检查服务器重写；可参考 Mylove 设置页底部 Nginx/Apache 示例。
• .html 不生效： 确认 Mylove 设置中已勾选并重存固定链接。
• 友链不显示： 链接管理中是否有数据；移动端抽屉内友链入口。

说明与 myzhenai 主题代码同步；若与后台界面不一致，以 functions.php 及模板为准。