Comments : Linewise

Linewise supports comments through a provider setting. It ships with giscus, a system that stores discussions in your GitHub repository. Comments are disabled by default.

Setup

Choose your provider in hugo.toml. The default is "none".

[params.linewise.comments]
provider = "none"

Using giscus

You need a public GitHub repository with Discussions enabled, plus four identifiers from the giscus configuration page.

1. Enable Discussions: go to your repo on GitHub, open Settings -> Features -> Discussions, check the box, and save.

2. Install the giscus app: visit github.com/apps/giscus, install it, and grant access to your blog repo.

3. Get your IDs: open giscus.app, fill in your repo name, and pick a Discussion category. Copy the values shown:

Field	Example
`repo`	`"tabsp/linewise"`
`repoId`	`"R_kgDO..."`
`category`	`"Comments"`
`categoryId`	`"DIC_kwDO..."`

4. Update your config:

[params.linewise.comments]
provider = "giscus"

[params.linewise.comments.giscus]
repo = "tabsp/linewise"
repoId = "R_kgDO..."
category = "Comments"
categoryId = "DIC_kwDO..."

giscus options

These all have defaults and can be omitted.

Option	Default	Description
`theme`	Linewise example-site CSS URL	giscus theme name or a custom CSS URL
`mapping`	`"pathname"`	How pages map to discussions
`strict`	`"1"`	Match the discussion term exactly
`inputPosition`	`"bottom"`	Where the comment box appears
`reactionsEnabled`	`"1"`	Show reactions on the main post
`emitMetadata`	`"0"`	Emit discussion metadata
`lang`	site language	Widget language
`loading`	`"lazy"`	`"lazy"` or `"eager"`

Theme

By default, Linewise points giscus at https://linewise.tabsp.com/giscus-theme.css, the custom theme served by the Linewise example site for visual consistency. Override theme when you want to self-host a compatible CSS file or use a built-in giscus theme name such as "light", "dark", "preferred_color_scheme", or "transparent_dark".

Custom CSS URLs must be served with Access-Control-Allow-Origin: *.

Disabling

Set provider back to "none" and rebuild. The comment section disappears from every post.