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 版本上工作。