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。