README

Silverstripe BootLoader是一个扩展，旨在将Bootstrap 5框架文件无缝集成到Silverstripe项目中。它将CSS和JS注入到您网站的依赖项中。它通过注入自己的带有变量和覆盖的SCSS来允许对Bootstrap进行样式化。

包含的Bootstrap版本：5.3.3

要求

使用Composer安装

composer require minimalic/silverstripe-bootloader

通过在shell中导航到您网站的根目录并运行以下命令刷新您的数据库：vendor/bin/sake dev/build "flush=all"

或使用基本URL：/dev/build?flush=all

自定义步骤是可选的。您可以使用位于themes/main/scss/目录中的_bs-variables.scss覆盖标准的Bootstrap变量。

警告

自定义可能会修改themes/main/css/目录中（如果有的话）的所有CSS文件，使用css-prefix和其他编译Bootstrap所需的工具。

如果您需要注入自己的Bootstrap变量和覆盖，您应该从使用npm安装sass、nodemon和postcss开始。

编译需要以下三个文件位于您的themes/main/scss/目录中

第一个将在@import "functions";之后立即加载，第二个将在所有其他Bootstrap模块之后加载。您可以在SCSS文件中创建变量覆盖。

style.scss是您自己的主题样式表。

现在您可以使用以下命令编译新的自定义Bootstrap CSS文件

cd vendor/minimalic/silverstripe-bootloader/client/src/
npm run-script watch

或从Silverstripe的根目录

npm --prefix ./vendor/minimalic/silverstripe-bootloader/client/src/ run-script watch

将在您的themes/main/css/目录中生成新的bootstrap-custom.css文件（并覆盖）。

原始的bootstrap.min.css将自动替换为您自定义和编译的Bootstrap版本。

run-script watch也将监视并编译位于themes/main/scss/中的您自己的SCSS文件style.scss，并将其编译到themes/main/css/中。您现有的themes/main/css/style.css（如果有的话）将被覆盖。