面向 Dart 文档站点的 Jaspr 迁移工具包
本周最明确的构建变化,是给已经用 Dart 编写内容和交互式文档的团队提供了一条迁移路径。Flutter 和 Dart 已将 dart.dev、flutter.dev 和 docs.flutter.dev 迁移到 Jaspr,把原先拆开的 Node.js 和 Python 方案统一为一套 Dart 工具链。这清楚表明,只用 Dart 的文档栈已经适用于大型文档站点,能够处理 Markdown 内容和少量交互功能。
这里适合做的产品,是面向文档团队的迁移工具包:内容模型转换器、模板适配器、partial-hydration 组件起步套件,以及在保留更丰富代码示例、测验和嵌入式工具的同时保证静态页面速度的 CI 检查。真正的痛点不是抽象的框架选型,而是贡献者环境配置、跨站点维护,以及静态文档站点每增加一个交互元素时都要额外付出的开发成本。
一个低成本测试,是先迁移一个包含多种内容类型的版块,比如教程加交互式示例,然后比较贡献者的环境搭建时间、CI 中构建工具的数量,以及迁移后还剩多少自定义 DOM 脚本。现有证据没有给出基准测试数据,所以在全面重建前,任何采用决策仍需要先做本地性能测量。