构建工具

了解如何使用Bootstrap随附的npm脚本构建我们的文档,编译源代码,运行测试等。

工具设定

引导程序使用 npm脚本为其构建系统。 Our 的package.json 包括使用该框架的便捷方法,包括编译代码,运行测试等。

要使用我们的构建系统并在本地运行我们的文档,您需要一份Bootstrap的源文件和Node的副本。请按照以下步骤操作,您应该已经准备就绪：

下载并安装Node.js ,用于管理依赖项。
导航到根 /bootstrap 目录并运行 npm install 安装列出的本地依赖项的package.json .
安装Ruby ,安装邦德勒 with gem install bundler ,最后运行 bundle install 。这将安装所有Ruby依赖项,例如Jekyll和插件。
- Windows用户： Read 本指南使Jekyll正常运行。

完成后,您将可以运行命令行中提供的各种命令。

Our 的package.json 包括以下命令和任务：

Task	描述
`npm run dist`	`npm run dist` 创建 `/dist/` 包含编译文件的目录。 Uses Sass , 自动前缀 ,和终结者 .
`npm test`	与...一样 `npm run dist` 再加上它在本地运行测试
`npm run docs`	为文档构建和删除CSS和JavaScript。然后,您可以通过以下方式在本地运行文档 `npm run docs-serve`.

Run npm run 查看所有npm脚本。

引导程序使用自动前缀（包括在我们的构建过程中）在构建时自动将供应商前缀添加到某些CSS属性。这样做允许我们一次编写CSS的关键部分,同时省去了像v3中那样的供应商混合,从而节省了我们的时间和代码。

我们将通过Autoprefixer支持的浏览器列表保存在GitHub存储库中的单独文件中。 See .browserslistrc 详情。

在本地运行我们的文档需要使用Jekyll,Jekyll是一种相当灵活的静态站点生成器,它为我们提供：基本包含,基于Markdown的文件,模板等。入门方法如下：

通过阅读更多有关使用Jekyll的信息文件 .

如果您在安装依赖项时遇到问题,请卸载所有以前的依赖项版本（全局和本地）。然后,重新运行 npm install.