构建工具 | Build tools
Build tools
学习如何使用Bootstrap包含的npm脚本来构建我们的文档,编译源代码,运行测试等等。
工具设置
Bootstrap 为其构建系统使用NPM脚本。我们的package.json包含了处理框架的便捷方法,包括编译代码,运行测试等等。
要使用我们的构建系统并在本地运行我们的文档,您需要一份Bootstrap源文件和Node的副本。按照这些步骤,你应该准备好摇滚:
- 下载并安装Node.js,我们用它来管理我们的依赖关系。
完成后,您将能够运行命令行提供的各种命令。
使用NPM脚本
我们的package.json包含以下命令和任务:
任务 | 描述 |
---|---|
npm run dist | npm run dist用编译的文件创建/ dist目录。使用Sass,Autoprefixer和UglifyJS。 |
npm测试 | 与npm run dist相同,它在本地运行测试 |
npm运行文档 | 构建和删除用于文档的CSS和JavaScript。然后您可以通过npm run docs-serve在本地运行文档。 |
运行npm run
以查看所有npm脚本。
Autoprefixer
Bootstrap使用Autoprefixer(包含在我们的构建过程中)在构建时自动将供应商前缀添加到某些CSS属性。这样做可以节省时间和代码,让我们可以一次性编写CSS的关键部分,同时不再需要像v3中那样的供应商混合类。
我们通过我们的GitHub存储库中的单独文件来维护通过Autoprefixer支持的浏览器列表。有关详细信息,请参阅/package.json。
当地文件
在本地运行我们的文档需要使用Jekyll,这是一款体面灵活的静态站点生成器,它为我们提供:基本包含,基于Markdown的文件,模板等。以下是如何开始它:
- 运行上面的工具安装程序以安装Jekyll(站点构建器)和其他Ruby依赖项
bundle install
。
故障排除
如果遇到安装依赖关系的问题,请卸载所有以前的依赖项版本(全局和本地)。然后,重新运行npm install
。