A comment thread under every post of your Kite site.
English · 简体中文
Comments is an official plugin for Kite. Pick a comment service in the studio and every post gets a thread, placed after the post and styled to match the page.
- Four services. Giscus keeps the comments in the Discussions of a GitHub repository; Waline and Twikoo run on a server of your own, or on Tencent CloudBase for Twikoo; Kite Plus Comments is hosted for you, with nothing to run.
- Threads that survive a new address. With Giscus and Kite Plus Comments, a post is matched to its discussion by its id, so renaming a post or moving the site keeps its comments.
- Dark when the page is. The thread follows the page into dark mode and back, whether the theme follows the system or has a switch of its own.
- Where a reader expects it. At the end of the post, after the links to the posts around it, or wherever your theme marks.
- Up to each post.
comments: falsein a post's front matter leaves its thread out; pages can have one too. - Quick to load in mainland China. Waline and Twikoo load from jsDelivr, unpkg or npmmirror, as you choose.
- Download
comments-<version>.zipfrom the latest release. - In Kite's studio, open Plugins, drop the zip on Upload plugin, and switch it on.
Or from the command line, inside your site:
kite plugin add comments-0.1.0.zip
kite plugin enable commentsIt needs Kite 0.1 or later.
Under Plugins → Comments → Settings, the form shows only what the chosen
service needs. A preview at localhost says which settings are still missing
where the thread would be.
| Setting | Service | What it is |
|---|---|---|
| Service | Giscus, Waline, Twikoo or Kite Plus Comments | |
| Repository, Repository ID, Discussion category, Category ID | Giscus | Copy them from giscus.app once the repository and category are chosen there |
| Match a post to its discussion by | Giscus | The post's id (the default), the path of its address, its whole address, or its title |
| Server address | Waline | Where your Waline server runs |
| Environment | Twikoo | Your Twikoo server's address, or its environment ID on Tencent CloudBase |
| Site ID | Kite Plus Comments | Copy it from the comments console |
| Under pages too | Also puts a thread under pages such as About | |
| Load scripts from | Waline, Twikoo | jsDelivr, unpkg or npmmirror |
Kite Plus Comments is a hosted comment service from Kite Plus. Readers sign in
with a Kite Plus account, and there is no server of your own to run. It becomes
live at comments.kite.plus.
The thread takes on the page's look: its accent is the color of the article's links (darkened when needed so white text on it stays readable, as in dark mode), and it uses a serif face when the article does. A theme can name both instead; see below.
- Sign in to the comments console with a Kite Plus account, add your site's address, and verify it.
- Copy the site's Site ID from the console.
- Under Plugins → Comments → Settings, choose Kite Plus Comments as the service and paste the Site ID.
The thread goes at the end of the page's <main>. To put it somewhere else,
mark the spot:
<div data-kite-comments></div>With Kite Plus Comments, the same spot can name the thread's accent and font for the theme, in place of what the plugin reads from the page:
<div data-kite-comments data-accent="#b25334" data-font="serif"></div>data-accent is a #RRGGBB color, data-font is serif or sans.
Set version in plugin.yaml, commit, and push a tag of the same version,
such as v0.1.0. The release workflow packs dist/comments-<version>.zip
and attaches it to a GitHub release. make zip packs the same file locally,
and kite plugin verify . checks the plugin the way a site will.
| Plugin | What it adds |
|---|---|
| Analytics | Visit counts with Baidu Tongji, Google Analytics, Umami or Plausible |
| Math and Diagrams | TeX math with KaTeX, and mermaid code blocks drawn as diagrams |
| Search | Search in the reader's browser, with nothing to run |