在线文档教程

构建工具 | Build tools

Build tools

学习如何使用Bootstrap包含的npm脚本来构建我们的文档,编译源代码,运行测试等等。

工具设置

Bootstrap 为其构建系统使用NPM脚本。我们的package.json包含了处理框架的便捷方法,包括编译代码,运行测试等等。

要使用我们的构建系统并在本地运行我们的文档,您需要一份Bootstrap源文件和Node的副本。按照这些步骤,你应该准备好摇滚:

完成后,您将能够运行命令行提供的各种命令。

使用NPM脚本

我们的package.json包含以下命令和任务:

任务描述
npm run distnpm 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

通过阅读文档了解更多关于使用Jekyll的信息

故障排除

如果遇到安装依赖关系的问题,请卸载所有以前的依赖项版本(全局和本地)。然后,重新运行npm install