Skip to content

Releases

v1.0.20 · 悠哉字体内嵌 + 瞬间页重做与 1/2/3 栏切换

Choose a tag to compare

@YBRC114514 YBRC114514 released this 15 Nov 05:32

v1.0.20

这一版做了三件大事:把「悠哉」手写字体直接打进主题包(默认离线加载,零第三方请求)、瞬间页排版整体重做(单图不裁切、图片灯箱、卡片进场动画,电脑端还能切 1 / 2 / 3 栏)、后台新增**「列表与分页」分组**(首页文章数、瞬间条数都能自己定)。

熹屿 Xiyu 瞬间页两栏:栏宽等分、卡片间距 20px、高度各随内容

瞬间页电脑端两栏(1160px):栏宽恒等分,卡片高度不强求对齐,间距固定 20px

新增

1. 「更换字体」:内嵌悠哉(Yozai),可切 CDN

字体不再只能靠第三方 CDN。悠哉字体(Yozai)已随主题包内嵌分发,选「主题内置」时页面不产生任何第三方字体请求,断网、内网、CDN 抽风都不影响。

字源选项 说明
主题内置(默认) 本地加载,零外部请求,包内已含 258 个 woff2 分片(6.7 MB)
jsDelivr / Fastly / Gcore 想省流量时切到公共 CDN
系统字体 保持站点原样,不加载任何字体
自定义(CSS 地址 / 字体文件) 填别人家的 font.css,或直接给 woff2 地址,主题自动生成 @font-face

「作用范围」可选全站或仅正文(文章正文、文章大标题、页面标题生效,界面仍用系统字体)。

悠哉字体以 SIL Open Font License 1.1 发布,可免费商用;主题包内附 OFL.txt 许可全文与 NOTICE.md 版权说明,未改字体名、未改字形。详见 README「字体与第三方资源」。

悠哉字体在首页的效果

2. 瞬间页(/moments)排版重做

  • 单图按原比例完整展示:限高 460px、不裁切,竖长截图也看得全;多图走两列方形网格
  • 点图开灯箱:点图片 / 点遮罩 / Esc 都能关,手机上也不用手势摸索
  • 图片解码后再淡入,不会闪半张图;卡片用主题统一的 data-reveal 交错进场,prefers-reduced-motion 下直接显示
  • 卡片头部:作者头像(没设头像时用昵称首字的渐变块兜底)、昵称(链到 /authors/{name})、时间(浏览器换算访客本地时区,一周内显示「刚刚 / N 分钟前 / 昨天 09:12」,完整时间在 title 里)
  • 底部操作栏:左边标签胶囊(点进对应标签筛选),右边「查看详情」

3. 电脑端 1 / 2 / 3 栏切换

页面右上角三个小按钮,访客点一下即换,页面同时放宽(880px → 1160px → 1400px);选择记在 localStorage,下次打开还是自己挑的那档。手机端(≤900px)一律单栏、按钮隐藏。

瞬间页三栏

三栏(1400px)· 每栏 453px 等宽,卡片高度各随内容,间距恒 20px

只保证栏宽等分,不强求高度对齐:脚本按「当前最矮的一列」分配卡片,列内纵向堆叠,所以既不会因为邻列有个高个子而空出一大片,也不会重叠错位;图片懒加载长高也不会破坏布局。

4. 后台新增「列表与分页」分组

设置项 范围 / 默认 说明
首页每页文章数 1–24,默认 10 与 Halo 后台「文章设置」的分页大小互不影响
瞬间页每页条数 1–24,默认 10 需启用 plugin-moments
瞬间页电脑端默认分栏 单栏 / 两栏 / 三栏 访客没自己选过时按它渲染

两处条数都由主题自己按 /page/N 分页,越界页会自动回退到最后一页(/page/99 显示 N / N,不会出现空白列表)。瞬间页的标签筛选与分页可以一起用(/moments/page/2?tag=日常)。

后台「列表与分页」三项设置

修复

  • 瞬间页「有的板块有动画、有的没有」:进场动画的截图兜底逻辑会在 1.5 秒后把所有还没进视口的元素一次性显示,导致下半页滚动到位时已经没有动画。现在只在视口被撑到 1600px 以上(长截图工具)时才兜底,正常浏览一律滚动到哪显示到哪。
  • 瞬间页卡片进场糊成一团:卡片原本沿用文章卡的 blur(3px) + scale(0.97),卡片一大就像"没加载出来"。改为只做 12px 上移 + 0.34s 淡入,交错步长 30ms(上限 150ms)。
  • 图片抢在卡片前面清晰:图片自带淡入、卡片另有递增延迟,两条时间线会打架,出现"图先出来、卡片后包上"的错位感。现在卡片未进场前图片一律不显示。
  • 切换 1/2/3 栏时卡片会换列跳一下:原按"最矮列优先"分配,依赖卡片真实高度,而图片懒加载导致首次测量偏矮,切换后重算结果不同。改为按顺序轮转落列,任何时刻结果完全一致。
  • 瞬间工具条(标签 / 分栏按钮)没有进场动画:补上 data-reveal,与卡片同一套节奏。
  • 瞬间页分栏间距被"吃掉":卡片进场动画带 scale(0.97),脚本按 getBoundingClientRect() 量高度会少算 3%,把间距压没了;改为按列容器布局后彻底解决,同时间距从 16px 提到 20px。
  • 多栏出现大片空白 / 卡片错位:原「1px 行 + 折算跨行数」的网格方案在高卡片下会把后续卡片排到极远行(实测第 3 张卡 top 10363px),整页高度虚高十几倍;改为按最矮列分配卡片后消失。
  • localStorage 为空时会把后台默认分栏覆盖成单栏的问题。
  • 瞬间卡片加 min-width: 0,长链接不会把栏宽撑变形。

安装 / 升级

  1. 在 halo.run 或 Halo 后台「主题 → 安装」上传 theme-xiyu-1.0.20.zip;
  2. 主题设置里「列表与分页」按需调条数(默认 10 / 10 / 单栏,可直接用);
  3. 想要手写体就到「字体」选「悠哉(主题内置)」,作用范围建议先选「仅正文」。

从 1.0.19 升级:设置项兼容,无需重新填写。注意「瞬间页电脑端默认分栏」已从「插件联动」搬到「列表与分页」分组。

验证

  • 字体专项 46 项:内置模式下页面零第三方请求、样式表指向 /themes/theme-xiyu/assets/fonts/yozai/yozai.css、document.fonts.check("16px Yozai") 为真、随包 OFL.txt 可访问、三个 CDN href 正确、「仅正文」时界面回落系统字体、自定义地址自动生成 @font-face、字体名注入 <script> 不执行、390px 无溢出、暗色生效、运行期无 JS 报错
  • 瞬间页专项 33 项(含「视口外卡片保持待进场」「滚到底全部进场」)、分栏专项 35 项、后台默认分栏 10 项、列表分页 20 项
  • 回归:图标 26、品牌标识 26、首屏与随机访问 29,全部 0 失败

文件校验

项 值
文件名 theme-xiyu-1.0.20.zip
大小 7,430,200 字节(7.09 MB)
SHA-256 4ab6a840ad07187059b016099627f8535db043aff51eef9fa797bbf6141aa579

完整更新记录:README · 版本记录

v1.0.19 · 友链页「站点信息」新增图标行

Choose a tag to compare

@YBRC114514 YBRC114514 released this 14 Nov 11:32

v1.0.19

这一版给友链页的「站点信息」补了一行 图标:显示站点图标的完整地址,右侧按钮一键复制,访客申请友链时不用再猜你的 favicon 在哪儿。

熹屿 Xiyu 友链页「站点信息」:图标行显示完整地址并可一键复制

桌面端实测:图标行位于「网址」下方,显示完整地址(而非缩略图),右侧复制按钮可直接填进友链申请

新增

  • 「站点信息」新增图标行

    访客填友链申请时,图标字段常被留空或填成看图才懂的相对路径。现在「友链页 → 站点信息」多出「图标」一行,显示的就是可直接粘贴的完整地址:

    名称   熹屿 Xiyu
    网址   https://example.com
    图标   https://example.com/upload/brand-cottage.svg   ← 一键复制
    简介   一座为文字留白的岛。
    RSS    https://example.com/rss.xml
    
  • 图标来源可自定义,留空自动跟随站点

    优先级 来源 设置位置
    1 图标地址(外链 / 图床) 友链页 → 站点信息 · 图标地址
    2 上传附件 友链页 → 站点信息 · 图标
    3 Halo 站点图标(favicon) 设置 → 基本设置 → 站点图标
    4 站点 Logo 设置 → 基本设置
    5 主题内置 favicon 兜底,不会出现空白

    一般来说什么都不用配:只要后台设过站点图标,这里就自动显示它,零配置可用。

细节

  • 只显示地址,不显示缩略图

    站点图标多是宽幅手写 logo(例如 237 × 54),缩略图要么被压成细条、要么把小方块撑变形,反而不如直接把地址写清楚。因此这一行只输出纯文本地址 + 复制按钮,长度不省略、超长按词换行。

  • 相对路径补全为完整链接

    附件库给出的常是 /upload/xxx.svg 这类相对路径,直接复制走会失效。现在会自动补成 http(s)://你的域名/upload/xxx.svg;//cdn.example.com/x.png 这种协议相对地址补成 https://;本来就是完整外链的原样输出。复制按钮复制的也是补全后的地址。

  • 行序与视觉保持一致

    图标行固定排在「网址」下方(桌面与手机一致),行高与相邻行对齐,暗色模式下文本对比度足够,桌面 / 390px / 360px 三种视口均无横向溢出。

升级说明

  • 控制台「外观 → 主题 → 安装」上传本 ZIP 覆盖升级,现有设置全部保留。
  • 升级后无需任何配置:会在「网址」下方自动多出一行图标地址;想换成自己的图标,到「友链页 → 站点信息 · 图标地址 / 图标」填写即可。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过)
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态)
  • 可选的第三方友链申请插件:LinksSubmit(要求 Halo ≥2.20.14)
  • 可选插件:plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme;不支持 color-mix() 的旧内核走实色回退

验证

本地 Halo 2.27.2 热升级至 1.0.19 后实测,图标专项 26 项全过:

  • 行位置:紧跟「网址」之后(桌面 / 手机均为第 3 行),行序为 名称 → 网址 → 图标 → 简介 → RSS
  • 呈现:不渲染缩略图、纯文本可换行、无省略号截断、复制值等于完整地址、复制按钮带无障碍标签
  • 回退:图标地址 → 上传附件 → Halo 站点图标 → 站点 Logo → 主题内置 favicon,五级顺序与优先级正确
  • 链接补全:站内相对路径补成 http://域名/...、协议相对地址补成 https://...、完整外链原样输出
  • 布局:超长地址完整输出且可断词换行,桌面 / 390px / 360px 无横向溢出,图标行与相邻行高度接近,暗色模式文本可读

回归:LinksSubmit 申请分支 23 项、品牌标识 26 项、横幅与随机访问 29 项,均 0 失败。

Full Changelog: v1.0.18...v1.0.19

v1.0.18 · 封面横幅 / 文章模板 / 抽签动画 / LinksSubmit

Choose a tag to compare

@YBRC114514 YBRC114514 released this 13 Nov 15:45

v1.0.18

这一版把站点左上角的标识做成了可替换的:可以直接上传图片(含 SVG)当标识,也可以填图片地址或粘贴内联 SVG 代码,还能选择「只显示标识、不显示站名」。

熹屿 Xiyu 首页:手写 SVG 标识 + 全幅 Banner + 文章卡片流

桌面端实测:左上角为上传的手写 SVG 标识(胶囊内只留图形、不重复站名),下方为 Banner 与文章卡片流

新增

  • 左上角标识支持三种来源

    「首屏 → 左上角标识」现在按优先级依次取用:

    优先级 设置项 用法
    1 内联 SVG 代码 把 <svg>…</svg> 源码直接粘进来,不用上传;可用 currentColor 跟随主题色
    2 图片地址 填完整的图片网址,https://…/logo.svg 这类外链也能用
    3 图片附件 点「选择」直接上传 PNG / JPG / SVG

    三者都留空时仍回退到站点 Logo,再没有就用站名首字,原有行为不变。

  • 「只显示标识、不显示站名」开关

    标识本身已经是完整字样(宽幅 logo、手写体 lockup)时打开,胶囊里只保留图形并自动收紧内边距,不会出现「图形里写着站名、旁边又重复一遍站名」的情况。

  • 关于上传 SVG

    Halo 支持 SVG 附件(image/svg+xml),主题里点「选择」就能直接上传 .svg。唯一的坑是默认存储策略的允许类型只有「图片 / 视频 / 音频」,没勾 SVG 时会返回 415 不支持上传 image/svg+xml 类型的文件;到后台「附件 → 存储策略」编辑当前策略,把 SVG 勾进允许类型后,上传、选择、前台渲染全链路实测正常。不想动存储策略也可以走「图片地址」或「内联 SVG 代码」。

修复

  • 宽幅 SVG 标识被压成小方块

    原来所有标识都套在 36 × 36 的圆框里,宽度是高度四倍多的宽幅 logo 会被缩成一条看不清的细线。现在 SVG 标识改为按高度等比缩放:桌面高 32px、宽度上限 168px,手机高 26px、宽度上限 96px,比例不变、不裁切(object-fit: contain)。

  • 手机端左右两块胶囊一高一矮

    左侧品牌胶囊(头像 + 站名)原本 50px 高、右侧搜索 / 收藏 / 菜单按钮组 42px,视觉上明显不齐。现在两者统一为 44px 并顶部对齐,标识图片在窄屏收到 32px。宽幅 SVG 标识也一并收窄(≤96px),390px 与 360px 视口都无横向溢出。

  • 内联 SVG 的安全过滤

    粘贴的代码必须包含 <svg>,且含 <script>、javascript:、onload=、onerror= 时会被忽略并回退到图片 / 站点 Logo,不会把可执行内容注入页面。

升级说明

  • 控制台「外观 → 主题 → 安装」上传本 ZIP 覆盖升级,现有设置全部保留。
  • 想用附件方式上传 SVG,请先把 SVG 勾进「附件 → 存储策略」的允许类型;不想改策略就用「图片地址」或「内联 SVG 代码」。
  • 标识文件里自带的 CSS / SMIL 动画(比如手写描边动效)在 <img> 与内联两种方式下都会照常播放;若想让它静止显示,删掉 SVG 里的 <style> 块即可。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过)
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态)
  • 可选的第三方友链申请插件:LinksSubmit(要求 Halo ≥2.20.14)
  • 可选插件:plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme;不支持 color-mix() 的旧内核走实色回退

验证

本地 Halo 2.27.2 热升级至 1.0.18 后实测:

  • 标识专项 26 项:附件 SVG 渲染为 img 且 object-fit: contain、内联 SVG 高度 32px 与 currentColor 生效、含 <script> 的代码被忽略并回退、三项全空回退站点 Logo / 首字、宽幅 SVG(237 × 54 手写 lockup)等比缩放不被压扁、隐藏站名后不输出文字并收紧内边距、手机端收窄、左右胶囊等高对齐且 390 / 360 视口无横向溢出
  • 回归:横幅标签化 20 项、抽屉 / 箭头 / 页脚 18 项、两套文章模板渲染、横幅与随机访问动画 29 项、LinksSubmit 申请分支 23 项,均 0 失败

Full Changelog: v1.0.17...v1.0.18

v1.0.17 · 封面横幅 / 文章模板 / 抽签动画 / LinksSubmit

Choose a tag to compare

@YBRC114514 YBRC114514 released this 13 Nov 14:57

v1.0.17

这一版把「文章封面」和「正文排版」都做成了可选:封面可以在页面顶部做全幅横幅,也可以留在正文里当一张图;正文排版改成在文章编辑页逐篇挑模板。友链页的「随机访问」加上了抽签动画,友链申请支持官方链接插件与 LinksSubmit 二选一。

新增

  • 文章封面可选「顶部横幅」

    「外观配色 → 文章封面样式」新增两项:顶部横幅(默认)与正文内嵌。

    横幅模式下封面铺满页面顶部、延伸到导航栏下方,分类、标题、标签胶囊、作者与阅读 / 评论数叠加在图上,正文卡片上浮压住横幅底边(桌面 46px、手机 28px);底部留一小段渐隐与页面背景自然衔接,页头渐变在横幅页自动转暗色,避免白雾压在图上。横幅页不再在卡片内重复输出标题,全文只有一个 h1。

    横幅里的标签是淡白半透明胶囊(带毛玻璃与细边框,悬浮加深上浮),摘要只保留在卡片内的「文章摘要」,同一段文字不会在页面上出现两遍;有横幅的文章正文底部也不再重复输出标签,无封面的文章则仍在底部保留标签。

    选「正文内嵌」则完全保持原来的样子:标题在卡片顶部,封面作为正文里的一张图,object-fit: contain 完整显示不裁切。没有封面的文章不会输出空横幅,仍走原有卡片头。

  • 两套自定义文章模板,逐篇选择

    设置页的「文章内样式」已移除,改为 Halo 文章编辑页 设置 → 自定义模板 下拉逐篇挑:

    • 默认模板(不选模板时的 post.html):毛玻璃正文卡片,h2 / h3 / h4 统一 4px 主题色竖条,链接虚线下划线,行内代码带细边框,无序列表圆点着色;
    • 模板二(post_robes.html):借鉴 robes.xin 的排版 —— h2 用 inline-block 底部渐变下划线,h3 渐变底色 + 3px 竖条,引用块大引号,代码块带 Mac 风格三色圆点,链接下划线 hover 从左展开,圆形序号列表,渐变分割线与强调色表头。

    说明:Halo 的下拉本身自带一个空值的「默认模板」项(即不指定模板时走 post.html),所以主题只声明「模板二」,下拉里就是干净的两项,不会出现重名。

  • 友链页「随机访问」抽签动画

    点击后按钮变成「抽签中…」、图标旋转并置 aria-busy,高亮在当前可见的友链卡片间快速跳动,12 步逐步放慢(约 0.75s),停在某一站后做一次中签脉冲,约 0.3s 再打开它。

    • 只从当前可见的卡片里抽,用分组筛选后不会高亮到隐藏的卡上;
    • 新增开关 友链页 → 随机访问抽签动画,默认开启,关闭后立即跳转;
    • 系统开启「减少动态效果」时自动跳过动画;
    • 动画总时长仍落在 Chrome 的瞬时用户激活窗口内,跳转不会被弹窗拦截。
  • 友链申请支持 LinksSubmit(与官方插件二选一)

    设置组新增三项:

    选项 取值
    友链申请方式 官方链接插件 PluginLinks / LinksSubmit
    LinksSubmit 表单 主题内表单 / 插件自带弹窗
    验证码类型 图形验证码 / 邮箱验证码

    主题表单调用插件公开的 window.LinksSubmit:submit(data, verifyCode, verifyCodeType)、getCaptchaUrl()、sendVerifyCode(email)、getLinkGroups();字段自动映射(backlink → linkPageUrl、RSS 首行 → rssUrl、分组名 → 分组 ID),分组下拉动态加载;邮箱验证码模式下邮箱变必填、验证码位数放宽到 6 位。选「插件自带弹窗」则直接调 openLinksSubmitOverlay()。

    插件脚本注入较晚,主题会轮询等待(12 × 150ms)再初始化;插件未安装时给出提示或跳转备用地址,不会把表单提交到错误的接口。LinksSubmit 属于第三方授权插件(要求 Halo ≥2.20.14),主题不捆绑其代码,需自行安装。

  • README 新增「鸣谢」章节

    列出本主题在交互与排版上参考过的站点与项目,以及所适配插件的作者。

改进

  • 手机抽屉菜单

    菜单行改为撑满抽屉宽度(原来 inline-flex 只随内容宽,短菜单项看起来宽度参差);子菜单分级缩进、层级更清晰。

  • 抽屉打开时整页变暗

    遮罩从只压暗正文改为全屏:抽屉展开时页面顶部(含导航栏)一起变暗,关闭时恢复。抽屉本身仍浮在遮罩之上。

  • 旧内核 color-mix() 回退

    新增 @supports not (color: color-mix(in srgb, red, blue)) 回退块,Chrome < 111 等不支持 color-mix() 的浏览器改用实色,不再出现透明 / 发白的卡片与标题块。

  • 首页浮动按钮箭头统一向上

    返回顶部与「返回文章」合并后的浮动按钮不再随滚动切换成向下箭头,始终显示向上箭头。

  • 底部栏恢复 1.0.15 形态

    移除页脚「插件入口」区块与对应开关,页脚回到 1.0.15 的结构。

  • 固定主题仓库链接

    移除设置页的「主题仓库链接」,页脚 XiYu 固定指向本仓库;整行仍可用「显示 Powered by Halo · XiYu」隐藏。

升级说明

  • 控制台「外观 → 主题 → 安装」上传本 ZIP 覆盖升级,其余设置全部保留。
  • 如果你在 1.0.16 里调过「外观配色 → 文章内样式」,该项已移除;现在请到文章编辑页「设置 → 自定义模板」逐篇选择「默认模板 / 模板二」。不选则走默认模板。
  • 「文章封面样式」默认是顶部横幅。想要原来的正文内嵌效果,改到「正文内嵌」即可。
  • 若之前设置过「主题仓库链接」或「页脚插件入口」,这两项也已移除,无需再管。
  • 使用 LinksSubmit 的站点,请先安装并启用该插件,再到「友链页 → 友链申请方式」选 LinksSubmit;官方链接插件用户保持默认即可。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过)
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态)
  • 可选的第三方友链申请插件:LinksSubmit(要求 Halo ≥2.20.14)
  • 可选插件:plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme;不支持 color-mix() 的旧内核走实色回退

验证

本地 Halo 2.27.2 热升级至 1.0.17 后逐项实测:

  • 横幅与随机访问动画 29 项:横幅满宽无横向溢出、压住页头、卡片上浮 46px、全文唯一 h1、页头暗色渐变、无封面回退、手机断点(高 386px、标题 25.4px、无横向溢出);动画开关、12 步轮播、中签高亮、关闭后 361ms 直跳、prefers-reduced-motion 跳过
  • 两套文章模板:默认模板与模板二的正文元素计算样式(标题底纹 / 竖条 / 引用块 / 代码块 / 链接下划线 / 表格)与毛玻璃容器
  • 友链申请 23 项:官方插件分支不变、图形与邮箱验证码字段映射、分组动态加载、插件弹窗、插件缺失兜底(LinksSubmit 本地未装,用等价的 window.LinksSubmit 模拟桩)
  • 横幅标签化 20 项:胶囊数量与 # 前缀、链接指向标签归档、全圆角半透明底、hover 加深上浮、横幅内不再有摘要段、正文底部标签为 0、无封面文章回退保留底部标签、手机字号与首屏可见
  • 抽屉 / 箭头 / 页脚回归 18 项:菜单行撑满、子菜单缩进、打开时整页变暗、箭头统一向上、页脚无插件入口
  • Console 实测:「自定义模板」下拉为「默认模板 / 模板二」两项无重名,设置表单中「文章内样式」「主题仓库链接」「页脚插件入口」已消失

Full Changelog: v1.0.16...v1.0.17

v1.0.16

Choose a tag to compare

@YBRC114514 YBRC114514 released this 13 Nov 02:30

v1.0.16

这一版补齐了三款 Halo 插件的适配,修好了手机切「电脑模式」后点不到二级菜单的问题,并逐条落实了 Halo 官方审核给出的建议。
升级后「插件联动」相关开关默认是关闭的,想看到侧栏一言 / 最新瞬间 / 读者榜,需要到主题设置里手动打开。

新增

  • 适配 plugin-comment-next(评论组件 Next)

    主题原有 <halo:comment /> 与新版组件天然兼容,本版补齐 --halo-cw-* 亮暗配色变量,让评论框在亮色与暗色模式下都与主题一致;侧栏新增可选的「评论读者榜」模块(<comment-ranking-sidebar>),可设置统计周期与展示人数。该插件要求 Halo 2.27 及以上,且与 Halo 自带的 PluginCommentWidget 争用同一个 comment-widget 扩展点,启用新版前请先停用旧插件。

  • 适配 plugin-moments(瞬间)

    新增 templates/moments.html 与 templates/moment.html,分别承载 /moments 列表页与 /moments/{name} 详情页,沿用主题的卡片、分页与暗色配色;侧栏提供可选的「最新瞬间」模块(走 momentFinder),页脚可配置入口。未启用插件时路由不存在,模板不会被渲染。

  • 适配 plugin-hitokoto-hub(轻言)

    侧栏新增可选的「一言」模块:首句由 hitokotoFinder.randomSentences 在服务端渲染,「换一句」按钮调用插件公开接口 /apis/public.api.hitokotohub.puresky.top/v1alpha1/sentence/random?limit=1(实际响应字段为 sentences),失败时保留当前句子而不是清空。演示句子需处于 status.published=true 才会出现在公开接口中。

  • 新增「插件联动」设置分组

    后台设置页由 10 组扩到 11 组,可分别开关侧栏「一言」「最新瞬间」「评论读者榜」与页脚插件入口,并配置瞬间条数、读者榜周期与人数。所有开关默认关闭,且全部以 pluginFinder.available() 守卫,插件未安装时整块不渲染、不会报错。

修复

  • 修复手机「电脑模式 / 桌面版网站」下无法点选二级菜单

    桌面导航(≥901px)原本只靠 :hover 展开子菜单。手机切到桌面模式后是「约 980px 桌面视口 + 粗指针」,没有 hover 事件,点父项会直接跳转,二级项永远够不着——这与 1.0.15 修的带鱼屏 prefers-reduced-motion 问题是两个不同成因。

    现在粗指针(hover: none / pointer: coarse)且处于桌面布局时改为点按展开:第一次点按拦截跳转并展开子菜单,第二次点按父项才导航;点击空白处或按 Esc 自动收起,父项同步 aria-haspopup / aria-expanded。鼠标端仍走原来的 hover,手机与平板抽屉不受影响。

  • 修复首页自定义每页文章数小于站点分页大小时产生空白页

    首页不再用 postFinder.list() 覆盖内置 posts,改为直接使用 Halo 的 posts.prevUrl / posts.nextUrl,并移除主题设置里的 layout.posts_per_page。每页文章数请到 Halo 后台「设置 → 文章设置」调整,两套分页大小不一致导致的空白 /page/N 不再出现。

  • 关闭页脚统计时仍执行 postFinder.listAll()

    关闭统计后现在整块 .footer-data 都不输出,隐藏节点与无谓的全量文章查询一并省掉。

  • localStorage 仍使用旧标识键

    主题 / 视图偏好改用 xiyu-scheme 与 xiyu-view,旧值 azure-isle-* 会一次性迁移后删除,老访客不会丢失偏好;layout.html 里防止首屏闪烁的内联脚本也同步换了键,避免首帧读旧值。

  • 预览图与演示站仍显示旧站名

    演示站标题改为「熹屿 Xiyu」并重截 screenshot.png(1440×900),商店截图与主题包内预览图不再出现「青屿 Azure Isle 演示站」。

  • README 关于插件页面的说明不准确

    补充说明:插件注册的路由页面(/links、/equipments、/steam、/moments、/hitokoto)在插件未启用时是 404,而不是「空态提示」;主题内的可选侧栏模块与用户自建独立页才会优雅降级。

升级说明

  • 控制台「外观 → 主题 → 安装」上传本 ZIP 即可覆盖升级,现有设置全部保留。从旧标识 theme-azure-isle 迁移的用户仍需先卸载旧主题再安装(Halo 以 metadata.name 作为主题身份,旧配置不会自动迁移)。
  • 原本在主题设置里调过「首页每页文章数」的站点,升级后请改到 Halo 后台「设置 → 文章设置」重新设置一次。
  • 「插件联动」的模块默认关闭,需要手动开启;启用侧栏模块前请先安装并启用对应插件,且不要同时启用 PluginCommentWidget 与 PluginCommentNext。
  • 升级后建议在手机「电脑模式」下点一次带子项的菜单验证:首次点按应展开子菜单、不跳转,第二次点按父项才导航。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过);plugin-comment-next 需 Halo ≥2.27.0
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态)
  • 可选插件:plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme

验证

本地 Halo 2.27.2 实装上述三款插件并造好演示数据后,完成 440 项断言、0 失败:

  • 1.0.16 专项验证 109 项:静态契约、插件联动、分页三页(3/3/1 且末页无空白下一页)、统计开关、localStorage 迁移、触屏电脑模式菜单、桌面 hover 与 3440×1440 reduced-motion 回归、5 档视口溢出与抽屉
  • 发布审计 301 项、可访问性审计 17 项、插件审计 13 项(其中两条旧的「自定义每页文章数」断言已按新契约改为走站点 postPageSize)

验证完成后本地实例已关闭。

Full Changelog: v1.0.15...v1.0.16

v1.0.15

Choose a tag to compare

@YBRC114514 YBRC114514 released this 08 Nov 06:35

v1.0.15

一个只改一行 CSS 位置、却影响很大的修复:桌面端导航的二级菜单现在可以稳定选中了。
如果你在带鱼屏上点不到「文库 / 我的 / 友链」下面的子项,这一版就是为你修的。

修复

  • 修复桌面端二级菜单移入即消失、无法选中

    子菜单通过 top: calc(100% + 10px) 浮在菜单项下方 10px 处,指针向下移动时有一小段区域既不在菜单项、也不在子菜单上,:hover 会在跨越缝隙的瞬间断开。正常情况下 0.25 秒的淡出过渡能兜住这个空档,但在 prefers-reduced-motion: reduce 环境下——例如 Windows 关闭了「动画效果」(带鱼屏用户为求流畅常这么设置)——主题的无障碍规则会把所有过渡压缩到 0.01ms,空档变成致命的:指针刚离开菜单项,子菜单就已完全消失,二级项永远点不到。

    现在桌面端(≥1101px)的导航项下方补了一段 12px 高的不可见悬停桥,左右各外扩 6px,hover 链跨过缝隙不再中断。子菜单的视觉、间距、动效均无变化,手机与平板尺寸不受影响。

升级说明

  • 控制台「外观 → 主题 → 安装」上传本 ZIP 即可覆盖升级,现有设置全部保留。
  • 从旧标识 theme-azure-isle 迁移的用户仍需先卸载旧主题再安装(Halo 以 metadata.name 作为主题身份,旧配置不会自动迁移)。
  • 升级后建议在桌面端把鼠标缓慢移入二级菜单验证一次;若显示仍不正常,请确认浏览器缩放为 100% 后重试。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过)
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态)
  • 可选插件:plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme

验证

  • 修复前复现:prefers-reduced-motion: reduce 下指针进入缝隙时子菜单立即 visibility: hidden
  • 修复后:同样环境下指针顺利进入子菜单并命中条目;普通动效环境下同样正常
  • 回归:3440×1440 / 1920×1080 / 1024×768 / 768×1024 / 390×844 五档视口,横向溢出、导航点击跳转、移动端抽屉开合、JS 错误共 17 项全部通过

Full Changelog: v1.0.14...v1.0.15

v1.0.14

Choose a tag to compare

@YBRC114514 YBRC114514 released this 07 Nov 15:33

v1.0.14

熹屿 Xiyu 的首个公开发布版本。这一版把主题标识统一为 theme-xiyu,并集中修复了浮动按钮语义、长内容溢出与可访问性问题。
如果你此前安装过旧标识 theme-azure-isle,请先看下方「升级说明」——两者在 Halo 里是两个不同的主题身份,需要卸载重装。

新增

  • 首页「返回文章列表」浮动按钮

    后台「浮动按钮行为」新增该选项:首页点击按钮会平滑滑到文章列表、跳过首屏 Banner,不跳转、不刷新、不改地址;文章页、归档页、分类页等其他页面仍然是回到顶部。滚动落点已扣除吸顶页眉高度,实测误差 0。

  • 页脚 Powered by 署名

    版权行末尾新增 Powered by Halo · XiYu,Halo 与主题名分别链到 halo.run 和主题仓库。新增两个设置项:footer.show_powered(开关)与 footer.theme_repo_url(换仓库时可改)。桌面端为右下角浮动按钮预留 54px 空间,移动端同步留白,二者不再重叠。

  • 主题图标与站点图标

    提供线条版图标(海平线 + 从水面升起的岛弧):logo.svg 用 currentColor 跟随文字颜色,favicon.svg 为深墨绿圆底配米白线条。站点未设置 favicon 时自动作为兜底,Console 主题卡片使用同一枚图标。

  • 首屏与作者页的可配置项

    首屏高度、Banner 模糊度、标题类型(文字 / 图片)均可配置;作者页提供可开关的 MBTI 卡片,含类型、中英别名与四条维度占比。

修复

  • 修复首页浮动按钮选「返回文章列表」后仍然只是回到顶部

    按钮此前在所有页面都执行回顶,选项形同虚设。现在按页面语义分流:仅在首页滚动到 #post-list,其他页面回到顶部;图标、title 与 aria-label 也随之切换。

  • 修复长标题、长 URL 撑破页面布局

    文章标题、归档列表、正文链接与侧栏卡片补充 overflow-wrap:anywhere;侧栏网格列改为 minmax(0,1fr),避免长词把整列撑宽、导致首页出现横向溢出。

  • 修复页脚署名被浮动按钮遮挡

    页脚在有按钮时自动让出右侧空间,XiYu 不再被按钮压住;移动端取消强制不换行,窄屏可完整折行显示。

  • 修复分享卡片显示「站点标题」占位

    模板中的静态占位文本统一改为品牌名「熹屿 Xiyu」。此前若被链接预览抓取器读到模板源码,卡片标题会显示成「站点标题」。

  • 修复亮色模式次要文字对比度不足

    --l-text-muted 由 #8a9490 调深至 #636e68,对比度从 2.83:1 提升到 4.81:1,同时保留「正文 → 次要 → 弱化」的层级梯度。

  • 修复无摘要内容输出空分享描述

    og:description 与 twitter:description 在内容没有摘要时不再输出空标签。

  • 修复错误页缺少 noindex、友链验证码空图请求

    错误页补充 noindex;友链申请表单的验证码图片默认隐藏,未取到图时不发起空请求。

变更

  • 主题标识由 theme-azure-isle 改为 theme-xiyu

    metadata.name、settingName、configMapName 与打包产物名同步变更;模板内的静态资源路径由构建期读取 theme.yaml 自动生成,无需手改。

  • Console 主题图标改为包内资源

    spec.logo 指向主题包内的 /themes/theme-xiyu/assets/icon-256.png,与 Halo 自身的 status.screenshot 引用方式一致,不依赖外部 CDN。

升级说明

  • 从旧标识 theme-azure-isle 迁移:Halo 以 metadata.name 作为主题身份,旧主题无法直接升级到本版本。请先卸载旧主题,再安装本 ZIP,然后重新设置一遍——旧配置存于 theme-azure-isle-configmap,不会自动迁移到 theme-xiyu-configmap。
  • 从 1.0.13 及更早版本升级:控制台「外观 → 主题 → 安装」上传新 ZIP 即可覆盖升级,现有设置保留。
  • 若此前调整过浮动按钮行为,升级后请确认选项符合预期——「返回文章列表」只在首页滚动到列表,其他页面回顶。
  • 建议升级后在手机端检查一次:抽屉菜单、目录展开、列表视图切换。

兼容性

  • Halo 2.26.0 或更高版本(已在 Halo 2.27.2 实测通过)
  • 建议启用官方链接插件 plugin-links 2.5.0(友链、友链申请、朋友圈动态);插件注册的路由页面(/links 等)在插件未启用时访问为 404,不会出现空态提示;主题内的可选模块则由 pluginFinder.available() 守卫、整块跳过渲染,不影响其他页面
  • 可选插件:plugin-equipment 1.1.1、plugin-steam 1.0.0
  • 现代浏览器(Chrome / Edge / Safari / Firefox),支持 prefers-reduced-motion 与 prefers-color-scheme

Full Changelog: https://github.com/YBRC114514/halo-theme-xiyu/commits/main