Yan Bai

Personal bilingual technical blog powered by Hugo, PaperMod, GitHub Pages, and Giscus.

Local Preview

Install Hugo Extended first:

hugo version

Then run:

hugo server -D

Write Bilingual Posts

English is the default language and lives at the root path. Chinese pages live under /zh/.

Create two files with the same translationKey:

content/posts/my-post.zh.md
content/posts/my-post.en.md

Example front matter:

---
title: "文章标题"
date: 2026-05-17T01:10:00+08:00
draft: false
translationKey: "my-post"
tags: ["distributed-training"]
categories: ["分布式训练"]
---

GitHub Pages Setup

1. Create a GitHub repository. For this user site, name it ISEEKYAN.github.io.
2. Keep baseURL and the GitHub social link in hugo.yaml pointed at ISEEKYAN.
3. Push this repository to GitHub:

git init
git add .
git commit -m "Initialize Hugo blog"
git branch -M main
git remote add origin git@github.com:ISEEKYAN/ISEEKYAN.github.io.git
git push -u origin main

4. In GitHub, open Settings -> Pages and select GitHub Actions as the build and deployment source.

Private repositories can publish with GitHub Pages only when the account/plan supports it. If Pages does not allow deployment from the private repo, make the repository public after the content is ready.

Giscus Comments Setup

1. Enable Discussions in the GitHub repository.
2. Install the Giscus GitHub app: https://github.com/apps/giscus
3. Open https://giscus.app and select the repository and discussion category.
4. Copy repo, repoId, category, and categoryId into params.giscus in hugo.yaml.

Comments stay disabled until those Giscus fields are filled.