Hugo blog powered by GitHub Pages and GitHub Codespaces

Clone repo in Codespaces
Add Hugo devcontainer
1. Click the “Codespaces” button in the bottom-left corner of Visual Studio Code
2. Click “Add Development Container Configuration Files”
3. Click “Show All Definitions”
4. Click “Hugo (Community)”
5. Click “OK”
Create new hugo site:
1
>hugo new site blog

Try to create new hugo module https://docs.stack.jimmycai.com/getting-started

1
2
>hugo mod init github.com/achingono/achingono.github.io
Error: failed to init modules: binary with name "go" not found

Add go binary to devcontainer docker file

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# GO version
ARG GO_VERSION=18

#Download Go
RUN wget https://golang.org/dl/go1.${GO_VERSION}.linux-amd64.tar.gz && \
    tar -C /usr/local -xzf go1.${GO_VERSION}.linux-amd64.tar.gz && \
    rm go1.${GO_VERSION}.linux-amd64.tar.gz

ENV GOPATH /go
ENV PATH $GOPATH/bin:/usr/local/go/bin:$PATH

Check go version

1
2
>go version
go version go1.18 linux/amd64

Turn new site into a Hugo module:

1
2
3
4
>hugo mod init github.com/achingono/achingono.github.io
go: creating new go.mod: module    github.com/achingono/achingono.github.io
go: to add module requirements and sums:
    go mod tidy

Declare the hugo-theme-stack module as a dependency of your site:

1
2
3
4
>hugo mod get github.com/CaiJimmy/hugo-theme-stack/v3
go: downloading github.com/CaiJimmy/hugo-theme-stack/v3 v3.10.0
go: downloading github.com/CaiJimmy/hugo-theme-stack    v2.6.0+incompatible
go: added github.com/CaiJimmy/hugo-theme-stack/v3 v3.10.0

Grab config file from example site

1
>wget https://raw.githubusercontent.com/CaiJimmy/hugo-theme-stack/master/exampleSite/config.yaml

Update config.yaml file

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 baseurl: https://achingono.github.io
 languageCode: en-us
 theme: github.com/CaiJimmy/hugo-theme-stack/v3
 paginate: 5
 title: Alfero Chingono

 languages:
     en:
         languageName: English
         title: Alfero Chingono
         weight: 1

 # Change it to your Disqus shortname before using
 disqusShortname: achingono

 # GA Tracking ID
 googleAnalytics:

 # Theme i18n support
 # Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk, ar
 DefaultContentLanguage: en

 # Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
 # This will make .Summary and .WordCount behave correctly for CJK languages.
 hasCJKLanguage: false

 permalinks:
     post: /blog/:slug/
     page: /:slug/

...

module:
  # uncomment line below for temporary local development of module
  # replacements: "github.com/CaiJimmy/hugo-theme-stack/v3 -> ../../hugo-theme-stack"
  imports:
    - path: github.com/CaiJimmy/hugo-theme-stack/v3
      disable: false

Delete config.toml file
Create new post
Run hugo server -D
Browse to http://127.0.0.1:1313