tmcw/big 项目升级指南：从旧版本迁移到 Big 4 的关键变化

tmcw/big 项目升级指南：从旧版本迁移到 Big 4 的关键变化

前言

tmcw/big 是一个专注于简洁高效的演示文稿工具，其最新版本 Big 4 带来了一系列重大变革。本文将详细介绍这些变化，帮助现有用户理解升级路径，并为新用户提供技术背景知识。

核心架构变化

1. 模块化精简

Big 4 移除了原先的多个辅助模块，这是基于实际使用情况和维护成本的深思熟虑：

• big-compose：原先的Markdown转HTML工具被移除，因为：
  • 实际使用率低
  • Markdown无法完全表达Big的布局需求
  • 开发者认为原生HTML是更直接有效的标记语言

技术建议：对于简单文本，直接使用HTML的<p>标签；复杂布局则使用div配合CSS。

• big-offline：离线功能支持被简化，因为：
  • 现代浏览器的"保存网页"功能已足够
  • 更推荐开发者自主管理静态资源

最佳实践：将所有资源（图片、CSS等）放在同一目录下，使用相对路径引用。

• big-serve：本地服务器功能被移除，因为：
  • 双击HTML文件即可直接查看
  • 有其他更专业的本地服务器方案

2. 音频功能移除

虽然音频轨道曾是Big的特色功能，但实际使用数据显示：

• 用户使用率极低
• 与项目追求的极简主义理念冲突
• 增加了代码复杂性和维护成本

替代方案：如需音频，可使用HTML5的<audio>标签自行实现。

设计与排版优化

字体变更

Big 4 移除了默认的Rubik字体，改为使用系统默认字体（如macOS的San Francisco），这是因为：

1. 性能考量：网页字体是额外的网络请求和资源负担
2. 兼容性：系统字体渲染效果更好
3. 一致性：与操作系统设计语言保持一致

自定义建议：如需特殊字体，可通过CSS的@font-face自行引入。

项目初始化简化

原先的big-init命令行工具被简化为直接下载模板文件，这：

• 降低了使用门槛
• 减少了依赖项
• 更符合现代前端开发习惯

升级建议

1. 现有项目迁移：

   • 手动将Markdown内容转换为HTML
   • 检查并更新所有资源引用路径
   • 移除对已删除功能的依赖

2. 新项目开发：

   • 直接从最新模板开始
   • 采用纯HTML编写内容
   • 合理组织项目结构

3. 最佳实践：

   <!-- 典型幻灯片结构示例 -->
   <div class="slide">
     <h1>幻灯片标题</h1>
     <p>内容使用标准HTML元素</p>
     <div class="custom-layout">
       <!-- 自定义布局 -->
     </div>
   </div>
   

总结

Big 4 的变革体现了软件开发的"少即是多"哲学，通过精简功能来：

• 提高核心功能的稳定性
• 降低学习曲线
• 增强可维护性
• 给予开发者更多灵活性

这些变化虽然需要现有用户进行一定调整，但长远来看将使项目更加可持续，也让演示文稿开发回归Web技术的本质。