Blogs-Comment

This repository is the comment store for Yang's Blogs.

It is intended to be used by the blog frontend through utterances, with GitHub Issues acting as the backing store for article comments.

Purpose

• Keep blog comments separate from the blog source repository
• Use one issue thread per article
• Let the static GitHub Pages blog support comments without running its own backend

Required Repository Settings

To make comments work correctly:

1. Keep this repository public
2. Keep GitHub Issues enabled
3. Install the utterances GitHub app for this repository

Thread Mapping

Each article uses a stable issue term based on the blog slug, for example:

• blog-post:linux-basic
• blog-post:docker-basic
• blog-post:k8s

This keeps comment threads stable even if the blog layout changes later.

What Happens On First Comment

When a visitor comments on a blog article for the first time:

1. utterances looks up the issue term for that article
2. If no matching issue exists, it creates one automatically
3. Later comments on the same article reuse the same issue thread

That means this repository should stay clean and predictable:

• one article slug
• one GitHub issue
• one shared discussion thread

Quick Checks

Use this list if comments stop appearing on the blog:

1. Confirm this repository is still public
2. Confirm Issues are still enabled
3. Confirm the utterances GitHub App is still installed on this repository
4. Confirm the blog is still pointing to yangliubin9-cyber/Blogs-Comment