Own-comments

Commenting system designed to work in conjunction with static site generators.

Documentation: https://nicoco.srht.site/own-comments/

Issue tracker: https://todo.sr.ht/~nicoco/own-comments

Work in progress, some force pushes may occur before the real initial commit.

Features

• Minimalist
• Cookie-less: editable comments using an update key stored in the browser localstorage
• Submitting a comment is possible without javascript
• Optional customizable frontend using an HTML template element*
• Email notifications (for the site owner)

[*] the REST api is pretty straightforward to use if you want to roll your own fronted

Technical details

The backend is written using fastapi, typed-checked with mypy and tested with pytest.

The openapi schema produced is used in the frontend, written in typescript, using openapi-typescript-fetch as the only dependency.

See it in action

It powers the comments of my personal blog. By the time you read this, maybe someone will have posted a comment on a blog entry, who knows?

Quickstart

podman run -p 8000:80 docker.io/nicocool84/own-comments:latest

Visit http://localhost:8000/static/index.html or http://localhost:8000/docs to see what it looks like.

Alternatives

This blog post lists quite a few alternatives. Own-comments was heavily inspired by caint.