Skip to main content

Content

Typography

Headings, display type, body copy, lists and the brand's marquee treatments.

Global settings

The theme sets basic global display, typography and link styles. When more control is needed, check out the textual utility classes.

  • Two families. The body is the native system sans stack (--bs-font-sans-serif). The display face is Big Shoulders Display, 700 and 800 (--bs-font-display), imported from Google Fonts unless $rb-enable-google-fonts is off.
  • Body type is 1rem / 1.5. $font-size-sm is .875rem, $font-size-lg 1.125rem.
  • $font-weight-bolder is 800, so <strong> is heavier than in stock Bootstrap.
  • Links are navy-700 with an underline, turning gold-700 on hover. In dark mode they are gold-300, gold-500 on hover. See Link utilities and colored links.
Brand rule: don't ship display type under 20px. Big Shoulders is condensed and loses its counters at text sizes. That is why only h1–h3 use it, why .text-marquee should sit at .fs-4 (1.25rem) or larger, and why .font-display on small text is wrong.

Headings

All HTML headings, <h1> through <h6>, are available. Sizes come from the type tokens and shrink fluidly below 1200px (see RFS).

HeadingSizeFamilyExample
<h1></h1>3rem (48px)Big Shoulders Displayh1. heading
<h2></h2>2rem (32px)Big Shoulders Displayh2. heading
<h3></h3>1.5rem (24px)Big Shoulders Displayh3. heading
<h4></h4>1.125rem (18px)System sansh4. heading
<h5></h5>1rem (16px)System sansh5. heading
<h6></h6>.875rem (14px)System sansh6. heading
<h1>h1. heading</h1>
<h2>h2. heading</h2>
<h3>h3. heading</h3>
<h4>h4. heading</h4>
<h5>h5. heading</h5>
<h6>h6. heading</h6>

.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. The display-font rule follows the class too: .h3 is Big Shoulders, .h4 is not.

h1. heading

h2. heading

h3. heading

h4. heading

h5. heading

h6. heading

HTML
<p class="h1">h1. heading</p>
<p class="h2">h2. heading</p>
<p class="h3">h3. heading</p>
<p class="h4">h4. heading</p>
<p class="h5">h5. heading</p>
<p class="h6">h6. heading</p>

Customizing headings

Use the included utility classes to recreate the small secondary heading text from Bootstrap 3.

Fancy display heading With faded secondary text

HTML
<h3>
  Fancy display heading
  <small class="text-body-secondary">With faded secondary text</small>
</h3>

Display headings

Traditional heading elements are designed to work best in the meat of your page content. When you need a heading to stand out, consider a display heading — larger, slightly more opinionated. In this theme they are the marquee: Big Shoulders Display at weight 800, line-height 1, uppercase, .01em tracking.

Display 1
Display 2
Display 3
Display 4
Display 5
Display 6
HTML
<div class="display-1">Display 1</div>
<div class="display-2">Display 2</div>
<div class="display-3">Display 3</div>
<div class="display-4">Display 4</div>
<div class="display-5">Display 5</div>
<div class="display-6">Display 6</div>

Sizes at 1200px and up, Bootstrap's defaults: 5rem, 4.5rem, 4rem, 3.5rem, 3rem, 2.5rem. All six scale down fluidly on smaller viewports.

$display-font-family: $rb-font-display;
$display-font-weight: 800;
$display-line-height: 1;
// text-transform: uppercase and letter-spacing: .01em are added in scss/_brand.scss

Lead

Make a paragraph stand out by adding .lead. It is 1.125rem at weight 400 — the same as $font-size-lg.

This is a lead paragraph. It stands out from regular paragraphs. Use it once, under the title, the way the docs pages do.

HTML
<p class="lead">
  This is a lead paragraph. It stands out from regular paragraphs. Use it once, under the title, the way
  the docs pages do.
</p>

Inline text elements

Styling for common inline HTML5 elements.

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.

This line of text is meant to be treated as an addition to the document.

This line of text will render as underlined.

This line of text is meant to be treated as fine print.

This line rendered as bold text — weight 800 here.

This line rendered as italicized text.

HTML
<p>You can use the mark tag to <mark>highlight</mark> text.</p>
<p><del>This line of text is meant to be treated as deleted text.</del></p>
<p><s>This line of text is meant to be treated as no longer accurate.</s></p>
<p><ins>This line of text is meant to be treated as an addition to the document.</ins></p>
<p><u>This line of text will render as underlined.</u></p>
<p><small>This line of text is meant to be treated as fine print.</small></p>
<p><strong>This line rendered as bold text — weight 800 here.</strong></p>
<p><em>This line rendered as italicized text.</em></p>

Beware that those tags should be used for semantic purposes:

  • <mark> represents text which is marked or highlighted for reference. Gold-300 behind navy — the title-belt highlight.
  • <small> represents side-comments and small print, like copyright and legal text.
  • <s> represents elements that are no longer relevant or accurate.
  • <u> represents a span of inline text which should be rendered in a way that indicates it has a non-textual annotation.

If you want to style your text, you should use the following classes instead: .mark and .small apply the same styles without the semantic meaning. While not shown above, feel free to use <b> and <i> in HTML5 — <b> for words or phrases without conveying additional importance, <i> for voice, technical terms, etc.

Brand type

Two classes from scss/_brand.scss carry the wrestling voice, plus a handful of utilities from scss/_utilities.scss.

.text-marquee

Opt any element into the marquee treatment: display family, weight 800, line-height 1, uppercase, .01em tracking. It does not set a size, so pair it with a .fs-* class — 20px minimum.

Saturday night's main event

Championship · two out of three falls

HTML
<p class="text-marquee fs-1 mb-2">Saturday night's main event</p>
<p class="text-marquee fs-3 mb-0">Championship · two out of three falls</p>

.text-gold-ramp

The gold ramp — gold-300 to gold-500 to gold-700, clipped to the text. The single most "wrestling" move in the kit, so one per page. The fallback colour is gold-500 for engines without background-clip: text. Best on display type; the gradient is invisible at body size.

Title belt

HTML
<h2 class="display-3 text-gold-ramp mb-0">Title belt</h2>

A background version, .bg-gold-ramp, paints the same ramp behind navy text:

Champion
HTML
<span class="bg-gold-ramp text-marquee fs-4 px-3 py-2 d-inline-block">Champion</span>

Letter-spacing, family and weight utilities

ClassDeclarationUse
.ls-tightletter-spacing: 0Undo the display tracking on a heading
.ls-displayletter-spacing: .01emThe marquee tracking
.ls-wideletter-spacing: .08emEyebrows and small caps labels
.font-displayfont-family: var(--bs-font-display)Big Shoulders on h4+ sized text (20px minimum)
.font-monospacefont-family: var(--bs-font-monospace)Stats and numbers; see also .stat
.fw-blackfont-weight: 800The display weight, joining .fw-bold (700)

Eyebrow · ls-wide

A heading with ls-tight

font-display fw-black at fs-4

HTML
<p class="ls-wide text-uppercase small text-body-secondary mb-1">Eyebrow · ls-wide</p>
<p class="h2 ls-tight mb-1">A heading with ls-tight</p>
<p class="font-display fw-black fs-4 mb-0">font-display fw-black at fs-4</p>

Abbreviations

Stylised implementation of HTML's <abbr> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations have a default underline and gain a help cursor to provide additional context on hover and to users of assistive technologies.

Add .initialism to an abbreviation for a slightly smaller font-size and uppercase.

attr

HTML

ppv

HTML
<p><abbr title="attribute">attr</abbr></p>
<p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr></p>
<p><abbr title="Pay-per-view" class="initialism">ppv</abbr></p>

Blockquotes

For quoting blocks of content from another source within your document. Wrap <blockquote class="blockquote"> around any HTML as the quote. It renders at 1.25rem.

To be the man, you've got to beat the man.

HTML
<blockquote class="blockquote">
  <p>To be the man, you've got to beat the man.</p>
</blockquote>

Naming a source

The HTML spec requires that blockquote attribution be placed outside the <blockquote>. When providing attribution, wrap your <blockquote> in a <figure> and use a <figcaption> or a block level element (e.g. <p>) with the .blockquote-footer class. Be sure to wrap the name of the source work in <cite> as well. The footer is navy-400 with an em-dash prefix.

To be the man, you've got to beat the man.

HTML
<figure>
  <blockquote class="blockquote">
    <p>To be the man, you've got to beat the man.</p>
  </blockquote>
  <figcaption class="blockquote-footer">
    The Nature Boy in <cite title="Source Title">every promo, 1985–2002</cite>
  </figcaption>
</figure>

Alignment

Use text utilities as needed to change the alignment of your blockquote.

To be the man, you've got to beat the man.

HTML
<figure class="text-center">
  <blockquote class="blockquote">
    <p>To be the man, you've got to beat the man.</p>
  </blockquote>
  <figcaption class="blockquote-footer">
    The Nature Boy in <cite title="Source Title">every promo</cite>
  </figcaption>
</figure>

To be the man, you've got to beat the man.

HTML
<figure class="text-end">
  <blockquote class="blockquote">
    <p>To be the man, you've got to beat the man.</p>
  </blockquote>
  <figcaption class="blockquote-footer">
    The Nature Boy in <cite title="Source Title">every promo</cite>
  </figcaption>
</figure>

Lists

Unstyled

Remove the default list-style and left margin on list items (immediate children only). This only applies to immediate children list items, meaning you will need to add the class for any nested lists as well.

  • Opening contest
  • Tag team titles
  • Women's title
  • Nested lists keep their bullets:
    • Triple threat
    • Fatal four-way
  • Intercontinental title
  • Main event
HTML
<ul class="list-unstyled">
  <li>Opening contest</li>
  <li>Tag team titles</li>
  <li>Women's title</li>
  <li>Nested lists keep their bullets:
    <ul>
      <li>Triple threat</li>
      <li>Fatal four-way</li>
    </ul>
  </li>
  <li>Intercontinental title</li>
  <li>Main event</li>
</ul>

Inline

Remove a list's bullets and apply some light margin with a combination of two classes, .list-inline and .list-inline-item. Items are separated by .5rem.

  • Pinfall
  • Submission
  • Countout
  • Disqualification
HTML
<ul class="list-inline">
  <li class="list-inline-item">Pinfall</li>
  <li class="list-inline-item">Submission</li>
  <li class="list-inline-item">Countout</li>
  <li class="list-inline-item">Disqualification</li>
</ul>

Description list alignment

Align terms and descriptions horizontally by using the grid system's predefined classes (or semantic mixins). For longer terms, you can optionally add a .text-truncate class to truncate the text with an ellipsis.

Billed from
Parts Unknown
Height / weight

6 ft 10 in, 328 lb.

Announced weights are a work. Nobody minds.

Finisher
Running powerslam
Truncated term is truncated
Long terms get an ellipsis instead of wrapping.
Nesting
Nested definition list
A tag team inside a stable.
HTML
<dl class="row">
  <dt class="col-sm-3">Billed from</dt>
  <dd class="col-sm-9">Parts Unknown</dd>

  <dt class="col-sm-3">Height / weight</dt>
  <dd class="col-sm-9">
    <p>6 ft 10 in, 328 lb.</p>
    <p>Announced weights are a work. Nobody minds.</p>
  </dd>

  <dt class="col-sm-3">Finisher</dt>
  <dd class="col-sm-9">Running powerslam</dd>

  <dt class="col-sm-3 text-truncate">Truncated term is truncated</dt>
  <dd class="col-sm-9">Long terms get an ellipsis instead of wrapping.</dd>

  <dt class="col-sm-3">Nesting</dt>
  <dd class="col-sm-9">
    <dl class="row">
      <dt class="col-sm-4">Nested definition list</dt>
      <dd class="col-sm-8">A tag team inside a stable.</dd>
    </dl>
  </dd>
</dl>

Responsive font sizes

Bootstrap's responsive font sizes (RFS) are enabled, so headings, display classes, .fs-1 … .fs-4 and <legend> scale with the viewport below 1200px. The token sizes above are the maximum; for example h1 compiles to calc(1.425rem + 2.1vw) and reaches 3rem at 1200px. h4–h6, .fs-5 and .fs-6 are already small enough and do not scale.

h1, .h1 { font-size: calc(1.425rem + 2.1vw); }
@media (min-width: 1200px) {
  h1, .h1 { font-size: 3rem; }
}

Sass

Variables

The type values set by scss/_variables.scss. Everything else is Bootstrap's default.

$font-family-sans-serif: $rb-font-sans;    // system stack
$font-family-monospace: $rb-font-mono;
$display-font-family: $rb-font-display;    // "Big Shoulders Display", then the sans stack
$font-size-base: 1rem;
$font-size-sm: .875rem;
$font-size-lg: 1.125rem;
$font-weight-medium: 500;
$font-weight-bold: 700;
$font-weight-bolder: 800;
$line-height-base: 1.5;
$line-height-sm: 1.15;
$line-height-lg: 1.75;

$h1-font-size: 3rem;
$h2-font-size: 2rem;
$h3-font-size: 1.5rem;
$h4-font-size: 1.125rem;
$h5-font-size: 1rem;
$h6-font-size: .875rem;

$headings-font-family: null;   // body font; _brand.scss puts the display face on h1–h3
$headings-font-weight: 700;
$headings-line-height: 1.15;
$headings-margin-bottom: $spacer;

$display-font-weight: 800;
$display-line-height: 1;

$lead-font-size: 1.125rem;
$lead-font-weight: 400;

$mark-bg: $rb-gold-300;
$mark-color: $rb-navy-900;
$code-color: #8b2c45;

The CSS variables --font-sans, --font-display, --font-mono and --font-size-xs … --font-size-3xl from the design package are re-emitted by the token layer; --font-size-3xl is 3rem, the h1 size.