Vanilla Bootstrap
A vanilla Bootstrap theme for Hugo.
Minimum Hugo version
Hugo version 0.54.0
or higher is required. View the Hugo releases and download the binary for your OS.
Installation
From the root of your site:
git submodule add https://github.com/zwbetz-gh/vanilla-bootstrap-hugo-theme.git themes/vanilla-bootstrap-hugo-theme
Updating
From the root of your site:
git submodule update --remote --merge
Run example site
From the root of themes/vanilla-bootstrap-hugo-theme/exampleSite
:
hugo server --themesDir ../..
Configuration
Copy the config.toml
or config.yaml
from the exampleSite
, then edit as desired.
Homepage content
By default the homepage uses the homeText
param for content. If you wish to provide content from a file, then create content/_index.md
and it will be used instead. For example:
---
title: Home
---
Homepage content goes here.
Shortcodes
bootstrap-blockquote
Uses Bootstrap blockquotes to format your blockquotes nicely. Pass the quote inside the shortcode. The author
argument is optional.
Here's an actual usage, and here's an example usage:
{{% bootstrap-blockquote author="Carl Jung" %}}
Knowing your own darkness is the best method for dealing with the darknesses of other people.
{{% /bootstrap-blockquote %}}
bootstrap-table
Uses Bootstrap tables to format your tables nicely. Pass the markdown table inside the shortcode, then pass the classes as an argument.
Here's an actual usage, and here's an example usage:
{{< bootstrap-table "table table-dark table-striped table-bordered" >}}
| Animal | Sounds |
|---------|--------|
| Cat | Meow |
| Dog | Woof |
| Cricket | Chirp |
{{< /bootstrap-table >}}
bootstrap-card
Uses Bootstrap cards and Hugo image processing to display your page bundle images nicely. Only the img
, command
, and options
arguments are required.
Here's an actual usage, and here's an example usage:
{{< bootstrap-card
img="sun.jpg"
command="Resize"
options="700x"
title="The Sun"
text="The Sun is the star at the center of the Solar System."
alt="sun"
class="mb-3"
style="" >}}