使用我们的文档构建脚本和测试帮助开发 Bootstrap。
工具设置
Bootstrap 使用 npm 脚本来构建文档和编译源文件。我们的package.json包含这些脚本，用于编译代码、运行测试等。这些不打算在我们的存储库和文档之外使用。
要使用我们的构建系统并在本地运行我们的文档，您需要 Bootstrap 的源文件和 Node 的副本。按照以下步骤作，您应该准备好摇滚了：
- 下载并安装Node.js，我们用它来管理我们的依赖项。
- 下载 Bootstrap 的源代码或分叉并克隆 Bootstrap 的存储库。
- 导航到根目录并运行以安装 package.json 中列出的本地依赖项。
/bootstrapnpm install
完成后，您将能够运行命令行提供的各种命令。
使用 npm 脚本
我们的package.json包括开发项目的许多任务。运行以查看终端中的所有 npm 脚本。主要任务包括：npm run
| 任务 | 描述 |
|---|---|
npm start | 编译 CSS 和 JavaScript，构建文档，并启动本地服务器。 |
npm run dist | 使用已编译的文件创建目录。使用 Sass、Autoprefixer 和 terser。dist/ |
npm test | 运行后在本地运行测试npm run dist |
npm run docs-serve | 在本地生成和运行文档。 |
通过我们的入门项目通过 npm 开始使用 Bootstrap！前往 Sass & JS 示例模板存储库，了解如何在您自己的 npm 项目中构建和自定义 Bootstrap。包括 Sass 编译器、Autoprefixer、Stylelint、PurgeCSS 和 Bootstrap 图标。
萨斯
Bootstrap 使用 Dart Sass 将我们的 Sass 源文件编译为 CSS 文件（包含在我们的构建过程中），如果您使用自己的资产管道编译 Sass，我们建议您执行相同的作。我们之前将 Node Sass 用于 Bootstrap v4，但 LibSass 和基于其构建的包（包括 Node Sass）现在已被弃用。
Dart Sass 使用舍入精度 10，出于效率原因不允许调整此值。在进一步处理生成的 CSS 期间，例如在缩小期间，我们不会降低此精度，但如果您选择这样做，我们建议保持至少 6 的精度，以防止浏览器舍入出现问题。
自动前缀
Bootstrap 使用 Autoprefixer（包含在我们的构建过程中）在构建时自动将供应商前缀添加到某些 CSS 属性中。这样做可以节省我们的时间和代码，因为我们可以一次性编写 CSS 的关键部分，同时消除了对 v3 中供应商混合的需求。
我们将通过 Autoprefixer 支持的浏览器列表保存在 GitHub 存储库中的单独文件中。有关详细信息，请参阅 .browserslistrc。
RTLCSS
Bootstrap 使用 RTLCSS 来处理编译的 CSS 并将它们转换为 RTL – 基本上是将水平方向感知属性（例如 ）替换为相反的属性。它只允许我们编写一次 CSS，并使用 RTLCSS 控制和值指令进行细微调整。padding-left
本地文档
在本地运行我们的文档需要使用 Astro。Astro 是一个现代静态站点生成器，它允许我们使用 Markdown 和 React 组件的组合来构建我们的文档。以下是如何开始它：
- 运行上面的工具设置以安装所有依赖项。
- 从根目录中，在命令行中运行。
/bootstrapnpm run docs-serve - 在浏览器中打开 http://localhost:9001，瞧。
阅读其文档，了解有关使用 Astro 的更多信息。
故障 排除
如果您在安装依赖项时遇到问题，请卸载所有以前的依赖项版本（全局和本地）。然后，重新运行 。npm install