gitlist

GitList: ein eleganter Git-Repository-Viewer

GitList ist eine elegante und moderne Weboberfläche für die Interaktion mit mehreren Git-Repositories. Es ermöglicht Ihnen, Repositorys mit Ihrem bevorzugten Browser zu durchsuchen, Dateien unter verschiedenen Revisionen anzuzeigen, den Commit-Verlauf und Unterschiede anzuzeigen. Es generiert außerdem RSS/Atom-Feeds für jedes Repository, sodass Sie jederzeit und überall über die neuesten Änderungen auf dem Laufenden bleiben. GitList wurde in PHP geschrieben, basiert auf dem Symfony-Framework und wird von der Twig-Template-Engine unterstützt. Das bedeutet, dass GitList einfach zu installieren und anzupassen ist. Außerdem wurde die GitList-Schnittstelle durch Bootstrap ermöglicht.

Merkmale

• Unterstützung mehrerer Repositorys
• Unterstützung mehrerer Zweigstellen
• Unterstützung mehrerer Tags
• Commit-Geschichte, Schuld, Diff
• RSS/Atom-Feeds
• Syntaxhervorhebung über CodeMirror oder Ace
• Repository-Statistiken

Screenshots

Anforderungen

Um GitList auf Ihrem Server auszuführen, benötigen Sie:

• PHP 8.1
• Git 2
• Webserver (Apache, Nginx)

Installation

• Laden Sie die neueste Version oder den Nightly Build herunter und dekomprimieren Sie sie in Ihren Ordner /var/www/gitlist oder an einen anderen Ort, an dem Sie GitList ablegen möchten.
  • Verwenden Sie nicht die Quellversion und laden Sie keinen Branch oder Tag von GitHub herunter. Es ist nicht für Endbenutzer geeignet, sondern nur für die Entwicklung.
• Öffnen Sie config/config.yml und konfigurieren Sie Ihre Installation. Sie müssen angeben, wo sich Ihre Repositorys befinden.
  • Alternativ können Sie die Umgebungsvariable DEFAULT_REPOSITORY_DIR mit dem Verzeichnis exportieren, das Ihre Repositorys enthält
• Erstellen Sie den Cache- und Protokollordner und erteilen Sie Ihrem Webserver-Benutzer Lese-/Schreibberechtigungen:

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

• Richten Sie Ihren Webserver auf den Ordner /var/www/gitlist/public , in dem sich index.php befindet.

Das ist alles, die Installation ist abgeschlossen! Wenn Sie Probleme haben, schauen Sie auf der Seite „Fehlerbehebung“ nach.

Entwicklung

GitList wird mit einer Docker Compose-Konfiguration geliefert, die für Entwicklungszwecke gedacht ist. Es enthält ein PHP-Image mit allen notwendigen Erweiterungen sowie ein Node-Image für Frontend-Assets.

Um zu beginnen, klonen Sie einfach das Repo und führen Sie das Setup-Skript aus:

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

Es sollte dafür sorgen, dass Sie wissen, was gegebenenfalls fehlt. Wenn Sie fertig sind, führen Sie die Testsuite aus, um sicherzustellen, dass alles in Ordnung ist:

make test
make acceptance

Es stehen weitere Befehle zur Verfügung. Um mehr zu erfahren:

make help 

Mitwirken

Wenn Sie Entwickler sind, brauchen wir Ihre Hilfe. GitList ist klein, aber wir haben viel zu tun. Einige Entwickler tragen mit neuen Funktionen bei, andere mit Fehlerbehebungen. Sie können sich aber auch der Überarbeitung der aktuellen Codebasis und der Verbesserung dessen widmen, was wir bereits haben. Das ist sehr wichtig, wir möchten, dass GitList eine hochmoderne Anwendung ist, und dafür brauchen wir Ihre Hilfe.

• Bleiben Sie auf dem Laufenden über mögliche Fehler, suboptimalen Code, doppelten Code, überkomplizierte Ausdrücke und nicht verwendeten Code
• Verbessern Sie die Testabdeckung durch die Erstellung von Unit- und Funktionstests

Wenn Sie kein Entwickler sind, können Sie auch einen Beitrag leisten, indem Sie bei der Übersetzung von GitList helfen.

Weitere Informationen

Wenn Sie mehr über das Anpassen von GitList erfahren möchten, schauen Sie sich die Seite „Anpassung“ im Wiki an. Wenn Sie Probleme mit GitList haben, sehen Sie sich außerdem die Seite zur Fehlerbehebung an. Vergessen Sie nicht, Probleme zu melden und neue Funktionen vorzuschlagen! :) :)

Vermächtnis

GitList wurde im Mai 2012 geboren, zu einer Zeit, als Composer noch ein Novum und Silex der letzte Schrei war. Wir haben versucht, GitList so lange wie möglich unverändert beizubehalten, aber das PHP-Ökosystem hat sich in all den Jahren so stark verändert, dass es zu zeitaufwändig wurde, es zu pflegen. So wurde 2.0 auf Symfony 6 geboren und wir werden mit der Zeit gehen.

Legacy ist hier jedoch weiterhin verfügbar und wir werden versuchen, es sicher zu halten und auf neueren PHP-Versionen zu funktionieren.