跳到内容

克劳西尔维拉/吉特利斯特

存储库文件导航

GitList:一个优雅的git存储库查看器

生成状态 GitHub发布 许可证 克劳丁

GitList是一个优雅而现代的web界面,用于与多个git存储库交互。它允许您使用喜爱的浏览器浏览存储库,查看不同版本下的文件、提交历史记录、差异。它还为每个存储库生成RSS/Atom提要,允许您随时随地了解最新更改。GitList是用PHP编写的,位于Symfony公司框架并由Twig模板引擎提供支持。这意味着GitList易于安装和自定义。此外,GitList接口之所以可能是因为引导数据库.

特征

  • 多存储库支持
  • 多分支支持
  • 多标签支持
  • 承担历史、责任、差异
  • RSS/Atom提要
  • 通过CodeMirror或Ace突出显示语法
  • 存储库统计

屏幕截图

要求

为了在服务器上运行GitList,您需要:

  • 8.1比索
  • 吉特2
  • Web服务器(Apache、nginx)

安装

  • 下载最新版本每日构建然后减压/var/www/gitlist文件夹,或您想放置GitList的任何其他位置。
    • 不要使用源版本,也不要从GitHub下载分支或标记。它不适合最终用户,只适合开发。
  • 打开配置/config.yml并配置您的安装。您必须提供存储库的位置。
    • 或者,您可以导出环境变量默认_代理_DIR包含存储库的目录
  • 创建缓存和日志文件夹,并为您的web服务器用户授予其读/写权限:
光盘/var/www/gitlistmkdir-p变量/缓存chmod 777变量/缓存mkdir-p变量/日志chmod 777变量/日志
  • 将Web服务器指向/var/www/gitlist/public文件夹,其中索引.php是。

就这样,安装完成!如果您有问题,请检查故障排除第页。

开发

GitList附带用于开发目的的Docker Compose配置。它包含一个带有所有必要扩展的PHP图像,以及一个用于前端资产的节点图像。

要开始,只需克隆repo并运行安装脚本:

git克隆https://github.com/klaussilveira/gitlist.git进行设置

它应该注意让你知道缺少了什么,如果有的话。完成后,运行测试套件以确保一切正常:

制作测试作出承兑

还有其他可用命令。要了解更多信息:

制作帮助

贡献

如果您是开发人员,我们需要您的帮助。GitList很小,但我们有很多事情要做。一些开发人员正在提供新功能,其他人则在修复错误。但您也可以致力于重构当前的代码库并改进我们已有的代码。这非常重要,我们希望GitList成为最先进的应用程序,我们需要您的帮助。

  • 继续关注可能的错误、次优代码、重复代码、过于复杂的表达式和未使用的代码
  • 通过创建单元测试和功能测试来提高测试覆盖率

如果你不是开发人员,你也可以通过帮助翻译GitList.

更多信息

如果您想了解有关自定义GitList的更多信息,请检查自定义页面。此外,如果您的GitList有问题,请检查故障排除第页。不要忘记报告问题并建议新功能!:)

遗产

GitList诞生于2012年5月当时,作曲家仍然是一个新奇的人,而Silex则风靡一时。我们已经尝试尽可能长时间地维护GitList as-is,但PHP生态系统在这些年中发生了很大的变化,以至于无法维护它。因此,2出生于Symfony 6之上,我们将与时俱进。

然而,遗产仍然存在此处可用我们将努力确保它的安全性,并开发更新的PHP版本。