gemlikes

Gemlikes

Sistem kesukaan dan komentar untuk protokol Gemini, terutama untuk Gemlogs! Ini berfungsi menggunakan CGI, jadi tidak ada server tambahan untuk dijalankan.

Status proyek

Ini sebagian besar proyek mainan/demo. Ini berhasil, dan saya menjalankannya di Gemlog saya, tetapi itu dengan cepat dibuat dan tidak dirancang dengan baik. Karena alasan ini, repo ini sekarang diarsipkan. Lihat posting blog saya untuk lebih jelasnya.

Mungkin periksa saja Nim seperti!

Contoh

Kunjungi gemini://makeworld.space/gemlog/2020-05-21-first.gmi (proxy) untuk melihat demo itu beraksi. Inilah contoh 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.

Komentar ditampilkan dengan yang terbaru di bagian atas.

Instalasi

Ada bug di server Molly Brown Gemini yang menyebabkan Gemlikes tidak berfungsi. Harap perbarui Molly Brown Anda untuk melakukan 2e4a10297e atau lebih baru, jika Anda menggunakannya. Server lain harus baik -baik saja.

Ada tiga binari untuk diinstal: view , like , dan add-comment .

• Nama biner tidak boleh diubah
• Mereka harus ditempatkan di direktori yang akan memungkinkan server Anda menjalankan binari
  • cgi-bin/gemlikes/ direkomendasikan
• Mereka semua harus berada di direktori yang sama, sehingga tautan relatif akan berfungsi

Ada juga file konfigurasi yang perlu berada di direktori yang sama, dengan nama gemlikes.toml . Nama ini tidak dapat diubah. Lihatlah file Contoh-Config.toml di repo untuk melihat opsi yang tersedia. Anda perlu membuat dan mengubah file konfigurasi, itu tidak akan berfungsi tanpa satu.

Akhirnya, buat file robots.txt di root situs, dan larang bot apa pun untuk mengakses biner like dan add-comment , untuk mencegah suka yang tidak disengaja dari crawler. Berikut adalah contoh file, jika semua binari dipasang di /cgi-bin/gemlikes/ :

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

Mendapatkan binari

Opsi termudah adalah mengunduh file .tar.gz yang sesuai dari halaman rilis, mengekstraknya ( tar xvfz filename ), dan memindahkan tiga binari ke direktori kanan sebagaimana diuraikan di atas.

Jika Anda memiliki Toolchain GO diinstal, Anda juga dapat mengkloning repo (tidak go get ), dan kemudian jalankan single-build.sh . Binari akan berada di folder build yang baru dibuat, siap dipindahkan.

Penggunaan

1. Temukan file yang Anda inginkan untuk dapat disukai pengguna (dan berkomentar)
2. Pastikan file ada di direktori yang ditentukan dalam file gemlikes.toml Anda
3. Tambahkan tautan ke hostname.tld/path/to/gemlikes/view?file-name.gmi

Misalnya, jika file tersebut ada di gemini://example.com/gemlog/first-post.gmi , dan binari saya ada di gemini://example.com/cgi-bin/gemlikes/ , inilah file yang seharusnya terlihat:

 <blog post text here, blah blah>

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

Tindakan pelindung

Gemlikes memiliki beberapa perlindungan untuk mencegah penyalahgunaan atau peniruan sistem komentar dan kesukaan. Perhatikan bahwa admin server dapat membuat komentar dan suka mengatakan apa pun yang mereka inginkan.

• ID dihasilkan berdasarkan alamat IP komentator untuk mencegah peniruan oleh komentator lain
  • Itu ditampilkan tepat di samping nama pengguna mereka, seperti yang dapat dilihat di atas
• Nama pengguna tidak dapat digunakan kembali pada satu halaman dengan alamat IP yang berbeda
• Alamat IP tidak dapat membuat lebih dari 5 komentar pada halaman secara default, meskipun ini dapat dikonfigurasi di file gemlikes.toml
• Alamat IP yang sama tidak dapat menyukai file lebih dari satu kali
• Hanya file dalam direktori yang ditentukan dalam gemlikes.toml yang bisa dan dikomentari - mencoba referensi file yang tidak ada akan memberikan kesalahan

Batasan

• Itu tidak dapat menangani beberapa file dengan nama yang sama di lokasi yang berbeda. Misalnya jika ada file di /myfile.gmi dan file lain di /dir/myfile.gmi , Gemlikes akan menolak untuk menampilkan atau melakukan tindakan, karena tidak tahu mana yang dirujuk.
  • Ini hanya berlaku jika kedua direktori file -file ini termasuk dalam file gemlikes.toml . Jika hanya satu yang ditentukan, seperti /dir , tidak akan ada masalah.
• Komentar tidak dapat dinonaktifkan per file, hanya secara global. Saya dapat menambahkan ini di masa depan.

Lisensi

Gemlikes dilisensikan di bawah Lisensi Publik Umum GNU Affero, versi 3. Poin utama lisensi ini adalah bahwa bahkan jika Anda memodifikasi kode dan tidak mendistribusikan perangkat lunak kepada siapa pun, Anda masih harus merilis perubahan Anda jika Anda menggunakan kode ini di server publik. Silakan lihat file lisensi untuk detailnya.