`. Be sure to escape HTML angle brackets.
-{% capture example %}
+{{< example >}}
For example, <section>
should be wrapped as inline.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Code blocks
Use ``s for multiple lines of code. Once again, be sure to escape any angle brackets in the code for proper rendering. You may optionally add the `.pre-scrollable` class, which will set a max-height of 340px and provide a y-axis scrollbar.
-{% capture example %}
+{{< example >}}
<p>Sample text here...</p>
<p>And another line of sample text here...</p>
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Variables
For indicating variables use the `` tag.
-{% capture example %}
+{{< example >}}
y = mx + b
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## User input
Use the `` to indicate input that is typically entered via keyboard.
-{% capture example %}
+{{< example >}}
To switch directories, type cd followed by the name of the directory.
To edit settings, press ctrl + ,
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Sample output
For indicating sample output from a program use the `` tag.
-{% capture example %}
+{{< example >}}
This text is meant to be treated as sample output from a computer program.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
diff --git a/site/docs/4.5/content/figures.md b/site/content/docs/4.5/content/figures.md
similarity index 66%
rename from site/docs/4.5/content/figures.md
rename to site/content/docs/4.5/content/figures.md
index a647fc1d0b..559e612ede 100644
--- a/site/docs/4.5/content/figures.md
+++ b/site/content/docs/4.5/content/figures.md
@@ -9,20 +9,18 @@ Anytime you need to display a piece of content—like an image with an optional
Use the included `.figure` , `.figure-img` and `.figure-caption` classes to provide some baseline styles for the HTML5 `` and `` elements. Images in figures have no explicit size, so be sure to add the `.img-fluid` class to your `
` to make it responsive.
-{% capture example %}
+{{< example >}}
- {% include icons/placeholder.svg width="400" height="300" class="figure-img img-fluid rounded" %}
+ {{< placeholder width="400" height="300" class="figure-img img-fluid rounded" >}}
A caption for the above image.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
-Aligning the figure's caption is easy with our [text utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/#text-alignment).
+Aligning the figure's caption is easy with our [text utilities]({{< docsref "/utilities/text#text-alignment" >}}).
-{% capture example %}
+{{< example >}}
- {% include icons/placeholder.svg width="400" height="300" class="figure-img img-fluid rounded" %}
+ {{< placeholder width="400" height="300" class="figure-img img-fluid rounded" >}}
A caption for the above image.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
diff --git a/site/docs/4.5/content/images.md b/site/content/docs/4.5/content/images.md
similarity index 51%
rename from site/docs/4.5/content/images.md
rename to site/content/docs/4.5/content/images.md
index 15b4f2988e..390b797798 100644
--- a/site/docs/4.5/content/images.md
+++ b/site/content/docs/4.5/content/images.md
@@ -11,74 +11,73 @@ toc: true
Images in Bootstrap are made responsive with `.img-fluid`. `max-width: 100%;` and `height: auto;` are applied to the image so that it scales with the parent element.
- {% include icons/placeholder.svg width="100%" height="250" class="bd-placeholder-img-lg img-fluid" text="Responsive image" %}
+ {{< placeholder width="100%" height="250" class="bd-placeholder-img-lg img-fluid" text="Responsive image" >}}
-{% highlight html %}
+```html
-{% endhighlight %}
+```
-{% capture callout %}
+{{< callout warning >}}
##### SVG images and Internet Explorer
In Internet Explorer 10 and 11, SVG images with `.img-fluid` are disproportionately sized. To fix this, add `width: 100%;` or `.w-100` where necessary. This fix improperly sizes other image formats, so Bootstrap doesn't apply it automatically.
-{% endcapture %}
-{% include callout.html content=callout type="warning" %}
+{{< /callout >}}
## Image thumbnails
-In addition to our [border-radius utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/borders/), you can use `.img-thumbnail` to give an image a rounded 1px border appearance.
+In addition to our [border-radius utilities]({{< docsref "/utilities/borders" >}}), you can use `.img-thumbnail` to give an image a rounded 1px border appearance.
- {% include icons/placeholder.svg width="200" height="200" class="img-thumbnail" title="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera" %}
+ {{< placeholder width="200" height="200" class="img-thumbnail" title="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera" >}}
-{% highlight html %}
+```html
-{% endhighlight %}
+```
## Aligning images
-Align images with the [helper float classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/float/) or [text alignment classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/#text-alignment). `block`-level images can be centered using [the `.mx-auto` margin utility class]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/spacing/#horizontal-centering).
+Align images with the [helper float classes]({{< docsref "/utilities/float" >}}) or [text alignment classes]({{< docsref "/utilities/text#text-alignment" >}}). `block`-level images can be centered using [the `.mx-auto` margin utility class]({{< docsref "/utilities/spacing#horizontal-centering" >}}).
- {% include icons/placeholder.svg width="200" height="200" class="rounded float-left" %}
- {% include icons/placeholder.svg width="200" height="200" class="rounded float-right" %}
+ {{< placeholder width="200" height="200" class="rounded float-left" >}}
+ {{< placeholder width="200" height="200" class="rounded float-right" >}}
-{% highlight html %}
+```html
-{% endhighlight %}
+```
- {% include icons/placeholder.svg width="200" height="200" class="rounded mx-auto d-block" %}
+ {{< placeholder width="200" height="200" class="rounded mx-auto d-block" >}}
-{% highlight html %}
+```html
-{% endhighlight %}
+```
- {% include icons/placeholder.svg width="200" height="200" class="rounded" %}
+ {{< placeholder width="200" height="200" class="rounded" >}}
-{% highlight html %}
+```html
-{% endhighlight %}
+```
## Picture
If you are using the `` element to specify multiple `` elements for a specific `
`, make sure to add the `.img-*` classes to the `
` and not to the `` tag.
-{% highlight html %}
+```html
-{% endhighlight %}
+```
diff --git a/site/docs/4.5/content/reboot.md b/site/content/docs/4.5/content/reboot.md
similarity index 94%
rename from site/docs/4.5/content/reboot.md
rename to site/content/docs/4.5/content/reboot.md
index 83ec13aef2..ea49f3038e 100644
--- a/site/docs/4.5/content/reboot.md
+++ b/site/content/docs/4.5/content/reboot.md
@@ -3,7 +3,7 @@ layout: docs
title: Reboot
description: Reboot, a collection of element-specific CSS changes in a single file, kickstart Bootstrap to provide an elegant, consistent, and simple baseline to build upon.
group: content
-redirect_from: "/docs/4.5/content/"
+aliases: "/docs/4.5/content/"
toc: true
---
@@ -31,7 +31,7 @@ The `` and `` elements are updated to provide better page-wide defau
The default web fonts (Helvetica Neue, Helvetica, and Arial) have been dropped in Bootstrap 4 and replaced with a "native font stack" for optimum text rendering on every device and OS. Read more about [native font stacks in this *Smashing Magazine* article](https://www.smashingmagazine.com/2015/11/using-system-ui-fonts-practical-guide/).
-{% highlight sass %}
+```sass
$font-family-sans-serif:
// Safari for macOS and iOS (San Francisco)
-apple-system,
@@ -50,7 +50,7 @@ $font-family-sans-serif:
sans-serif,
// Emoji fonts
"Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !default;
-{% endhighlight %}
+```
Note that because the font stack includes emoji fonts, many common symbol/dingbat unicode characters will be rendered as multi-colored pictographs. Their appearance will vary, depending on the style used in the browser/platform's native emoji font, and they won't be affected by any CSS `color` styles.
@@ -70,37 +70,37 @@ All heading elements—e.g., ``—and `
` are reset to have their `margin-
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h1. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h2. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h3. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h4. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h5. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h6. Bootstrap heading |
@@ -112,7 +112,7 @@ All heading elements—e.g., ``—and `
` are reset to have their `margin-
All lists—`
`, ``, and ``—have their `margin-top` removed and a `margin-bottom: 1rem`. Nested lists have no `margin-bottom`.
-{% capture markdown %}
+{{< markdown >}}
* Lorem ipsum dolor sit amet
* Consectetur adipiscing elit
* Integer molestie lorem at massa
@@ -134,8 +134,7 @@ All lists—`
`, ``, and ``—have their `margin-top` removed and a `
6. Faucibus porta lacus fringilla vel
7. Aenean sit amet erat nunc
8. Eget porttitor lorem
-{% endcapture %}
-{{ markdown | markdownify }}
+{{< /markdown >}}
For simpler styling, clear hierarchy, and better spacing, description lists have updated `margin`s. `- `s reset `margin-left` to `0` and add `margin-bottom: .5rem`. `
- `s are **bolded**.
@@ -166,7 +165,7 @@ The `
` element is reset to remove its `margin-top` and use `rem` units for
## Tables
-Tables are slightly adjusted to style ``s, collapse borders, and ensure consistent `text-align` throughout. Additional changes for borders, padding, and more come with [the `.table` class]({{ site.baseurl }}/docs/{{ site.docs_version }}/content/tables/).
+Tables are slightly adjusted to style ``s, collapse borders, and ensure consistent `text-align` throughout. Additional changes for borders, padding, and more come with [the `.table` class]({{< docsref "/content/tables" >}}).
@@ -220,12 +219,10 @@ These changes, and more, are demonstrated below.
-{% highlight html %}
+{{< highlight html >}}
-...
-{% for color in site.data.theme-colors %}
-...
{% endfor %}
+...
{{< table.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+...
+{{- end -}}
+{{< /table.inline >}}
- ... |
- {% for color in site.data.theme-colors %}
- ... | {% endfor %}
+ ... | {{< table.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+ ... |
+{{- end -}}
+{{< /table.inline >}}
-{% endhighlight %}
+{{< /highlight >}}
-Regular table background variants are not available with the dark table, however, you may use [text or background utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/colors/) to achieve similar styles.
+Regular table background variants are not available with the dark table, however, you may use [text or background utilities]({{< docsref "/utilities/colors" >}}) to achieve similar styles.
@@ -615,7 +608,7 @@ Regular table background variants are not available with the dark table, however
-{% highlight html %}
+```html
...
...
@@ -631,19 +624,23 @@ Regular table background variants are not available with the dark table, however
... |
... |
-{% endhighlight %}
+```
-{% include callout-warning-color-assistive-technologies.md %}
+{{< callout warning >}}
+{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
Create responsive tables by wrapping any `.table` with `.table-responsive{-sm|-md|-lg|-xl}`, making the table scroll horizontally at each `max-width` breakpoint of up to (but not including) 576px, 768px, 992px, and 1120px, respectively.
-{% include callout-info-mediaqueries-breakpoints.md %}
+{{< callout info >}}
+{{< partial "callout-info-mediaqueries-breakpoints.md" >}}
+{{< /callout >}}
## Captions
A `` functions like a heading for a table. It helps users with screen readers to find a table and understand what it's about and decide if they want to read it.
-{% capture example %}
+{{< example >}}
List of users
@@ -675,19 +672,17 @@ A `` functions like a heading for a table. It helps users with screen r
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Responsive tables
Responsive tables allow tables to be scrolled horizontally with ease. Make any table responsive across all viewports by wrapping a `.table` with `.table-responsive`. Or, pick a maximum breakpoint with which to have a responsive table up to by using `.table-responsive{-sm|-md|-lg|-xl}`.
-{% capture callout %}
+{{< callout warning >}}
##### Vertical clipping/truncation
Responsive tables make use of `overflow-y: hidden`, which clips off any content that goes beyond the bottom or top edges of the table. In particular, this can clip off dropdown menus and other third-party widgets.
-{% endcapture %}
-{% include callout.html content=callout type="warning" %}
+{{< /callout >}}
### Always responsive
@@ -752,13 +747,13 @@ Across every breakpoint, use `.table-responsive` for horizontally scrolling tabl
-{% highlight html %}
+```html
-{% endhighlight %}
+```
### Breakpoint specific
@@ -766,9 +761,11 @@ Use `.table-responsive{-sm|-md|-lg|-xl}` as needed to create responsive tables u
**These tables may appear broken until their responsive styles apply at specific viewport widths.**
-{% for bp in site.data.breakpoints %}{% unless bp.breakpoint == "xs" %}
+{{< tables.inline >}}
+{{ range $.Site.Data.breakpoints }}
+{{ if not (eq .breakpoint "xs") }}
-
+
@@ -821,11 +818,20 @@ Use `.table-responsive{-sm|-md|-lg|-xl}` as needed to create responsive tables u
-{% highlight html %}
-
+{{ end -}}
+{{- end -}}
+{{< /tables.inline >}}
+
+{{< highlight html >}}
+{{< tables.inline >}}
+{{- range $.Site.Data.breakpoints -}}
+{{- if not (eq .breakpoint "xs") }}
+
-{% endhighlight %}
-{% endunless %}{% endfor %}
+{{ end -}}
+{{- end -}}
+{{< /tables.inline >}}
+{{< /highlight >}}
diff --git a/site/docs/4.5/content/typography.md b/site/content/docs/4.5/content/typography.md
similarity index 84%
rename from site/docs/4.5/content/typography.md
rename to site/content/docs/4.5/content/typography.md
index 37caddb2cc..ef79ea6ced 100644
--- a/site/docs/4.5/content/typography.md
+++ b/site/content/docs/4.5/content/typography.md
@@ -8,9 +8,9 @@ toc: true
## Global settings
-Bootstrap sets basic global display, typography, and link styles. When more control is needed, check out the [textual utility classes]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/).
+Bootstrap sets basic global display, typography, and link styles. When more control is needed, check out the [textual utility classes]({{< docsref "/utilities/text" >}}).
-- Use a [native font stack]({{ site.baseurl }}/docs/{{ site.docs_version }}/content/reboot/#native-font-stack) that selects the best `font-family` for each OS and device.
+- Use a [native font stack]({{< docsref "/content/reboot#native-font-stack" >}}) that selects the best `font-family` for each OS and device.
- For a more inclusive and accessible type scale, we use the browser's default root `font-size` (typically 16px) so visitors can customize their browser defaults as needed.
- Use the `$font-family-base`, `$font-size-base`, and `$line-height-base` attributes as our typographic base applied to the ``.
- Set the global link color via `$link-color` and apply link underlines only on `:hover`.
@@ -32,75 +32,73 @@ All HTML headings, `
` through ``, are available.
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h1. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h2. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h3. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h4. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h5. Bootstrap heading |
- {{ "``" | markdownify }}
+ {{< markdown >}}``{{< /markdown >}}
|
h6. Bootstrap heading |
-{% highlight html %}
+```html
h1. Bootstrap heading
h2. Bootstrap heading
h3. Bootstrap heading
h4. Bootstrap heading
h5. Bootstrap heading
h6. Bootstrap heading
-{% endhighlight %}
+```
`.h1` through `.h6` classes are also available, for when you want to match the font styling of a heading but cannot use the associated HTML element.
-{% capture example %}
+{{< example >}}
h1. Bootstrap heading
h2. Bootstrap heading
h3. Bootstrap heading
h4. Bootstrap heading
h5. Bootstrap heading
h6. Bootstrap heading
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
### Customizing headings
Use the included utility classes to recreate the small secondary heading text from Bootstrap 3.
-{% capture example %}
+{{< example >}}
Fancy display heading
With faded secondary text
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Display headings
@@ -125,29 +123,28 @@ Traditional heading elements are designed to work best in the meat of your page
-{% highlight html %}
+```html
Display 1
Display 2
Display 3
Display 4
-{% endhighlight %}
+```
## Lead
Make a paragraph stand out by adding `.lead`.
-{% capture example %}
+{{< example >}}
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Inline text elements
Styling for common inline HTML5 elements.
-{% capture example %}
+{{< example >}}
You can use the mark tag to highlight text.
This line of text is meant to be treated as deleted text.
This line of text is meant to be treated as no longer accurate.
@@ -156,8 +153,7 @@ Styling for common inline HTML5 elements.
This line of text is meant to be treated as fine print.
This line rendered as bold text.
This line rendered as italicized text.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
`.mark` and `.small` classes are also available to apply the same styles as `
` and `` while avoiding any unwanted semantic implications that the tags would bring.
@@ -165,7 +161,7 @@ While not shown above, feel free to use `` and `` in HTML5. `` is meant
## Text utilities
-Change text alignment, transform, style, weight, and color with our [text utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/text/) and [color utilities]({{ site.baseurl }}/docs/{{ site.docs_version }}/utilities/colors/).
+Change text alignment, transform, style, weight, and color with our [text utilities]({{< docsref "/utilities/text" >}}) and [color utilities]({{< docsref "/utilities/colors" >}}).
## Abbreviations
@@ -173,54 +169,49 @@ Stylized implementation of HTML's `` element for abbreviations and acronym
Add `.initialism` to an abbreviation for a slightly smaller font-size.
-{% capture example %}
+{{< example >}}
attr
HTML
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
## Blockquotes
For quoting blocks of content from another source within your document. Wrap `` around any HTML as the quote.
-{% capture example %}
+{{< example >}}
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
-{% endcapture %}
-{% include example.html content=example %}
+{{< /example >}}
### Naming a source
Add a `