In this very first article will show you how I built my blokaly.com website using Hugo with PaperMod, AWS S3 and Terraform.

In part one, we will build the website locally. And in part two, we will create the AWS infrastructure and deploy our website.

Introduction

Hugo

Hugo is a static HTML and CSS website generator written in Go. It is optimized for speed, ease of use, and configurability. Hugo takes a directory with content and templates and renders them into a full HTML website. It relies on Markdown files with front matter for metadata, and you can run Hugo from any directory.

hugo logo Here are their website and github repo .

You can also read the quick-start guide

PaperMod

Hugo supports a wide variety of themes and PaperMod is one of them. I chose it for my blokaly.com website because it looks very simple and clean with a good example demo website . You can see the instruction for how to install it.

Build

Prerequisites

The tools you will need to complete the build:

  • hugo
  • git
  • an IDE with markdown plugin, mine is WebStorm
  • markdown editor (optional), mine is Obsidian

Instructions

  1. Follow this instruction to install Hugo
  2. If you need to install git, then you can follow this instruction
  3. Then clone the PaperMod project locally 
    1

    $ git clone git@github.com:adityatelange/hugo-PaperMod.git
  4. Swtich to exampleSite branch and update the submodule 
    1
2
3
4

    $ cd hugo-PaperMod
$ git checkout exampleSite
$ git submodule update --init
$ git submodule update --remote
  5. Run the hugo command line and access http://localhost:1313 to view the posts 
    1

    $ hugo server -D
  6. To create your first post, you can run 
    1

    $ hugo new posts/my-first-post.md

References