summaryrefslogtreecommitdiffstats
path: root/site/content/docs/5.3/extend/icons.md
diff options
context:
space:
mode:
Diffstat (limited to 'site/content/docs/5.3/extend/icons.md')
-rw-r--r--site/content/docs/5.3/extend/icons.md40
1 files changed, 40 insertions, 0 deletions
diff --git a/site/content/docs/5.3/extend/icons.md b/site/content/docs/5.3/extend/icons.md
new file mode 100644
index 0000000..1e26503
--- /dev/null
+++ b/site/content/docs/5.3/extend/icons.md
@@ -0,0 +1,40 @@
+---
+layout: docs
+title: Icons
+description: Guidance and suggestions for using external icon libraries with Bootstrap.
+group: extend
+---
+
+While Bootstrap doesn't include an icon set by default, we do have our own comprehensive icon library called Bootstrap Icons. Feel free to use them or any other icon set in your project. We've included details for Bootstrap Icons and other preferred icon sets below.
+
+While most icon sets include multiple file formats, we prefer SVG implementations for their improved accessibility and vector support.
+
+## Bootstrap Icons
+
+Bootstrap Icons is a growing library of SVG icons that are designed by [@mdo](https://github.com/mdo) and maintained by [the Bootstrap Team](https://github.com/orgs/twbs/people). The beginnings of this icon set come from Bootstrap's very own components—our forms, carousels, and more. Bootstrap has very few icon needs out of the box, so we didn't need much. However, once we got going, we couldn't stop making more.
+
+Oh, and did we mention they're completely open source? Licensed under MIT, just like Bootstrap, our icon set is available to everyone.
+
+[Learn more about Bootstrap Icons]({{< param icons >}}), including how to install them and recommended usage.
+
+## Alternatives
+
+We've tested and used these icon sets ourselves as preferred alternatives to Bootstrap Icons.
+
+{{< markdown >}}
+{{< icons.inline >}}
+{{- $type := .Get "type" | default "preferred" -}}
+
+{{- range (index .Site.Data.icons $type) }}
+- [{{ .name }}]({{ .website }})
+{{- end }}
+{{< /icons.inline >}}
+{{< /markdown >}}
+
+## More options
+
+While we haven't tried these out ourselves, they do look promising and provide multiple formats, including SVG.
+
+{{< markdown >}}
+{{< icons.inline type="more" />}}
+{{< /markdown >}}