Build a Personal Blog with Hugo + GitHub

wzdushu@gmail.com (wanzi) — Tue, 10 Mar 2020 16:22:42 +0800

Introduction to Hugo

Previously, I used Hexo to build my blog. As I’ve been using Go more and more, I’ve wanted to migrate my blog to Hugo. Hugo is a static site generator written in Go—simple, easy to use, efficient, extensible, and fast to deploy.

Installing Hugo

Here’s how to install Hugo on macOS:

brew install hugo
hugo new site wanzi
cd wanzi
git clone https://github.com/xianmin/hugo-theme-jane.git --depth=1 themes/jane
cp -r themes/jane/exampleSite/content ./
cp themes/jane/exampleSite/config.toml ./

Update config.toml with your own blog information.

My website directory structure looks like this:

.
├── LICENSE
├── archetypes # Stores default.md, the template for post headers
│   └── default.md
├── config.toml
├── content # Global configuration for the entire site
│   ├── about.md
│   └── post
├── data # Stores data or configurations (JSON, TOML, YAML)
├── layouts # Contains template files for the site
├── public # Static files generated after Hugo compilation
│   ├── 404.html
│   ├── about
│   ├── atom.xml
│   ├── categories
│   ├── css
│   ├── favicon.ico
│   ├── fonts
│   ├── icons
│   ├── index.html
│   ├── js
│   ├── manifest.json
│   ├── mark
│   ├── posts
│   ├── robots.txt
│   ├── rss.xml
│   ├── sitemap.xml
│   └── tags
├── resources
│   └── _gen
├── static # Stores static assets like images, CSS, JS
└── themes # Stores website themes
    └── jane

Writing Posts

`1`	`hugo new content/posts/git-commands-base.md`

Push to GitHub

cd wanzi/public
git init 
git remote add origin https://github.com/iwz2099/wanzi
echo "wnote.com" > CNAME
git add -A
git commit -m "initialization"
git push -u origin master

If you’re using a custom domain, simply create a CNAME file in your GitHub repository and add your domain name (e.g., wnote.com). This will allow visitors to access your blog via your custom domain.

Blog on Wanzi's Blog – Notes on life, tech, and DevOps.

Build a Personal Blog with Hugo + GitHub

Introduction to Hugo

Installing Hugo

Writing Posts

Push to GitHub