Initial commit

vendor/yiisoft/yii2-bootstrap5/docs/guide/asset-bundles.md

@@ -0,0 +1,18 @@
+Asset Bundles
+=============
+
+Bootstrap is a complex front-end solution, which includes CSS, JavaScript, fonts and so on.
+In order to allow you the most flexible control over Bootstrap components, this extension provides several asset bundles.
+They are:
+
+- [[yii\bootstrap5\BootstrapAsset|BootstrapAsset]] - contains only the main CSS files.
+- [[yii\bootstrap5\BootstrapPluginAsset|BootstrapPluginAsset]] - depends on [[yii\bootstrap5\BootstrapAsset]], contains the javascript files.
+- [[yii\bootstrap5\BootstrapIconAsset|BootstrapIconAsset]] - contains Bootstrap icons.
+
+Particular application needs may require different bundle (or bundle combination) usage.
+If you only need CSS styles, [[yii\bootstrap5\BootstrapAsset]] will be enough for you. However, if
+you intend to use Bootstrap JavaScript, you will need to register [[yii\bootstrap5\BootstrapPluginAsset]]
+as well. If you'd like to use the Bootstrap icons, you'll need to add `twbs/bootstrap-icons` package to your
+`composer.json` and register [[yii\bootstrap5\BootstrapIconAsset]] in your application.
+
+> Tip: most of the widgets register [[yii\bootstrap5\BootstrapPluginAsset]] automatically.