HarmonyHu's Notes

HarmonyHu's Notes is a personal technical blog built with Jekyll using a custom, hand-rolled theme (no upstream Jekyll theme dependency).

The site is published at https://harmonyhu.com and mainly contains Chinese-language notes on AI compilers, deep learning, systems, and software engineering.

Local development

Install Ruby dependencies:

bundle install

Start the local Jekyll server:

bundle exec jekyll serve

The site will be available at http://127.0.0.1:4000.

JavaScript and CSS assets under assets/js/ and assets/css/ are served as-is — there is no build step or bundler, so edits take effect on the next Jekyll rebuild.

Project structure

• _posts/: blog posts (Markdown)
• _pages/: standalone pages (About, Archive, Categories, Tags, 404)
• _layouts/: page layouts (default, home, post, page, archive, categories, tags, single)
• _includes/: reusable snippets (head, header, footer, comments, paginator, post-nav, search-modal, svg-icons)
• _sass/: SCSS partials imported by assets/css/main.scss
• assets/: site CSS, JS, and images
• search.json: search index generated by Jekyll for the in-page search modal

Customizations

• Comments are rendered through Giscus in _includes/comments.html (GitHub Discussions backed).
• Theme switching (light/dark) is handled in assets/js/main.js and persisted in localStorage; the initial theme is set inline in _includes/head.html to avoid a flash of incorrect theme.
• Reading progress bar, auto-generated TOC, and mobile nav are implemented in assets/js/main.js.
• SEO is handled by jekyll-seo-tag; sitemap by jekyll-sitemap.

Plugins

Configured in _config.yml and Gemfile:

• jekyll-paginate
• jekyll-sitemap
• jekyll-seo-tag
• jekyll-include-cache