lobsters

Proyek Lobsters Rails

Ini adalah kode sumber yang cukup menyedihkan untuk kota hantu di https://lobste.rs. Ini adalah basis kode Rails dan menggunakan backend SQL (mariadb dalam produksi) untuk database.

Anda bebas menggunakan kode ini untuk memulai situs Sister Anda sendiri karena kode tersedia di bawah lisensi permisif (3-Clause BSD). Kami menyambut laporan bug dan kontribusi kode yang membantu menggunakan meningkatkan lobste.rs. Sebagai proyek sukarela, kami enggan untuk melakukan pekerjaan yang tidak berguna untuk situs kami, jadi harap dipahami jika kami tidak ingin mengadopsi fitur khusus Anda.

Kontribusi perbaikan bug dan fitur baru

Kami ingin mendapat bantuan Anda. Silakan lihat file yang berkontribusi untuk detailnya. Jika Anda memiliki pertanyaan, biasanya ada seseorang di ruang obrolan kami yang akrab dengan kode tersebut.

Pengaturan Pembangunan

Gunakan langkah-langkah di bawah ini untuk instalasi lokal atau lobsters-antikan untuk konfigurasi penyebaran produksi kami. Ada Proyek Eksternal Docker-Lobsters jika Anda ingin menggunakan Docker.

• Instal dan mulai Mariadb. Di Linux Gunakan manajer paket Anda. Pada macOS Anda dapat menginstal dengan minuman. Di Windows ada pemasang.

• Mulailah server Mariadb menggunakan salah satu metode yang disebutkan di basis pengetahuan MariaDB.

• Buka konsol menggunakan mariadb , dan atur kata sandi pengguna root (ketik ctrl-d untuk keluar setelahnya)

 ALTER USER ' root ' @ ' localhost ' IDENTIFIED BY ' localdev ' ;

• Instal versi Ruby yang ditentukan dalam .Ruby-Version

• Lihat pohon git lobster dari github

  $ git clone [email protected]:lobsters/lobsters.git
  $ cd lobsters
  lobsters$

• Instal NodeJs, Dibutuhkan (atau ExecJs lainnya) untuk Uglifier

  Fedora: sudo yum install nodejs
  Ubuntu: sudo apt-get install nodejs
  OSX: brew install nodejs

• Jalankan rails credentials:edit untuk membuat dan mengedit file kredensial terenkripsi Anda. Di sinilah Anda menyimpan kunci API untuk layanan dan fitur eksternal seperti menghubungkan akun. Salin dan Tempel Isi config/credentials.yml.enc.sample In. Pada pengaturan, Rails akan memberi Anda nilai acak baru untuk secret_key_base dan Anda dapat menggunakan rails secret kapan saja Anda perlu menghasilkan yang lain.

• Jalankan bin/setup untuk menginstal dependensi dan mengatur db

  lobsters$ bin/setup

• Di server produksi Anda, Salin config/initializers/production.rb.sample to config/initalizers/production.rb dan menyesuaikannya dengan domain dan name situs Anda. (Anda tidak membutuhkan ini di mesin dev Anda).

• Di komputer pribadi Anda, Anda mungkin ingin menambahkan beberapa data sampel.

  lobsters$ rails fake_data

• Jalankan server Rails dalam mode pengembangan. Anda harus dapat masuk ke http://localhost:3000 dengan pengguna test baru Anda:

  lobsters$ rails server

• Menyebarkan situs dalam produksi membutuhkan pengaturan server web dan menjalankan aplikasi dalam mode produksi. Ada lebih banyak alat dan opsi yang tersedia daripada yang dapat kita jelaskan; Temukan panduan atau ahli. Repo lobsters-ansible memiliki file konfigurasi kami untuk membuat buaian. Beberapa catatan khusus aplikasi:

• Siapkan Crontab atau penjadwal lain untuk menjalankan pekerjaan reguler:

   */5 * * * *  cd /path/to/lobsters && env RAILS_ENV=production sh -c 'bundle exec ruby script/mail_new_activity; bundle exec ruby script/mastodon_sync.rb; bundle exec ruby script/traffic_range'
  

• Pada produksi, Run rails credentials:edit untuk mengatur kredensial di sana, seperti yang Anda lakukan untuk pengembangan. Pada pengaturan, Rails akan memberi Anda nilai acak baru untuk secret_key_base dan Anda dapat menggunakan rails secret kapan saja Anda perlu menghasilkan yang lain. Never git commit atau bagikan config/credentials.yml.enc Anda.yml.enc!

• Anda mungkin ingin menggunakan git-imerge untuk menarik perubahan dari lobster ke situs Anda.

Administrasi

Moderasi dasar terjadi di tempat, tetapi banyak tugas administratif memerlukan penggunaan konsol rel dalam produksi. Administrator dapat membuat dan mengedit tag di /tags .