Handle newlines after username
|2 weeks ago|
|.github||1 year ago|
|add-comment||2 weeks ago|
|like||11 months ago|
|shared||11 months ago|
|view||11 months ago|
|.gitignore||1 year ago|
|LICENSE||1 year ago|
|NOTES.md||1 year ago|
|README.md||2 months ago|
|cross-build.sh||1 year ago|
|example-config.toml||11 months ago|
|go.mod||1 year ago|
|go.sum||1 year ago|
|single-build.sh||1 year ago|
A liking and comment system for the Gemini protocol, especially for gemlogs! It works using CGI, so there’s no additional server to run.
gemini://makeworld.space/gemlog/2020-05-21-first.gmi (Proxy) to see a demo of it in action. Here’s an example output:
# 2020-05-21-first.gmi 15 likes! 💖 => like?2020-05-21-first.gmi Add yours 4 comments 💬 => add-comment?2020-05-21-first.gmi Add yours ben (id: 7ec5a44d) @ Sun, 24 May 2020 04:49:11 UTC: hello there! makeworld (id: 4f9da128) @ Sun, 24 May 2020 04:45:06 UTC: Test 3 makeworld (id: 4f9da128) @ Sun, 24 May 2020 04:32:26 UTC: Test number 2 makeworld (id: 4f9da128) @ Sun, 24 May 2020 04:23:53 UTC: Test comment.
Comments are displayed with the latest at the top.
There was a bug in the Molly Brown Gemini server that caused gemlikes to not work. Please update your Molly Brown to commit
2e4a10297e or later, if you’re using it. Other servers should be fine.
There are three binaries to install:
There is also a config file that needs to be in the same directory, with the name
gemlikes.toml. This name cannot be changed. Look at the example-config.toml file in the repo to see the options available. You will need to create and change the config file, it won’t work without one.
Finally, create a
robots.txt file at the root of the site, and disallow any bots to access the
add-comment binaries, to prevent accidental likes from crawlers.
Here’s an example file, if the binaries are all installed in
User-agent: * Disallow: /cgi-bin/gemlikes/like Disallow: /cgi-bin/gemlikes/add-comment
The easiest option is to download the appropriate
.tar.gz file from the releases page, extract it (
tar xvfz filename), and move the three binaries to the right directory as outlined above.
If you have the Go toolchain installed, you can also clone the repo (Not
go get), and then run
single-build.sh. The binaries will be in the newly made
build folder, ready to be moved.
For example, if the file is at
gemini://example.com/gemlog/first-post.gmi, and my binaries are at
gemini://example.com/cgi-bin/gemlikes/, here’s what the file should look like:
<blog post text here, blah blah> => gemini://example.com/cgi-bin/gemlikes/view?first-post.gmi View likes and comments!
Gemlikes has some protections in place to prevent abuse or impersonation of the comment and liking system. Note that a server admin can make comments and likes say anything they want though.
gemlikes.tomlcan be like and commented on - Trying to reference files that don’t exist will give an error
/myfile.gmiand another file at
/dir/myfile.gmi, gemlikes will refuse to display or perform actions, because it doesn’t know which one is being referred to.
gemlikes.tomlfile. If only one is specified, such as
/dir, there won’t be any issues.
Gemlikes is licensed under the GNU Affero General Public License, version 3. The main point of this LICENSE is that even if you modify the code and don’t distribute the software to anyone, you still will have to release your changes if you use this code on a public server. Please see the LICENSE file for details.