Hey, this is Jacky. An average guy floating around the internet abyss.

Why create this blog?

  • Keep track of what I have done (so I don’t forget in minutes)
  • Maybe somebody need these info to get started

Why not blogging platform?

  • I could version control my blog content and build it right away
  • I could move whatever I wanted to, as this site is static
  • It’s boring to click and blog

How I make this blog?

I’m using this template powered by Hugo.
It’s simple and clean enough for me to use it as a blogging platform.
Hugo have a huge theme collection for different purpose. You can browse those here.

  1. Install hugo into your local environment. I use brew as I run code on my Mac Mini.
➜ brew install hugo
  1. Go to your development folder and create a new site
➜  hugo new site your-lovely-blog-name

Different theme requires different installation procedure. Please take a look on their Github instructions.
The following will be this specific theme.

  1. Create an additional folder to version control your blogpost and static content (if any)
➜  mkdir -p your-blog-content/content/posts
➜  mkdir -p your-blog-content/static
  1. Enter your your-lovely-blog-name directory, clone the theme and set the Hugo theme to hugo-theme-m10c
➜  cd your-lovely-blog-name
➜  git clone https://github.com/vaga/hugo-theme-m10c.git themes/hugo-theme-m10c 
➜  echo 'theme = "hugo-theme-m10c"' >> hugo.toml
  1. Move the hugo.toml to your-blog-content and soft link them to the your-lovely-blog-name folder
    Soft link the content could make the .gitignore less hassle.
➜  mv hugo.toml ../your-blog-content/.
➜  ln -s ../your-blog-content/static static
➜  ln -s ../your-blog-content/content content
➜  ln -s ../your-blog-content/hugo.toml hugo.toml
  1. Don’t rush for creating the content. Test it before you continue
➜  hugo server

Go to http://127.0.0.1:1313 on your browser and you should see something like this.

Local Hugo Dev

And you have yor first Static Site Generated.
Next up will be creating a blog post and config some items.