gitlist

GitList : un visualiseur de référentiel git élégant

GitList est une interface Web élégante et moderne permettant d'interagir avec plusieurs référentiels git. Il vous permet de parcourir les référentiels à l'aide de votre navigateur préféré, d'afficher les fichiers sous différentes révisions, l'historique des validations et les différences. Il génère également des flux RSS/Atom pour chaque référentiel, vous permettant de rester au courant des dernières modifications à tout moment et en tout lieu. GitList a été écrit en PHP, au-dessus du framework Symfony et alimenté par le moteur de modèles Twig. Cela signifie que GitList est facile à installer et à personnaliser. De plus, l'interface GitList a été rendue possible grâce à Bootstrap.

Caractéristiques

• Prise en charge de plusieurs référentiels
• Prise en charge de plusieurs succursales
• Prise en charge de plusieurs balises
• Commettre l'histoire, blâmer, diff
• Flux RSS/Atom
• Mise en évidence de la syntaxe via CodeMirror ou Ace
• Statistiques du référentiel

Captures d'écran

Exigences

Pour exécuter GitList sur votre serveur, vous aurez besoin de :

• PHP8.1
• git2
• Serveur Web (Apache, nginx)

Installation

• Téléchargez la dernière version ou la version nocturne et décompressez-la dans votre dossier /var/www/gitlist , ou partout où vous souhaitez placer GitList.
  • N'utilisez pas la version source et ne téléchargez pas de branche ou de balise depuis GitHub. Il ne convient pas aux utilisateurs finaux, mais uniquement au développement.
• Ouvrez le config/config.yml et configurez votre installation. Vous devrez indiquer où se trouvent vos référentiels.
  • Alternativement, vous pouvez exporter la variable d'environnement DEFAULT_REPOSITORY_DIR avec le répertoire contenant vos référentiels
• Créez le dossier de cache et de journal et accordez-lui des autorisations de lecture/écriture à l'utilisateur de votre serveur Web :

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

• Pointez votre serveur Web vers le dossier /var/www/gitlist/public , où se trouve index.php .

Ça y est, installation terminée ! Si vous rencontrez des problèmes, consultez la page Dépannage.

Développement

GitList est livré avec une configuration Docker Compose destinée à des fins de développement. Il contient une image PHP avec toutes les extensions nécessaires, ainsi qu'une image Node pour les actifs frontend.

Pour commencer, clonez simplement le dépôt et exécutez le script de configuration :

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

Il devrait prendre soin de vous faire savoir ce qui manque, le cas échéant. Une fois terminé, exécutez la suite de tests pour vous assurer que tout est en ordre :

make test
make acceptance

Il existe d'autres commandes disponibles. Pour en savoir plus :

make help 

Contribuer

Si vous êtes développeur, nous avons besoin de votre aide. GitList est petite, mais nous avons beaucoup de choses à faire. Certains développeurs contribuent avec de nouvelles fonctionnalités, d'autres avec des corrections de bugs. Mais vous pouvez également vous consacrer à refactoriser la base de code actuelle et à améliorer ce que nous avons déjà. C'est très important, nous voulons que GitList soit une application à la pointe de la technologie, et nous avons besoin de votre aide pour cela.

• Restez à l'écoute des bogues possibles, du code sous-optimal, du code dupliqué, des expressions trop compliquées et du code inutilisé
• Améliorer la couverture des tests en créant des tests unitaires et fonctionnels

Si vous n'êtes pas développeur, vous pouvez également contribuer en aidant à traduire GitList.

Informations complémentaires

Si vous souhaitez en savoir plus sur la personnalisation de GitList, consultez la page Personnalisation sur le wiki. De plus, si vous rencontrez des problèmes avec GitList, consultez la page Dépannage. N'oubliez pas de signaler les problèmes et de suggérer de nouvelles fonctionnalités ! :)

Héritage

GitList est né en mai 2012, à une époque où Composer était encore une nouveauté et Silex faisait fureur. Nous avons essayé de maintenir GitList telle quelle le plus longtemps possible, mais l'écosystème PHP a tellement changé au cours de toutes ces années qu'il est devenu trop long de le maintenir. Ainsi, 2.0 est née au-dessus de Symfony 6 et nous continuerons à évoluer avec notre temps.

Legacy, cependant, est toujours disponible ici et nous essaierons de le garder sécurisé et de travailler sur des versions PHP plus récentes.