lobsters

龍蝦鐵軌項目

這是https://lobste.rs的Ghost Town的非常可悲的源代碼。它是一個導軌代碼庫，並為數據庫使用SQL（生產中的MariadB）後端。

您可以免費使用此代碼來啟動自己的姊妹站點，因為該代碼可根據允許許可（3條規定BSD）獲得。我們歡迎使用Bug報告和代碼貢獻，這些貢獻有助於使用改進Lobste.rs。作為一個志願者項目，我們不願意從事對我們網站無用的工作，因此請了解我們是否不想採用您的自定義功能。

貢獻錯誤的文件和新功能

我們很樂意為您提供幫助。有關詳細信息，請參閱貢獻文件。如果您有疑問，我們的聊天室中通常會有一個熟悉代碼的人。

開發設置

使用以下步驟進行本地安裝或龍蝦的生產部署配置。如果要使用Docker，則有一個外部項目Docker-Lobsters。

• 安裝並啟動MariaDB。在Linux上使用您的軟件包管理器。在MacOS上，您可以與Brew一起安裝。在Windows上有一個安裝程序。

• 使用MariadB知識庫中提到的一種方法啟動MariaDB服務器。

• 使用mariadb打開控制台，並設置root用戶密碼（鍵入ctrl-d以後退出）

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

• 安裝.ruby-version中指定的Ruby版本

• 從github結帳龍蝦git樹

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

• 安裝nodejs，需要（或其他execj）uglifier

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

• 運行rails credentials:edit以創建和編輯您的加密憑據文件。這是您為外部服務存儲API鍵以及諸如鍊接帳戶之類的功能。複製並粘貼config/credentials.yml.enc.sample in。 in。在設置時，Rails將為您提供secret_key_base的新隨機值，您可以隨時使用rails secret生成另一個。

• 運行bin/setup以安裝依賴關係並設置DB

  lobsters$ bin/setup

• 在您的生產服務器上，將config/initializers/production.rb.sample複製到config/initalizers/production.rb ，並使用網站的domain和name自定義。 （您不需要在開發機上）。

• 在您的個人計算機上，您可能想添加一些示例數據。

  lobsters$ rails fake_data

• 在開發模式下運行Rails Server。您應該能夠使用新的test用戶登錄http://localhost:3000 ：

  lobsters$ rails server

• 在生產中部署網站需要設置Web服務器並在生產模式下運行應用程序。我們可以描述的工具和選項還多。找到指南或專家。龍蝦的回購包含我們的配置文件來源。一些特定於應用的註釋：

• 設置crontab或其他調度程序以運行常規作業：

   */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'
  

• 在生產中，Run rails credentials:edit以設置那裡的憑據，就像您為開發所做的那樣。在設置時，Rails將為您提供secret_key_base的新隨機值，並且您可以在需要生成另一個時使用rails secret 。切勿git commit或共享您的config/credentials.yml.enc 。

• 您可能想使用git-imerge進行從龍蝦到網站的更改。

行政

基本的適度發生在現場，但是許多管理任務需要在生產中使用導軌控制台。管理員可以在/tags上創建和編輯標籤。