mirror of https://github.com/alanorth/hugo-theme-bootstrap4-blog.git synced 2024-12-19 00:52:19 +01:00

A blogging-centric Bootstrap v4 theme for the Hugo static site generator.

blog-theme bootstrap hugo hugo-theme i18n responsive-design rtl theme

Go to file

Alan Orth 577e168da5 Use i18n to translate some strings Hugo 0.17 allows for easy multi-lingual sites. Strings can be translated either in the theme or in the site, and missing strings will fall back to the default language. See: https://github.com/spf13/hugo/blob/master/docs/content/content/multilingual.md		2016-10-03 22:58:22 +03:00
archetypes	First commit with initial theme	2016-08-28 16:22:32 +03:00
exampleSite	Change theme name to "hugo-theme-bootstrap4-blog"	2016-09-19 10:27:28 +03:00
i18n	Use i18n to translate some strings	2016-10-03 22:58:22 +03:00
layouts	Use i18n to translate some strings	2016-10-03 22:58:22 +03:00
source/scss	Build a custom Bootstrap	2016-09-21 08:29:27 +03:00
static	static/css/style.css: Regenerate	2016-09-26 09:56:45 +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
package.json	package.json: Use npm semver for dev deps	2016-09-28 12:38:32 +03:00
README.md	README.md: Update TODOs	2016-10-03 22:30:08 +03:00
screenshot@2x.png	Update screenshot	2016-09-26 09:06:21 +03:00
theme.toml	theme.toml: Bump minimum version to Hugo 0.17	2016-10-03 18:01:49 +03:00

README.md

Hugo Bootstrap v4 Blog

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

See my blog 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)

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 pagination! (#3)
add optional social links to sidebar
add configurable license notice for footer
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 Bing and Yandex verification support
add support for Disqus (I don't use it!)
add support for Google Analytics (I don't use it!)
test multilang stuff like menus, probably need more absURL/relURL fixes

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.