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