编译工具
了解如何使用Bootstrap包含的npm脚本来构建文档、编译源代码、运行测试等等。
部署设置
Bootstrap为其构建系统使用 npm scripts 。我们的 package.json 包含使用框架的方便方法,包括编译代码、运行测试等。
要使用我们的构建系统(进行编译)并在本地运行我们的文档,首先需要一个Bootstrap的源文件和Nodejs安装程序副本。如果你应该已经准备好开始动手,让我们一起参照下面的步骤启动来实施:
- 下载并安装Node.js, 我们用它来管理我们的依赖关系。
- 下载Bootstrap的源码,或者下载fork Bootstrap的存储库
- 导航到根目录
/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,并使用RTLCSScontrol和 value 指令做一些小调整。
本地文档
在本地运行我们的文档需要使用Hugo,它通过 hugo-bin npm安装。Hugo是一款非常快速且可扩展的静态站点生成器,它为我们提供了:基本包含、基于标记的文件、模板等等。具体参照下面的步骤启动来实施:
- 通过运行 tooling setup 以上安装所有依赖。
- 在
/bootstrap
根目录,运行npm run docs-serve
命令行。 - 在浏览器打开
http://localhost:9001
网址,大功造成!
故障排除
如果在安装依赖项时遇到问题,请卸载以前所有的依赖项版本(全局和本地)。然后,重新运行 npm install
。