跳到主题内容 跳到文档导航栏

构建工具

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

编译前环境部署

Bootstrap使用 npm scripts用于其构建系统。我们的package.json 包含使用该框架的便捷方法,包括编译代码,运行测试等。

要使用我们的构建系统并在本地运行我们的文档,您将需要Bootstrap的源文件和Node的副本。请按照以下步骤操作:

  1. 下载安装 Node.js,我们将使用它来管理依赖项。
  2. 下载 Bootstrap’s sources 或 fork Bootstrap’s repository.
  3. 导航到根 /bootstrap 目录并运行 npm install 以安装package.json中所定义的本地依赖项。

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

使用npm脚本

我们的 package.json 包含许多用于开发项目的任务。运行npm run 以查看终端中的所有npm脚本。主要任务包括:

任务 描述
npm start 编译CSS和JavaScript,构建文档,然后启动本地服务器。
npm run dist 使用编译文件创建 dist/目录。需要Sass, Autoprefixer, and terser.
npm test 启动后在本地进行测试 npm run dist
npm run docs-serve 在本地构建和运行文档。

Autoprefixer

Bootstrap使用 Autoprefixer 在编译时(及编译过程中)自动将浏览器厂商的个性前缀添加到某些CSS属性上。这样做允许我们一次编写CSS的关键部分,同时避免了像v3中那样的供应商混合,从而节省了我们的时间和代码。

我们将通过Autoprefixer支持的浏览器列表保存在GitHub存储库中的单独文件中。有关详细信息,请参见. .browserslistrc for details.

RTLCSS

Bootstrap使用 RTLCSS 处理已编译的CSS并将其转换为RTL –基本上用相反的属性替换了水平方向感知的属性(例如padding-left)。它允许我们仅编写CSS一次,并使用RTLCSS控件指令进行较小的调整。

本地文档

在本地运行我们的文档需要使用Hugo,它是通过hugo-bin npm软件包安装的。Hugo是一个快速且可扩展的静态站点生成器,它为我们提供:基本包括,基于Markdown的文件,模板等。这是开始的方法:

  1. 运行上面的 编译前环境部署 以安装所有依赖项。
  2. 在根 /bootstrap 目录中, 运行 npm run docs-serve 命令。
  3. 在浏览器中打开http://localhost:9001/

阅读其文档了解有关使用Hugo的更多信息。

故障排除

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