alanorth/hugo-theme-bootstrap4-blog
1
0
Fork 0
mirror of https://github.com/alanorth/hugo-theme-bootstrap4-blog.git synced 2024-12-19 00:52:19 +01:00
Code Releases Activity
A blogging-centric Bootstrap v4 theme for the Hugo static site generator.
200 Commits 1 Branch 21 Tags 4.6 MiB
HTML 86%
SCSS 11.5%
JavaScript 2.5%
3d1526eb55
Go to file
Alan Orth 3d1526eb55
static: Generate cookieconsent assets
2016-11-13 13:42:59 +02:00
archetypes Add default archetype with some recommended options 2016-10-17 18:08:39 -04:00
exampleSite exampleSite/config.toml: Add note about Disqus comments 2016-11-06 22:58:04 +02:00
i18n German translation 2016-11-04 10:22:03 +01:00
images Add screenshot and thumbnail for Hugo themes directory 2016-10-17 22:18:39 -04:00
layouts layouts/_default/baseof.html: Don't indent go blocks 2016-11-09 15:42:39 +02:00
source/scss source/scss/bootstrap.scss: Update from distribution 2016-10-19 20:24:24 -07:00
static static: Generate cookieconsent assets 2016-11-13 13:42:59 +02: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: Add run script for cookieconsent 2016-11-13 13:42:22 +02:00
README.md README.md: Add notes about Disqus comments 2016-11-02 15:25:03 +02:00
screenshot@2x.png Update screenshot 2016-09-26 09:06:21 +03:00
theme.toml theme.toml: Add link to original Bootstrap theme 2016-10-19 08:51:11 -07:00

README.md

Hugo Bootstrap v4 Blog

A simple Hugo theme based on the Bootstrap v4 blog example.

Screenshot

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

Features

  • Responsive design
  • 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)
  • Basic support for multi-lingual content (added in Hugo 0.17)
  • Supports Google, Bing, and Yandex site verification via meta tags
  • Supports Google Analytics (async version), see Hugo docs
  • Supports Disqus comments, see Hugo docs

Usage

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

Content Suggestions

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

  • Keep blog posts in the content/post directory, for example: content/post/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

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 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 (user can place one in static dir, but theme could handle this better for modern devices)
  • add author page (for when you click author name in a post/summary) #2
  • add images to sitemap? https://gohugo.io/templates/sitemap/
  • test multilingual stuff like menus, probably need more absURL/relURL fixes (see Hugo docs)
  • make sidebar optional (works, but need to adjust CSS to make main content responsive)

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.