构建工具
了解学习如何使用Bootstrap随附的npm脚本来构建我们的文档,编译源代码,运行测试等。
编译前环境部署
Bootstrap使用 npm scripts用于其构建系统。我们的package.json 包含使用该框架的便捷方法,包括编译代码,运行测试等。
要使用我们的构建系统并在本地运行我们的文档,您将需要Bootstrap的源文件和Node的副本。请按照以下步骤操作:
- 下载安装 Node.js,我们将使用它来管理依赖项。
- 下载 Bootstrap’s sources 或 fork Bootstrap’s repository.
- 导航到根
/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的文件,模板等。这是开始的方法:
- 运行上面的 编译前环境部署 以安装所有依赖项。
- 在根
/bootstrap
目录中, 运行npm run docs-serve
命令。 - 在浏览器中打开
http://localhost:9001/
阅读其文档了解有关使用Hugo的更多信息。
故障排除
如果您在安装依赖项时遇到问题,请卸载所有以前的依赖项版本(全局和本地)。然后重新运行npm install
.