Source

构建工具

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

工具设置

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

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

  1. 下载并安装 Node.js，我们用它来管理我们的依赖项。
  2. 导航到根/bootstrap目录并运行以安装我们在package.jsonnpm install中列出的本地依赖项。
  3. 安装 Ruby，安装Bundler，gem install bundler最后运行bundle install。这将安装所有 Ruby 依赖项，例如 Jekyll 和插件。
    • Windows 用户：阅读本指南，让 Jekyll 顺利启动并运行。

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

使用 NPM 脚本

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

任务 描述
npm run dist npm run dist创建/dist包含编译文件的目录。使用Sass、Autoprefixer和UglifyJS。
npm test 与npm run distplus 相同，它在本地运行测试
npm run docs 为文档构建和检查 CSS 和 JavaScript。然后，您可以通过在本地运行文档npm run docs-serve。

运行npm run以查看所有 npm 脚本。

自动前缀

Bootstrap 使用Autoprefixer（包含在我们的构建过程中）在构建时自动将供应商前缀添加到某些 CSS 属性。这样做可以让我们一次性编写 CSS 的关键部分，同时消除对 v3 中的供应商 mixin 的需求，从而节省了我们的时间和代码。

我们在 GitHub 存储库中的单独文件中维护通过 Autoprefixer 支持的浏览器列表。有关详细信息，请参阅/.browserslistrc。

本地文档

在本地运行我们的文档需要使用 Jekyll，这是一个相当灵活的静态站点生成器，它为我们提供：基本包含、基于 Markdown 的文件、模板等。以下是如何开始：

  1. 运行上面的工具设置以安装 Jekyll（站点构建器）和其他 Ruby 依赖项bundle install。
  2. 从根/bootstrap目录，npm run docs-serve在命令行中运行。
  3. http://localhost:9001在浏览器中打开，瞧。

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

故障排除

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