v1.0.0

v1.0.0 发布说明

这是 Navfolio 的一次重要重构版本。v1 不只是功能更新，也调整了模板的内部依赖组织、文档内容来源和配置方式，为后续插件化和页面模块化做准备。

破坏性改动

• 重构了模板依赖系统，部分 Markdown、页面能力和模块能力开始由 @navfolio/* 包统一接入。
• 文档站内容改为通过 src/docs 子仓库作为内容源构建。
• 部分页面、博客归档、字体、元信息和导航相关配置迁移到更明确的配置结构中。
• 如果你从旧版本升级，需要检查依赖、site.toml、内容目录和构建脚本是否仍然匹配当前项目结构。

主要更新

• 新增 docs 子仓库内容源构建能力，文档站和模板主体解耦。
• 博客归档页大幅增强，支持置顶文章、分类/系列/标签/年份等更完整的浏览方式。
• 新增可配置字体系统，支持 UI 字体、中文字体、代码字体和字体子集化。
• 新增博客 UI 多语言配置，支持更灵活的界面文案。
• 新增可配置文章元信息格式，包括日期、分类、系列、标签和分隔样式。
• 新增可配置 connect links 和 RSS feed。
• Markdown 渲染增强，支持 Mermaid 图表、响应式表格、稳定的 TOC hash。
• 修复图片缩放预览、Markdown 表格移动端渲染等问题。
• 优化博客列表、归档页和阅读体验的视觉布局。

依赖与维护

• 升级了多项生产依赖和 GitHub Actions 依赖。
• 调整了构建、部署和文档内容组织方式，为后续插件化维护打基础。
• 旧版本的内容将保留在main分支上，不再进行功能或页面升级

---

What's Changed

• Fix zoomable image gallery preview controls by @dodolalorc in #75
• Fix zoomable image review feedback by @dodolalorc in #76
• feat: build docs from submodule content source by @dodolalorc in #77
• feat: add sticky blog posts by @dodolalorc in #79
• feat: add configurable font system by @dodolalorc in #83
• chore(deps): bump the production-dependencies group with 8 updates by @dependabot[bot] in #81
• chore(deps): bump actions/checkout from 6 to 7 in the ci-dependencies group by @dependabot[bot] in #80
• feat: configure archive page copy from site config by @dodolalorc in #84
• feat: add configurable connect links and rss feed by @dodolalorc in #86
• Align blog config and archive list layout by @dodolalorc in #87
• feat: add configurable blog metadata formatting by @dodolalorc in #88
• feat: add configurable code font by @dodolalorc in #89
• Fix responsive rendering for markdown tables by @dodolalorc in #91
• feat: add configurable blog UI localization by @dodolalorc in #92
• feat: render mermaid diagrams in markdown by @dodolalorc in #93
• fix: use github-slugger for toc hashes by @dodolalorc in #94
• chore: refine blog archive layout by @dodolalorc in #96

Full Changelog: v0.3.0...v1.0.0

navfolio v0.3.0 发布🙌

v0.3.0

Features

• Add sitewide scroll-to-top button with accessibility/state fixes. Thanks @dodolalorc. #66
• Add tag archive pages at /tags/[tag]/, including clickable tag metadata in archive rows and article headers. Thanks @dodolalorc. #65
• Add Markdown and MDX math rendering support with configurable KaTeX / MathJax renderer. Thanks @dodolalorc. #63
• Upgrade article table of contents to a nested h2-h6 tree with accessible expand/collapse behavior and active-link syncing. Thanks @dodolalorc. #62
• Improve /vibe image flow layout with count-aware grids, expand/collapse behavior, and zoom preview. Thanks @dodolalorc. #60
• Add full font warmup to prefetch the full LXGW Chinese reading font after load/idle without blocking the first screen. Thanks @dodolalorc. #58
• Add agent / DeepSeek code review workflow and PR-label controlled automation. Thanks @virgiling and @dodolalorc.

Fixes

• Fix navbar layout shift when switching between pages with and without scrollbars. Thanks @wtw0212. #51
• Prevent template deployments from using demo Giscus comment configuration by default.
• Preserve Astro’s markdown pipeline while enabling math rendering.
• Fix TOC tree behavior around IntersectionObserver, replaceAll compatibility, active branch collapse, and sidebar auto-scroll.
• Fix tag archive optional tag handling and modified-click behavior for archive back links.
• Fix vibe image toggle rebinding after transitions.
• Fix full font warmup listener / timeout cleanup.
• Refine article heading hierarchy and spacing.

Performance

• Use lightweight UI subset font for index/page-heading surfaces.
• Reuse grouped tag posts in tag archive generation.
• Warm up full article font after initial page load instead of adding it to the critical path.

Chores

• Add MIT License and CONTRIBUTING.md.
• Add Dependabot, ESLint, and Husky pre-commit checks.
• Update CI dependencies via Dependabot. Thanks @dependabot. #46
• Update production dependencies, including Astro 7 / MDX 7 / Expressive Code 0.44 / Sharp 0.35.2 / TypeScript 6.0.3. Thanks @dependabot. #48 #57

navfolio v0.2.0 发布🙌

这次更新主要聚焦在阅读流畅性优化和新功能增加。

✨ Features

• 新增*categories（分类）和series（专题）*板块，适配同名md元数据，实现更好的文章分类 #37
• 增添代码块的样式优化和复制能力 #20 #33

⚡ Performance

• 优化 route transitions
• 减少 hydration 开销
• 改进字体加载策略
• 降低 CLS 与 layout shifting

🔧 Refactor

• 进行博文和模板的分离，减少应用主题时的冗余内容

🐞 Fixes

• 修复和新增giscus系统的明暗双主题适配 #34
• 修复Waline评论系统css引入问题 #39

🚧 Next

• blogs 支持 tags 分类索引页面

navfolio v0.1.0

navfolio v0.1.0

一个围绕「内容展示 + 个人表达」构建的 Astro 主题，是一个带有个人气质的数字名片、作品集与内容空间。

v0.1.0 功能特性

• 基于 Astro 构建，轻量、静态优先、部署简单
• Markdown / MDX 内容驱动
• Blog / Projects / Vibe 多内容路由
• 明暗主题切换和更多主题色
• 精细化 Typography 与阅读体验优化
• 响应式布局，适配移动端
• GitHub 风格的低干扰卡片设计
• 热力图 / 活跃度展示组件
• 支持自定义导航与社交链接
• 评论系统
• 搜索能力

适合谁

• 想搭建个人博客的人
• 想展示项目与文章的开发者
• 使用 Markdown 写作的人
• 喜欢 Astro 与静态内容工作流的人
• 想拥有更“个人化”主页的创作者

关于这个版本

v0.1.0 是 navfolio 的第一个可用版本。
核心布局、内容结构与主题风格已经基本稳定，后续会继续完善更多细节
欢迎体验、提 issue、一起完善它。