hugo-awesome

Introduction

Tempalte for Hugo, a static page generator.
Layout with the Bulma CSS Framework based on Flexbox.

Cloud Ready

Build to run after initial setup in every environment without further configuration,
but flexible enought to execute hugo, compile SASS to CSS with the help of a Gulp Build automatically.

Screenshots

How to use

• hugo new site yoursite
• cd yoursite/themes
• git clone https://github.com/ellerbrock/hugo-awesome
• mv .env docker-compose.yml ..
• cd ..

Hugo Configuration

Example config.toml:

baseURL = "https://ellerbrock.github.io"
title = "💫 Awesome Hugo 🦄"
theme = "hugo-awesome"
disableHugoGeneratorInject = true
publishDir = "docs"
ignoreFiles = [ "\\.dev$", "\\.backup$", "\\.old$"  ]
pluralizeListTitles = true

[author]
  name = "Maik Ellerbrock"
  homepage = "https://frapsoft.com"
  github = "https://github.com/ellerbrock"
  twitter = "https://twitter.com/frapsoft"
  facebook = "https://www.facebook.com/frapsoft"
  googleplus = "https://plus.google.com/116540931335841862774"

Docker Build Configuration

Gulp Build Pipeline with SASS Compiler ready to run out of the box.

.env

PORT_HUGO=127.0.0.1:1313

DIR_HUGO_DEV=./
DIR_HUGO_PROD=./export

DIR_SASS=./themes/hugo-awesome/static/sass
DIR_CSS=./themes/hugo-awesome/static/css

FILES_SASS=*.+(sass|scss)
GULP_DEBUG=true

docker-compose.yml

version: '3'

services:

  hugo:
    image: ellerbrock/hugo:latest
    working_dir: /site
    command: server --bind 0.0.0.0 -w
    volumes:
      - ${DIR_HUGO_DEV}:/site
    ports:
      - ${PORT_HUGO}:1313
    networks:
      - webdev

  gulp:
    image: ellerbrock/alpine-gulp-sass
    volumes:
      - ${DIR_SASS}:/site/sass
      - ${DIR_CSS}:/site/css
    environment:
      - SASS=${FILES_SASS}
      - GULP_DEBUG=${GULP_DEBUG}
    networks:
      - webdev

networks:
  webdev:
    driver: bridge

What's next?

• Infrastructure as Code a Cloud Environment for different Provider (AWS, Digital Ocean, Alibaba Cloud ...)
• Create a CI/CD Template and Open Source it
• Documentation
• Publish Template

Contact

License

This work by Maik Ellerbrock is licensed under a Creative Commons Attribution 4.0 International License and the underlying source code is licensed under the MIT license.