gitlist

GitList：一個優雅的 git 儲存庫檢視器

GitList 是一個優雅且現代的 Web 介面，用於與多個 git 儲存庫進行互動。它允許您使用您最喜歡的瀏覽器瀏覽儲存庫，查看不同版本下的文件、提交歷史記錄、差異。它還為每個儲存庫產生 RSS/Atom 來源，讓您隨時隨地了解最新變更。 GitList 是在 Symfony 框架之上用 PHP 編寫的，並由 Twig 模板引擎提供支援。這意味著 GitList 易於安裝且易於自訂。此外，由於 Bootstrap，GitList 介面也成為可能。

特徵

• 多存儲庫支持
• 多分支機構支持
• 多標籤支援
• 提交歷史、責備、差異
• RSS/Atom 提要
• 透過 CodeMirror 或 Ace 進行語法高亮顯示
• 儲存庫統計

截圖

要求

為了在您的伺服器上運行 GitList，您需要：

• PHP 8.1
• git 2
• 網路伺服器（Apache、nginx）

安裝

• 下載最新版本或每晚建置並解壓縮到/var/www/gitlist資料夾，或您想要放置 GitList 的任何其他位置。
  • 不要使用來源版本，或從 GitHub 下載分支或標籤。它不適合最終用戶，僅適合開發。
• 開啟config/config.yml並設定您的安裝。您必須提供儲存庫所在的位置。
  • 或者，您可以匯出環境變數DEFAULT_REPOSITORY_DIR以及包含儲存庫的目錄
• 建立快取和日誌資料夾並為其授予 Web 伺服器使用者讀取/寫入權限：

 cd /var/www/gitlist
mkdir -p var/cache
chmod 777 var/cache
mkdir -p var/log
chmod 777 var/log

• 將您的網頁伺服器指向/var/www/gitlist/public資料夾，其中包含index.php 。

就這樣，安裝完成！如果您遇到問題，請查看故障排除頁面。

發展

GitList 附帶了用於開發目的的 Docker Compose 配置。它包含具有所有必要擴充功能的 PHP 映像，以及前端資產的 Node 映像。

首先，只需克隆存儲庫並運行設定腳本：

git clone https://github.com/klaussilveira/gitlist.git
make setup

它應該負責讓您知道缺少什麼（如果有的話）。完成後，運行測試套件以確保一切正常：

make test
make acceptance

還有其他可用指令。要了解更多：

make help 

貢獻

如果您是開發人員，我們需要您的協助。 GitList很小，但我們有很多事情要做。有些開發人員貢獻了新功能，有些則貢獻了錯誤修復。但您也可以致力於重構目前的程式碼庫並改進我們已有的程式碼。這非常重要，我們希望 GitList 成為最先進的應用程序，為此我們需要您的幫助。

• 請注意可能的錯誤、次優程式碼、重複程式碼、過於複雜的表達式和未使用的程式碼
• 透過建立單元和功能測試來提高測試覆蓋率

如果您不是開發人員，您也可以透過協助翻譯 GitList 來做出貢獻。

更多資訊

如果您想了解有關自訂 GitList 的更多信息，請查看 wiki 上的自訂頁面。另外，如果您在使用 GitList 時遇到問題，請檢查故障排除頁面。不要忘記回報問題並建議新功能！ :)

遺產

GitList 誕生於 2012 年 5 月，當時 Composer 還很新鮮，Silex 風靡一時。我們嘗試盡可能長時間地按原樣維護 GitList，但這些年來 PHP 生態系統發生了巨大變化，以至於維護它變得非常耗時。因此， 2.0在 Symfony 6 之上誕生，我們將與時俱進。

然而，舊版仍然可以在這裡使用，我們將盡力確保它的安全並在較新的 PHP 版本上工作。