為本地存儲庫安裝Gitlist

雖然GitHub是代碼協作和版本庫管理的優秀方案，但一些個人和公司出於安全考慮，更傾向於在內網維護代碼。在本地內網提供倉庫訪問權限很容易，但要有一個友好的界面來與這些倉庫交互，簡化團隊協作，就沒那麼簡單了。 Git自帶一個web界面gitweb，但它不夠優雅和現代化，難以查看變更內容、作者和時間，瀏覽工作區也比較繁瑣。其他一些解決方案安裝困難或界面不夠友好。最近我發現了GitList，一個免費開源的Git倉庫查看器。它的界面與GitHub非常相似，但更注重簡潔明了。本文將指導您設置自己的Git倉庫查看器。別擔心，這很簡單，比安裝WordPress還快！

環境準備

本指南假設您使用的是基於Debian的Linux發行版，但GitList可在任何系統上運行。您需要：

• Apache服務器（啟用mod_rewrite）或Nginx
• Git
• PHP 5.3或更高版本

如果尚未安裝，請在終端運行：

<code class="language-bash">sudo apt-get update
sudo apt-get install php5 apache2 git</code>

我還假設您的環境如下：

• Git倉庫路徑：/home/bob/code
• Apache文檔根目錄：/var/www
• Git可執行文件路徑：/usr/bin/git
• Apache根URL：http://localhost

Apache用戶將訪問您的Git倉庫，因此需要設置正確的訪問權限：

<code class="language-bash">sudo chmod -R 744 /home/bob/code</code>

安裝和配置GitList

首先，下載GitList。您可以選擇最新穩定版或主版本，但請注意，主版本可能存在bug，因為開發者仍在積極開發中。選擇好軟件包後，將其解壓到Apache文檔根目錄下的gitlist文件夾中。

接下來配置GitList！將config.ini-example文件重命名為config.ini，用文本編輯器打開並確保其內容如下：

<code class="language-ini">[git]
client = '/usr/bin/git' ; Git可执行文件路径
repositories = '/home/bob/code/' ; 仓库路径

; 可以隐藏GitList中的仓库，为每个要隐藏的仓库复制此行
; hidden[] = '/home/bob/code/SecretProject'

[app]
baseurl = 'http://localhost/gitlist' ; 应用的基准URL

; 如果需要为特定扩展名指定自定义文件类型，请在此处进行设置
[filetypes]
; extension = type
; dist = xml</code>

最後一步：在/var/www/gitlist目錄下創建一個名為cache的文件夾，並賦予其正確的權限：

<code class="language-bash">cd /var/www/gitlist
mkdir cache
chmod 777 cache</code>

現在訪問http://localhost/gitlist進行檢查。

幫助！頁面未找到！

GitList使用Apache的mod_rewrite模塊創建友好的URL。如果頁面未找到，請確保Apache已啟用mod_rewrite：

<code class="language-bash">sudo a2enmod rewrite</code>

還要確保Apache能夠讀取GitList目錄下的.htaccess文件。 .htaccess文件用於覆蓋和添加Apache目錄的新規則。打開您的默認Apache網站配置文件（通常位於/etc/apache2/sites-enabled/000-default），查找以下內容：

<code class="language-xml"><directory></directory>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride None
    Order allow,deny
    allow from all</code>

將AllowOverride選項從None更改為All。保存更改並重啟Apache：

<code class="language-bash">sudo apt-get update
sudo apt-get install php5 apache2 git</code>

自定義

GitList界面使用Twitter Bootstrap和LESS構建。 LESS文件位於web/less目錄下。提供了一個Makefile，因此您只需根據自己的喜好自定義LESS文件，在web目錄下運行make，即可生成最終的CSS文件。當然，您需要安裝lessc，這可以通過運行npm install less輕鬆完成。 GitList由Twig模板引擎驅動，所有模板都位於views目錄下。為了更好地理解其工作原理，建議您閱讀相關的Twig教程。修改.twig文件後，請務必清除cache文件夾的內容！

(圖片來自Fotolia)

(以下為FAQ部分，已根據原文內容進行調整和精簡，避免重複)

常見問題 (FAQ)

• GitList的安裝前提條件是什麼？ 需要PHP 5.3.3或更高版本、Git和Composer。

• 如何克隆GitList倉庫？ 運行git clone https://github.com/klaussilveira/gitlist.git。

• 如何配置GitList？ 編輯config.ini文件，配置倉庫路徑、Git客戶端等。

• 如何使用Composer安裝依賴項？ 運行composer install。

• 如何設置.htaccess文件？ 確保Apache啟用mod_rewrite，並設置AllowOverride為All。

• 安裝後如何訪問GitList？ 訪問您的GitList目錄的URL，例如http://localhost/gitlist。

• 除了Apache，GitList還能與其他服務器一起使用嗎？ 可以，例如Nginx或IIS，但配置可能不同。

• 如何更新GitList？ 運行git pull和composer install。

• 可以自定義GitList的外觀嗎？ 可以修改public目錄下的CSS文件，但更新GitList時可能會被覆蓋。

• 如果安裝過程中遇到問題怎麼辦？ 檢查錯誤信息，參考GitHub上的GitList問題或尋求幫助。

以上是為本地存儲庫安裝Gitlist的詳細內容。更多資訊請關注PHP中文網其他相關文章！