Skip to content
This repository has been archived by the owner on Sep 29, 2021. It is now read-only.

solutionroute/hugo-smorg

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

This project is no longer being maintained. Check https://github.com/solutionroute/ for any newer Hugo themes.

hugo-smorg

Hugo-smorg (small-org? smorgasbord?) is a responsive mobile-first Bulma-powered, reasonably minimalistic Hugo (https://gohugo.io/) theme for an individual blogger or a small organization to adapt as need be.

Current release: v0.7, April 4 2018 - see CHANGELOG; this project is being updated daily at present - following HEAD is best. If you are using the theme and spot issues or areas for improvement please let me know by opening an issue or submitting a PR.

An ongoing work in progress, I'm using Hugo-Smorg as a base for other projects.

Objectives

  • Remain easy to understand while also being easy to extend.
  • Keep pace with current Hugo features and practicies.
  • Avoid relying on config.yaml for too much customization.
  • Keep HTML customizability effort low using template blocks and partials and CSS customizability options open via SASS / CSS.
  • Produce output that will validate and load quickly by default.

Features

Hugo-smorg is:

  • Mobile first thanks to Bulma, a SASS CSS framework alternative to Bootstrap.
  • Themable itself via Bulmaswatch.
  • Minimalistic in nature.

And offers:

  • Responsive site-wide drop-down capable navigation menu
  • Simple "Subsection" pages possible with layout:subsection in front-matter.
  • Breadcrumb-menu in subsection layout, available to others.
  • Produces Atom syndication format with option to disable RSS.
  • JSON-LD microdata
  • Category and Tag taxonomies (partial page-meta)
  • Themed mobile-friendly pagination.
  • Includes syntax highlighting with a choice of colour themes.
  • By default uses zero-wait modern system font stacks; easy integration with a webfont via a couple lines of SASS and npm run scss:min.

Screenshot

See the demo site for a live view.

Installation

  1. Clone the repo:

    git clone --recursive https://github.com/solutionroute/hugo-smorg.git

  2. To view the theme:

    cd exampleSite hugo server

  3. (Optionally) install development dependencies:

To adapt the provided SASS produced CSS you'll need to install SASS and Bulma at the very least; the least painful way to go about this is via Nodejs and npm; Once those tools are installed, in the hugo-smorg theme directory:

npm install

This will install the dependencies listed in package.json including Bulma and node-sass. You'll also find some handy run scripts including npm run dev which will build your site and SCSS/CSS files and reload automatically.

About

Responsive mobile-first Bulma-powered Hugo theme for an individual or small organization

Resources

License

Stars

Watchers

Forks

Packages

No packages published