gemlikes

Гемлики

Система симпатии и комментариев для протокола Близнецов, особенно для Gemlogs! Он работает с использованием CGI, поэтому для запуска нет дополнительного сервера.

Статус проекта

Это в основном игрушечный/демонстрационный проект. Это работает, и я запускаю его на своем Gemlog, но он был быстро сделан и не хорошо спроектирован. По этой причине это репо сейчас архивируется. Смотрите мой сообщение в блоге для получения более подробной информации.

Может быть, вместо этого проверить, как ним!

Пример

Посетите gemini://makeworld.space/gemlog/2020-05-21-first.gmi (прокси), чтобы увидеть ее в действии. Вот пример вывода:

 # 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.

Комментарии отображаются с последними вверху.

Установка

На сервере Gemini была ошибка, которая заставила Gemlikes не работать. Пожалуйста, обновите свою Молли Браун, чтобы совершить 2e4a10297e или позже, если вы его используете. Другие серверы должны быть в порядке.

Есть три двоичных файла: view , like и add-comment .

• Бинарные имена не должны быть изменены
• Они должны быть помещены в каталог, который позволит вашему серверу запускать двоичные файлы
  • cgi-bin/gemlikes/ рекомендуется
• Все они должны быть в одном и том же каталоге, так что будут работать относительные ссылки

Существует также файл конфигурации, который должен находиться в том же каталоге с именем gemlikes.toml . Это имя не может быть изменено. Посмотрите на файл примера config.toml в репо, чтобы увидеть доступные параметры. Вам нужно будет создать и изменить файл конфигурации, он не будет работать без него.

Наконец, создайте файл robots.txt в корне сайта и запретите любым ботам для доступа к like и add-comment составу, чтобы предотвратить случайные лайки от сканеров. Вот пример файла, если все двоичные файлы установлены в /cgi-bin/gemlikes/ :

 User-agent: *
Disallow: /cgi-bin/gemlikes/like
Disallow: /cgi-bin/gemlikes/add-comment 

Получение двоичных файлов

Самый простой вариант - загрузить соответствующий файл .tar.gz со страницы релизов, извлечь его ( tar xvfz filename ) и переместить три двоичных файла в правильный каталог, как указано выше.

Если у вас установлен инструмент GO, вы также можете клонировать репо (не go get ), а затем запустить single-build.sh . Двоичные файлы будут в недавно изготовленной папке build , готовой к перемещению.

Использование

1. Найдите файл, который вы хотите, чтобы пользователи могли любить (и комментировать)
2. Убедитесь, что файл находится в каталоге, который указан в вашем файле gemlikes.toml
3. Добавить ссылку на hostname.tld/path/to/gemlikes/view?file-name.gmi

Например, если файл находится по адресу gemini://example.com/gemlog/first-post.gmi , а мои двояки на gemini://example.com/cgi-bin/gemlikes/ , вот как должен выглядеть файл:

 <blog post text here, blah blah>

=> gemini://example.com/cgi-bin/gemlikes/view?first-post.gmi View likes and comments!

Защитные меры

У Gemlikes есть некоторые средства защиты, чтобы предотвратить злоупотребление или олицетворение комментариев и симпатичной системы. Обратите внимание, что администратор сервера может делать комментарии, а лайки говорят все, что они хотят.

• Идентификатор генерируется на основе IP -адреса комментатора, чтобы предотвратить подражание другими комментаторами.
  • Он отображается прямо рядом с их именем пользователя, как можно увидеть выше
• Имена пользователей не могут быть повторно использованы на одной странице разными IP -адресами
• IP -адрес не может сделать более 5 комментариев на странице по умолчанию, хотя это настраивается в файле gemlikes.toml
• Тот же IP -адрес не может понравиться файл более одного раза
• Только файлы в каталогах, указанных в gemlikes.toml могут быть похожи и прокомментированы - Попытка ссылаться на файлы, которые не существуют, дадут ошибку.

Ограничения

• Он не может обрабатывать несколько файлов одного имени в разных местах. Например, если есть файл по адресу /myfile.gmi и еще один файл по адресу /dir/myfile.gmi , Gemlikes откажется отображать или выполнять действия, потому что он не знает, на какой из них упоминается.
  • Это применимо только в том случае, если оба каталога, в которых находятся эти файлы, включены в файл gemlikes.toml . Если указан только один, например, /dir , не будет никаких проблем.
• Комментарии не могут быть отключены для каждого файла, только во всем мире. Я могу добавить это в будущем.

Лицензия

Gemlikes имеет лицензию в соответствии с общей публичной лицензией GNU Affero, версия 3. Основной момент этой лицензии состоит в том, что даже если вы измените код и не распространяете программное обеспечение никому, вам все равно придется выпустить свои изменения, если вы используете этот код на общедоступном сервере. Пожалуйста, смотрите файл лицензии для получения подробной информации.