v0.5.10 (2026-07-04)

• 站内导航
  • PJAX 启用时注册全局 window.youlogNavigate(url)，dcard / Alpine 等可编程式跳转；未注册时回退 location.href
• 博客列表分页
  • 修复站内无刷新浏览时，dcard/list 分页内容不随页码更新的问题
  • PJAX 换页后自动重新初始化页面中的 Alpine.js 组件（含 dcard 分页下拉等）

v0.5.9 (2026-06-23)

• 顶栏导航
  • 新增 start_icon、end_icon 配置，可在菜单文字前后显示图标（如语言切换、外链提示）
  • 新增 reflect_active_child：子菜单项对应当前页时，父项自动显示该子项标题（适用于语言切换等场景）
  • 新增 no_highlight：指定菜单项不参与当前页高亮样式
  • 新增 match_children_prefix：父菜单开启后，其直接子项可按 URL 前缀匹配当前页（含首页 /）。适用于语言切换菜单中 English 指向 /、需在未单独入导航的页面（如更新日志页）仍正确高亮的场景
  • 新增 exact_match：指定菜单项仅在实际对应页面高亮（如中文首页 /zh/ 不会在其它中文子页面误高亮）；与 match_children_prefix 同时生效时，精确匹配优先

v0.5.8 (2026-06-22)

• 侧栏导航
  • 修复无刷新换页时，侧栏导航树偶发「先折叠再展开」闪烁、当前位置高亮短暂丢失的问题；换页后侧栏的展开与滚动状态现可稳定保留

v0.5.7 (2026-06-22)

• 锚点跳转（小屏）
  • 修复首次打开（未缓存）带 #锚点 链接的页面时，标题未对齐顶部、下方残留多余空白的问题
  • 字体、图片等资源加载完成导致正文高度变化后，自动将标题重新校正到正确位置（其间手动滚动会立即让出控制权）

v0.5.6 (2026-06-22)

• 锚点跳转
  • 统一锚点滚动服务，修复小屏冷启动带 #锚点 进入页面时标题被目录栏遮挡的问题
  • 目录点击、无刷新换页、浏览器前进后退等场景的跳转位置保持一致

v0.5.5 (2026-06-22)

• 目录（小屏）
  • 修复通过带锚点链接进入页面时，标题显示位置不正确的问题

v0.5.4 (2026-06-22)

• 侧栏导航（小屏）

  • 修复 stack 布局下菜单按钮无法打开侧栏、或打开后无法点击导航链接的问题
  • 侧栏抽屉展开时贴顶满高显示，桌面端布局不受影响
  • 侧栏抽屉限制最大宽度，避免过宽遮挡正文
  • 修复 AJAX 无刷新换页后侧栏菜单按钮可能失效的问题

• 目录（小屏）

  • 修复展开目录后点击条目时，正文未能准确滚到对应标题的问题；目录较短、点击前几项时尤为明显
  • 修复通过带锚点链接进入页面时，标题显示位置不正确的问题

v0.5.3 (2026-06-20)

• 新增 body_end_html 配置项，可在每个页面底部追加自定义 HTML，便于接入统计脚本、在线客服等第三方组件

v0.5.2 (2026-06-20)

• 顶栏导航

  • 改进当前页高亮：首页仅精确匹配，不再因子路径误高亮
  • 目录链接正确匹配子页面，与侧栏导航规则一致
  • 浮动菜单中当前页条目也会高亮，无需先展开下拉

• 站内搜索

  • 修复 AJAX 无刷新换页后顶栏 Algolia 搜索框消失或失效的问题
  • 换页前自动关闭浮层搜索，避免弹层残留

• 目录（TOC）

  • 修复桌面端 sticky 目录高度溢出视口的问题，长目录可正常滚动浏览
  • 滚动正文时活跃目录项自动滚入可见区域
  • 修复重复锚点 id 导致多个目录项同时高亮的问题
  • 目录滚动与页面滚动隔离，小屏展开目录不再带动整页滚动
  • 小屏展开目录按实际位置动态限高，避免内容被裁切或超出屏幕
  • AJAX 换页后桌面目录增量更新，切换更流畅
  • 滚动高亮仅标记当前标题，不再联动高亮父级标题

v0.5.1 (2026-06-17)

• 修复多语言站点下，站点名称、导航、页脚等配置未按当前语言正确显示的问题
• 修复未配置可选功能（如 Algolia 搜索、有啥评论、版权信息等）时，页面可能渲染失败的问题

v0.5.0 (2026-06-17)

新功能

Stack 布局模式

• book 模板新增 stack 布局：顶栏全宽展示站点品牌，下方左侧导航、右侧正文，适合文档类站点
• 用 nav_file 替代 summary，未配置时自动隐藏侧栏与上下页导航
• Sidebar / TopHeader 按布局模式智能切换站点 Header 与菜单按钮展示

页面打印与二维码

• 新增 layout.hide_print_button 与 layout.hide_page_qrcode 配置项，可按页面或全局控制打印按钮和页面二维码的显示
• front matter 优先于 layout 全局配置，粒度更细

目录与标题显示控制

• 新增 meta.hide_toc、meta.hide_title 控制单页目录与标题的显隐

AJAX 无刷新导航（PJAX v5）

• 全面重构为零感知 PJAX 引擎，页面切换无闪烁、无白屏
• 新增链接预取缓存，鼠标悬停即后台加载，导航几乎零延迟
• 布局指纹机制：head 资源变化时自动整页刷新，保证样式与脚本一致性
• 侧栏导航树、TOC、代码高亮等组件在 AJAX 导航后自动重新挂载

统一锚点滚动

• 抽取通用锚点滚动工具，支持嵌套滚动容器定位
• TOC 点击、heading 锚点、URL hash 导航行为完全统一
• stack 布局下自动联动顶栏高度，滚动定位准确

改进

侧栏导航树

• 锚点导航（点击 TOC / 带 hash 的链接）后自动刷新侧栏高亮，不再需要手动滚动到对应位置
• 目录路径 index.html 与尾斜杠 / 正确等价识别，避免目录首页误高亮
• 节点交互样式下沉至可点击链接，热区更准确；展开/折叠图标垂直居中，多行标题不再错位

侧栏宽度拖拽

• 修复 PJAX 导航后侧栏宽度拖拽器失效的问题（浏览器前进/后退、站内链接切换后均可正常拖拽）

Markdown 排版

• 移除 h2 左侧装饰条，标题样式更简洁
• 修复仅含 <code> 的链接下划线穿透背景的问题
• 标题锚点图标替换为链环样式

Hash 导航与历史回退

• 修复浏览器前进/后退（popstate）时误触发全页请求的问题
• 目录（TOC）链接添加 data-no-ajax，避免点击目录条目被 pjax 拦截

内部优化

• 构建系统命名统一：ssr-* 改为 jsrender-*，fe-* 改为 client-*，消除与运行时 SSR 的歧义
• scrollAnchor 工具迁入 youlog_lib/core，TOC 与 page-ajax 共用，减少重复代码
• widget 文档规范建立，各模块入口聚合到 index.ts，README 结构统一
• set_latest_release 发布脚本强制校验 changelog，确保每次发布都有版本说明

v0.4.3 (2026-04-10)

• .markdown-body 在 CJK 语言（zh/ja/ko）下对段落、列表项、引用块使用两端对齐（justify）

v0.4.2 (2026-03-18)

• 移除 NavTree 中的 markdown_body

v0.4.1 (2026-03-18)

• 增加配置 config.features.code_highlight 代码高亮开关，默认为 true
• 增加配置 config.features.katex_fomula 公式渲染， 默认为 false

v0.4.0 (2026-03-18)

• 优化模块源码结构
• 优化脚注、代码高亮、公式渲染

v0.3.16 (2025-12-09)

• 正文内容中的链接添加下划线
• 添加 alert 块：.tips, .info, .success, .warning, .error

v0.3.15 (2025-11-23)

• 添加标记属性 data-doc-meta-permalink

v0.3.14 (2025-11-23)

• 更改 updated_at 图标
• 切换永久链接字段至 permalink

v0.3.13 (2025-11-23)

• DocMeta 使用图标

v0.3.12 (2025-11-20)

• 增加 dcard/palyer

v0.3.11 (2025-11-14)

• 优化界面

v0.3.10 (2025-11-14)

• 优化界面

v0.3.9 (2025-11-14)

• 优化界面

v0.3.8 (2025-11-14)

• 修复 Theme Reset 时界面数值不变
• 优化界面

v0.3.7 (2025-11-13)

• 添加扫码打开本页面
• 新增打印功能
• 修复字号、字体、暗黑设置
• 重构导航结构解析
• 优化样式

v0.3.6 (2025-11-12)

• 修复有啥评论接入

v0.3.5 (2025-11-11)

• 增加 dcard/items

v0.3.4 (2025-11-10)

• 优化 meta 信息展示
• dcard/list 更新
  1. 去除 updated 标记
  2. 支持 hide_prev_next 上下页导航

v0.3.3 (2025-11-08)

• 修复 Breadcrumbs 点击获取路径问题

v0.2.8 (2025-10-17)

• 增加 $CONFIG.layout.aside_no_header 用来控制边栏是否显示 Header