A Hugo site with the Congo theme. GitHub Actions builds the site and publishes it to GitHub Pages at https://chrisvoo.github.io/.
- Hugo extended 0.158.0 or later (Congo needs SCSS)
- Go (Hugo uses it to download the theme)
- Git
git clone git@github.com:chrisvoo/chrisvoo.github.io.git
cd chrisvoo.github.io
hugo server -DOpen http://localhost:1313/. The -D flag shows drafts. The page reloads when you save a file.
The first run downloads Congo as a Hugo Module. No git submodule step is needed.
-
Create the post:
hugo new posts/my-post-slug.md
-
Edit
content/posts/my-post-slug.md. Set the front matter:title: 'My Post Title' date: 2026-01-31T10:00:00 draft: false # draft = true hides the post in production tags: [hugo, blog] summary: One sentence for the post list. comments: true # Giscus comments see_also: # optional related posts - /posts/another-post-slug/
-
Put images in
static/images/uploads/. Link them as/images/uploads/<file>. -
Check the result with
hugo server -D. -
Publish:
git add content/posts/my-post-slug.md static/images/uploads git commit -m "Add post: my post title" git push origin main
Each push to main starts the workflow .github/workflows/deploy.yml.
The site is live after about one minute. Watch progress in the repository's Actions tab.
To test the production build locally:
hugo --minify --baseURL "https://chrisvoo.github.io/" --buildFutureThe site includes Sveltia CMS at
https://chrisvoo.github.io/admin/.
It reads and writes Markdown files in content/posts/ through the GitHub API.
You need no server and no OAuth proxy. You need a Personal Access Token (PAT).
- Open GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens.
- Click Generate new token.
- Under Repository access, select only
chrisvoo/chrisvoo.github.io. - Under Repository permissions, set Contents to Read and write.
- Copy the token. GitHub shows it only once.
A classic token with the repo scope also works, but it has wider access.
- Open https://chrisvoo.github.io/admin/.
- Choose Sign In Using Token and paste the PAT.
- Open Blog Posts and click New Blog Post.
- Fill in the fields and set Draft to off.
- Click Publish.
Sveltia commits the file straight to main. The deploy workflow then publishes the site.
Do not share the token. Revoke it in GitHub if you lose it.
| Path | Purpose |
|---|---|
config/_default/ |
Hugo and Congo settings (hugo.toml, params.toml, menus.en.toml, ...) |
content/ |
Home page text and posts |
layouts/ |
Template overrides, including the custom home page and Giscus comments |
assets/css/custom.css |
Custom styles |
static/ |
Files copied as-is: images, resume.pdf, admin/ (the CMS) |
.github/workflows/deploy.yml |
Build and deploy pipeline |
- In
params.toml, keep the[author]block last. TOML puts every key after a section header inside that section. Runhugo configto check where settings land. - To override a Congo partial, copy it to
layouts/_partials/(with the underscore). - A local
_vendor/folder makes Hugo ignore module updates. Delete it before you runhugo mod get.
hugo mod get github.com/jpanther/congo/v2@latest && hugo mod tidy