A blogging-centric Bootstrap v4 theme for the Hugo static site generator.
Go to file
Alan Orth 64cdb7f087
Add screenshot and thumbnail for Hugo themes directory
Used in the themes gallery. Kinda low res though. The screenshot
in the readme is still the high-res one.
2016-10-17 22:18:39 -04:00
archetypes Add default archetype with some recommended options 2016-10-17 18:08:39 -04:00
exampleSite exampleSite/config.toml: Update options 2016-10-14 23:18:52 -04:00
i18n Add pagination logic + i18n strings for en 2016-10-05 17:21:53 +03:00
images Add screenshot and thumbnail for Hugo themes directory 2016-10-17 22:18:39 -04:00
layouts layouts/partials/head-meta.html: Use Hugo's templates 2016-10-14 23:07:39 -04:00
source/scss source/scss/bootstrap.scss: Enable buttons 2016-10-05 17:20:25 +03:00
static static/css/style.css: Regenerate 2016-10-05 17:20:49 +03:00
.gitignore Revert ".gitignore: Add intermediate output from node-sass" 2016-09-26 10:08:53 +03:00
LICENSE.txt First commit with initial theme 2016-08-28 16:22:32 +03:00
README.md README.md: Use absolute path for screenshot link 2016-10-17 22:11:11 -04:00
package.json package.json: Use npm semver for dev deps 2016-09-28 12:38:32 +03:00
screenshot@2x.png Update screenshot 2016-09-26 09:06:21 +03:00
theme.toml theme.toml: Clean up, update 2016-10-17 22:08:08 -04:00

README.md

Hugo Bootstrap v4 Blog

A simple Hugo theme based on the Bootstrap v4 blog example. Still a work in progress.

Screenshot

See picturingjordan.com for an example of this theme in use.

Features

  • Uses Bootstrap v4's native system fonts to load quickly and look good on all platforms
  • Basic OpenGraph and Twitter Card metadata support
  • robots.txt linking to XML sitemap (disabled by default, see Hugo docs)
  • Displays categories and tags from front matter
  • Basic support for multi-lingual content (added in Hugo 0.17)
  • Configurable pagination for posts, categories, and tags pages
  • Support Google, Bing, and Yandex site verification via meta tags
  • Support Google Analytics (async version), see Hugo docs

Usage

Clone the repository to your site's themes directory. Refer to exampleSite/config.toml for optional configuration values.

Building (For Developers)

This theme uses the Bootstrap framework. A static version of this is already included, but if you want to bump the version, tweak the style, etc, you'll need to rebuild the assets. Make sure you have NodeJS v4 or v6 installed, and then run the following from inside the theme's directory:

$ npm install
$ npm run build

TODO

  • add optional social links to sidebar
  • add favicon
  • add author page (for when you click author name in a post/summary) #2
  • add images to sitemap? https://gohugo.io/templates/sitemap/
  • add support for Disqus (I don't use it!)
  • test multilingual stuff like menus, probably need more absURL/relURL fixes (see Hugo docs)

License

This repository contains the code of Bootstrap, which is licensed under the MIT license, and Font Awesome, which uses various licenses.

Otherwise, the contents are GPLv3.