1
0
mirror of https://github.com/alanorth/hugo-theme-bootstrap4-blog.git synced 2024-12-22 18:32:20 +01:00
A blogging-centric Bootstrap v4 theme for the Hugo static site generator.
Go to file
2020-12-10 12:49:57 +02:00
archetypes TranslationBaseName replaced for Name on archetypes template 2018-07-11 16:38:30 +03:00
assets Regenerate static assets 2020-11-30 12:42:10 +02:00
exampleSite exampleSite/config.toml: Show how to override date format 2020-03-22 15:28:33 +02:00
i18n Use haven for GDPR popup instead of cookieconsent 2020-05-13 13:19:41 +03:00
images images/tn.png: New thumbnail without browser 2017-05-28 14:40:49 +03:00
layouts layouts/_default/single.html: Fix for images in the page bundle 2020-12-04 14:09:27 +02:00
source Adjust source/scss for dart sass 2020-11-30 12:41:53 +02:00
.build.yml .build.yml: Use Node.js v12 2020-01-23 20:16:15 +02:00
.drone.yml .drone.yml: Correct npm task 2020-12-10 12:49:57 +02:00
.gitignore .gitignore: Add yarn.lock 2017-12-18 13:15:25 +02:00
.travis.yml .travis.yml: Only build on Node.js LTS versions 2020-12-10 12:48:38 +02:00
CHANGELOG.md Move unreleased changes to 1.6.0 2020-12-05 19:01:52 +02:00
LICENSE.txt Change license from GPL-3.0 to CC-BY-3.0 2018-09-12 13:32:36 +03:00
package-lock.json Move unreleased changes to 1.6.0 2020-12-05 19:01:52 +02:00
package.json Move unreleased changes to 1.6.0 2020-12-05 19:01:52 +02:00
README.md README.md: Use travis-ci.com domain for badge 2020-12-08 09:07:25 +02:00
screenshot.png Use 1280x720 screenshot again 2017-02-01 08:45:13 +02:00
theme.toml theme.toml: Use picturingjordan.com as homepage 2020-11-15 11:57:58 +02:00
webpack.config.js Use Font Awesome SVGs via JavaScript 2020-01-27 18:17:35 +02:00

Hugo Bootstrap v4 Blog Build Status builds.sr.ht status

A simple but opinionated Hugo theme geared towards blog-style content. Based on the older two-column Bootstrap blog example that was used for several Bootstrap versions, but has now been retired in favor of a "snarky" (their words) new example as of version 4.0.0's final release.

Screenshot

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

Features

Usage

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

Content Suggestions

A few suggestions to help you get a good looking site quickly:

  • Keep blog posts in the content/posts directory, for example: content/posts/my-first-post.md
  • Keep static pages in the content directory, for example: content/about.md
  • Keep media like images in the static directory, for example: static/2016/10/screenshot.png
  • If you want an image to be shown when you share a post on social media, specify at least one image in the post's front matter, for example: images: ["/2016/10/screenshot.png"]
  • Use the <!--more--> tag in posts to control how much of a post is shown on summary pages
  • Disable comments on a post by setting comments = false in its frontmatter
  • Disable social sharing icons site wide (or on individual pages/posts) by setting sharingicons = false
  • If your content is stored in git, add enableGitInfo = true to your site config and Hugo will use git history to set a more accurate modification date in page metadata

See the source code and structure of picturingjordan.com to get more ideas.

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 >= v10 installed, and then run the following from inside the theme's directory:

$ npm install
$ npm run build

Contributing

There are several ways to help with the development of the theme:

  • Open an issue on GitHub if you have problems or feature requests
  • Alternatively, tackle one of the existing issues on the issue tracker
  • Fork the repository on GitHub, add features on a "feature" branch like update-bootstrap, and then send a pull request with your changes

License

This repository contains SASS and HTML code from the Bootstrap project, which is licensed under the MIT license and CC BY 3.0, and Font Awesome, which uses various licenses.