A blog and information management theme for Hugo roughly based on the Wordpress Twenty Sixteen theme.
WARNING: This template is NOT YET READY.
- Simple, clean layout based loosely on the WordPress 2016 default theme
- Mix of posts and pages as needed
- Front page, categories and tags listing pages include ALL pages and posts
- Drop-down Site menus with configurable separators
- Safe list of "follow me" social icons (no cookies, GDPR safe)
- Automatically incorporates
descriptionfrontmatter field in page output
- Pages show frontmatter metadata including
- Automatic generation of sitemap and RSS feeds
- RSS feeds show full article not summary (be kind to your readers)
- Bulma CSS framework, provides basic responsiveness for mobile
- SEO, Google Search, Facebook, Twitter metadata optimisations included (NOT YET COMPLETE)
- Disqus commenting & Google Analytics available
- Schema.org extensions for blog (built in), person (put ld+json in
/data/siteauthorld.jsonfile) and organisation (put ld+json in
To use this for yourself, install as a git submodule as per the instructions on the Hugo website. See below for more specific instructions.
If you want to make modifications, clone the GitHub project first. You can choose whether to keep your copy updated with any upstream changes.
I use a content structure that is quite opinionated. I can't guarantee that you will like it but please do give it a go to see if you can live with it.
Like many site structures, I assume that you have 2 basic types of actual content:
This theme assumes the use of 6 content sections. You will need to create the matching folders under
/content folder. Each will have an
- posts - These are your standard blog posts. Use as expected. I use a permalink structure that
puts posts under a URL of
- categories - You probably wont have anything other than an
_index.mdfile in this folder. The actual list of categories is generated automatically by Hugo. However, by including the folder and an index file, you can provide both a menu (though you could do this via
config.tomlif preferred) and some explanatory header text along with an SEO description.
- tags - as for categories.
- about - A (generally small) collection of pages such as ones about the site, about the site owner/author,
about the design. More importantly, you are likely to want to keep privacy, copyright and other legal statements here.
Keep anything you would like to see under an
aboutmenu here. Don't forget to add menu frontmatter options.
- kb - Knowledgebase - This section is for pages that are less volatile and less likely to age than your standard blog posts.
There is no hard and fast rule as to whether to use posts or the knowledgebase. You may wish to create sub-sections
kbas I do, each covering different specialist areas.
- projects - This is a portfolio section. Use this for keeping track of projects you've worked on. It is entirely optional.
Really, all of these sections are arbitrary and optional. However, you may occasionally find things in the theme that don't quite
work as expected if you don't at least have
You may have more sections as you wish. Simply add a new folder under the
/content folder and include a
_index.md file containing the appropriate menu
entry and any fixed content you want appearing before the list of pages. The list of pages in the section is generated automatically.
If you have any fixed content above the list, I recommend that you add a level 3 heading at the end of the index file (so it appears as the heading for the list of pages).
Other data types
pages are the 2 default page (content) types, you can, of course, add others and also use the
to create data-driven content. These are standard Hugo features and there is no special support built into this theme.
You should use the following file layout when using this theme
Site Configuration Variables
The following parameters and variables are set in the site
The following custom page parameters are used.
extraStyle(URL list): Will load the url as a style sheet in the HTML
head. Useful for special pages such as one containing a Bulma timeline.
extraScript(URL list): Will load the url as a style sheet in the HTML
--- extraStyle: - https://email@example.com/dist/bulma-timeline.min.css ---
Git Submodule handling
This repo is licensed under the Apache 2.0 license. Please see the LICENSE file for details.