博客
-
Docsy 0.10.0 发布报告
2024年5月1日 在 博客
Docsy 0.10.0 最大的新闻，是颜色主题与深色模式！ Hugo：破坏性变更与弃用通知 这个版本把 Docsy 的 Hugo 依赖从 0.122.0 升级到 0.125.4。需要特别注意：Hugo 0.123.0 是一次重大升级，包含若干 破坏性变更。升级到本版 Docsy 前，请审阅 Hugo 自 0.122.0 以来的弃用通知与破坏性变化。 提醒 Docsy 及其对等软件包的正式支持范围见正式支持边界。 本次发布的许多更新用于处理 Hugo 弃用通知。完整清单可在 0.10.0 版本变 …
-
Docsy 0.9.0 发布报告
2024年2月9日 在 博客
以 Docsy 的发布规模衡量，Docsy 0.9.0 是一次相当可观1的更新（包含 65 个以上 PR），其中有若干值得特别说明的破坏性和重要变更，主要涉及： Footer 改进 仓库链接及其他页面信息 外观与风格 持续集成测试 感谢所有贡献者！ Footer 改进 本版全部 Footer 改进与修复见 #1818。本节选取其中几项介绍。为了让定制更加容易，我们还为下一个主要版本规划了更多 Footer 改进（#1852）。 Footer 布局变更 为简化定制，Footer 布局被拆分为左、右 …
-
Docsy 2024 年工作重点
2023年11月28日 在 博客
摘要：已有 1,400 个项目使用 Docsy！2024 年面向使用方项目的首要任务，是提升 Docsy 的稳定性、易用性、可定制性与整体一致性，同时整合现有功能。 Docsy 是广受欢迎的主题 Hugo 与 Docsy 的组合强大而高效，我也曾在其他文章中介绍过。因而，看到 Docsy 已被 1,400 个项目使用1，或许并不令人意外。Docsy 为什么受欢迎？我无法给出确切答案，但我之所以使用并推荐它，是因为它具备发布成熟技术文档站所需的核心能力：版本管理、多语言、自动生成站点导航等。它上 …
-
升级到 Docsy 0.7 与 Bootstrap 5
2023年8月3日 在 博客
去年六月，Docsy 发布 0.7.0，迎来一项重要里程碑。这次重大升级源自历时六个月的细致工作（#470），核心任务是迁移到 Bootstrap 5.2。关于这段历程的亮点与缘由，请参阅迁移到 Bootstrap 5.2。 本文基于我升级 Docsy 0.7 的亲身经验，重点围绕 Bootstrap，帮助读者完成 Docsy 0.7 与 Bootstrap 5 升级。文章先为准备升级的 Docsy 项目提供通用建议。每个项目的迁移经历都不相同，但希望本文以及其中两个案例能让你的升级过程更轻松、 …
-
迁移到 Bootstrap 5.2
2023年6月5日 在 博客
Docsy 以及使用 Docsy 的项目网站（包括 CNCF 项目）从一开始便一直愉快地采用 Bootstrap CSS 框架。今年一月，Docsy 过去几年使用的 Bootstrap 4 终止维护。Docsy 指导委员会一直期待 Bootstrap 5 带来的改进，却也担心迁移工作量及其对下游项目的影响，因此尽可能推迟了迁移。2022 年 12 月 Bootstrap 4 停止接收关键更新后，我们宣布 Docsy 进入功能冻结期，并把维护工作集中到 Bootstrap 5 迁移上。 本文记录 …