From 32f2de17d4faeb7b74b0f1b46c43800e3acedf36 Mon Sep 17 00:00:00 2001 From: Mario Date: Thu, 5 Oct 2023 10:17:07 +0000 Subject: composer update bootstrap --- .../site/content/docs/5.3/customize/sass.md | 57 +++++++++++++++++++--- 1 file changed, 49 insertions(+), 8 deletions(-) (limited to 'vendor/twbs/bootstrap/site/content/docs/5.3/customize') diff --git a/vendor/twbs/bootstrap/site/content/docs/5.3/customize/sass.md b/vendor/twbs/bootstrap/site/content/docs/5.3/customize/sass.md index 6da6bbe2b..ceadf3a98 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.3/customize/sass.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.3/customize/sass.md @@ -14,23 +14,25 @@ Whenever possible, avoid modifying Bootstrap's core files. For Sass, that means ```text your-project/ -├── scss +├── scss/ │ └── custom.scss └── node_modules/ - └── bootstrap - ├── js - └── scss +│ └── bootstrap/ +│ ├── js/ +│ └── scss/ +└── index.html ``` If you've downloaded our source files and aren't using a package manager, you'll want to manually create something similar to that structure, keeping Bootstrap's source files separate from your own. ```text your-project/ -├── scss +├── scss/ │ └── custom.scss -└── bootstrap/ - ├── js - └── scss +├── bootstrap/ +│ ├── js/ +│ └── scss/ +└── index.html ``` ## Importing @@ -85,6 +87,45 @@ In your `custom.scss`, you'll import Bootstrap's source Sass files. You have two With that setup in place, you can begin to modify any of the Sass variables and maps in your `custom.scss`. You can also start to add parts of Bootstrap under the `// Optional` section as needed. We suggest using the full import stack from our `bootstrap.scss` file as your starting point. +## Compiling + +In order to use your custom Sass code as CSS in the browser, you need a Sass compiler. Sass ships as a CLI package, but you can also compile it with other build tools like [Gulp](https://gulpjs.com/) or [Webpack](https://webpack.js.org/), or with a GUI applications. Some IDEs also have Sass compilers built in or as downloadable extensions. + +We like to use the CLI to compile our Sass, but you can use whichever method you prefer. From the command line, run the following: + +```shell +# Install Sass globally +npm install -g sass + +# Watch your custom Sass for changes and compile it to CSS +sass --watch ./scss/custom.scss ./css/custom.css +``` + +Learn more about your options at [sass-lang.com/install](https://sass-lang.com/install) and [compiling with VS Code](https://code.visualstudio.com/docs/languages/css#_transpiling-sass-and-less-into-css). + +{{< callout info >}} +**Using Bootstrap with another build tool?** Consider reading our guides for compiling with [Webpack]({{< docsref "/getting-started/webpack" >}}), [Parcel]({{< docsref "/getting-started/parcel" >}}), or [Vite]({{< docsref "/getting-started/vite" >}}). We also have production-ready demos in [our examples repository on GitHub](https://github.com/twbs/examples). +{{< /callout >}} + +## Including + +Once your CSS is compiled, you can include it in your HTML files. Inside your `index.html` you'll want to include your compiled CSS file. Be sure to update the path to your compiled CSS file if you've changed it. + +```html + + + + + + Custom Bootstrap + + + +

Hello, world!

+ + +``` + ## Variable defaults Every Sass variable in Bootstrap includes the `!default` flag allowing you to override the variable's default value in your own Sass without modifying Bootstrap's source code. Copy and paste variables as needed, modify their values, and remove the `!default` flag. If a variable has already been assigned, then it won't be re-assigned by the default values in Bootstrap. -- cgit v1.2.3