How Hugo and Oink Integrate Giscus Comments

Wed, 30 Sep 2026 00:00:00 +0000

Hugo produces static HTML. It does not provide a server that accepts comments, a database, or a user system. Adding comments to a Hugo site with Oink therefore means delegating the comment interface to Giscus and storing the data in GitHub Discussions.

When I added comments to the site, I wanted one conversation for everyone—whether they opened the Chinese or English page, on Vercel or GitHub Pages. Here’s how the pieces work together to bring a comment onto a static blog page.

Building a Personal Site with Oink, from Setup to Publication

Sat, 29 Aug 2026 00:00:00 +0000

The official Oink tutorial is comprehensive, but connecting the folders, configuration, and commands can still be confusing the first time, especially without much frontend experience. These notes from building YHY Study Website follow one path: understand Oink, learn how content/ is organized, and then write and publish a blog post.

Markdown → Hugo → the Oink theme → a deployable static site

What Hugo and Oink each do

Hugo is a static site generator: it reads Markdown and configuration and produces HTML. Oink is a Hugo theme: it controls the appearance of sidebars, cards, callouts, code blocks, and other components.

Oink on YHY Study Website

How Hugo and Oink Integrate Giscus Comments

Building a Personal Site with Oink, from Setup to Publication

What Hugo and Oink each do