为本地存储库安装Gitlist

虽然GitHub是代码协作和版本库管理的优秀方案，但一些个人和公司出于安全考虑，更倾向于在内网维护代码。在本地内网提供仓库访问权限很容易，但要有一个友好的界面来与这些仓库交互，简化团队协作，就没那么简单了。Git自带一个web界面gitweb，但它不够优雅和现代化，难以查看变更内容、作者和时间，浏览工作区也比较繁琐。其他一些解决方案安装困难或界面不够友好。最近我发现了GitList，一个免费开源的Git仓库查看器。它的界面与GitHub非常相似，但更注重简洁明了。本文将指导您设置自己的Git仓库查看器。别担心，这很简单，比安装WordPress还快！

环境准备

本指南假设您使用的是基于Debian的Linux发行版，但GitList可在任何系统上运行。您需要：

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

如果尚未安装，请在终端运行：

sudo apt-get update
sudo apt-get install php5 apache2 git

我还假设您的环境如下：

• Git仓库路径：/home/bob/code
• Apache文档根目录：/var/www
• Git可执行文件路径：/usr/bin/git
• Apache根URL：http://localhost

Apache用户将访问您的Git仓库，因此需要设置正确的访问权限：

sudo chmod -R 744 /home/bob/code

安装和配置GitList

首先，下载GitList。您可以选择最新稳定版或主版本，但请注意，主版本可能存在bug，因为开发者仍在积极开发中。选择好软件包后，将其解压到Apache文档根目录下的gitlist文件夹中。

接下来配置GitList！将config.ini-example文件重命名为config.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

最后一步：在/var/www/gitlist目录下创建一个名为cache的文件夹，并赋予其正确的权限：

cd /var/www/gitlist
mkdir cache
chmod 777 cache

现在访问http://localhost/gitlist进行检查。

帮助！页面未找到！

GitList使用Apache的mod_rewrite模块创建友好的URL。如果页面未找到，请确保Apache已启用mod_rewrite：

sudo a2enmod rewrite

还要确保Apache能够读取GitList目录下的.htaccess文件。.htaccess文件用于覆盖和添加Apache目录的新规则。打开您的默认Apache网站配置文件（通常位于/etc/apache2/sites-enabled/000-default），查找以下内容：

<Directory></Directory>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride None
    Order allow,deny
    allow from all

将AllowOverride选项从None更改为All。保存更改并重启Apache：

sudo apt-get update
sudo apt-get install php5 apache2 git

自定义

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中文网其他相关文章！