在 GitHub上查看

编译工具

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

部署设置

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

要使用我们的构建系统(进行编译)并在本地运行我们的文档,首先需要一个Bootstrap的源文件和Nodejs安装程序副本。如果你应该已经准备好开始动手,让我们一起参照下面的步骤启动来实施:

  1. 下载并安装Node.js, 我们用它来管理我们的依赖关系。
  2. 下载Bootstrap的源码,或者下载fork Bootstrap的存储库
  3. 导航到根目录 /bootstrap 并运行 npm install 来安装我们在 package.json中列出的本地依赖项。

完成后,你将能够运行命令行来执行的各种指令

使用NPM(nodejs)脚本

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

RTLCSS

Bootstrap使用 RTLCSS 来处理编译后的CSS并将其转换为RTL-基本上取代水平方向感知属性,(如。 padding-left),与之相反。它允许我们只编写一次CSS,并使用RTLCSScontrolvalue 指令做一些小调整。

本地文档

在本地运行我们的文档需要使用Hugo,它通过 hugo-bin npm安装。Hugo是一款非常快速且可扩展的静态站点生成器,它为我们提供了:基本包含、基于标记的文件、模板等等。具体参照下面的步骤启动来实施:

  1. 通过运行 tooling setup 以上安装所有依赖。
  2. /bootstrap 根目录,运行 npm run docs-serve 命令行。
  3. 在浏览器打开 http://localhost:9001 网址,大功造成!

了解Hugo更多信息

故障排除

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