gitlist

GitList: un elegante visor de repositorios de git

GitList es una interfaz web elegante y moderna para interactuar con múltiples repositorios de git. Le permite explorar repositorios utilizando su navegador favorito, ver archivos con diferentes revisiones, historial de confirmaciones y diferencias. También genera canales RSS/Atom para cada repositorio, lo que le permite mantenerse actualizado con los últimos cambios en cualquier momento y lugar. GitList fue escrito en PHP, sobre el marco Symfony y impulsado por el motor de plantillas Twig. Esto significa que GitList es fácil de instalar y personalizar. Además, la interfaz GitList fue posible gracias a Bootstrap.

Características

• Soporte de múltiples repositorios
• Soporte para múltiples sucursales
• Soporte para múltiples etiquetas
• Cometer historia, culpa, diferencia
• Canales RSS/Atom
• Resaltado de sintaxis mediante CodeMirror o Ace
• Estadísticas del repositorio

Capturas de pantalla

Requisitos

Para ejecutar GitList en su servidor, necesitará:

• PHP 8.1
• git 2
• Servidor web (Apache, nginx)

Instalación

• Descargue la última versión o la compilación nocturna y descomprímala en su carpeta /var/www/gitlist , o en cualquier otro lugar donde desee colocar GitList.
  • No utilice la versión fuente ni descargue una rama o etiqueta de GitHub. No es adecuado para usuarios finales, sólo para desarrollo.
• Abra config/config.yml y configure su instalación. Tendrás que proporcionar dónde están ubicados tus repositorios.
  • Alternativamente, puede exportar la variable de entorno DEFAULT_REPOSITORY_DIR con el directorio que contiene sus repositorios.
• Cree la carpeta de caché y registro y otorgue permisos de lectura/escritura al usuario de su servidor web:

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

• Apunte su servidor web a la carpeta /var/www/gitlist/public , donde está index.php .

¡Eso es todo, instalación completa! Si tiene problemas, consulte la página Solución de problemas.

Desarrollo

GitList viene con una configuración de Docker Compose destinada a fines de desarrollo. Contiene una imagen PHP con todas las extensiones necesarias, así como una imagen de Nodo para los activos del frontend.

Para comenzar, simplemente clona el repositorio y ejecuta el script de configuración:

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

Debería encargarse de informarle qué falta, en todo caso. Una vez terminado, ejecute el conjunto de pruebas para asegurarse de que todo esté en orden:

make test
make acceptance

Hay otros comandos disponibles. Para saber más:

make help 

Contribuyendo

Si eres desarrollador, necesitamos tu ayuda. GitList es pequeño, pero tenemos muchas cosas que hacer. Algunos desarrolladores contribuyen con nuevas funciones, otros con correcciones de errores. Pero también puedes dedicarte a refactorizar el código base actual y mejorar lo que ya tenemos. Esto es muy importante, queremos que GitList sea una aplicación de última generación y necesitamos tu ayuda para eso.

• Manténgase atento a posibles errores, código subóptimo, código duplicado, expresiones demasiado complicadas y código no utilizado
• Mejorar la cobertura de las pruebas mediante la creación de pruebas unitarias y funcionales.

Si no eres desarrollador, también puedes contribuir ayudando a traducir GitList.

Más información

Si desea obtener más información sobre cómo personalizar GitList, consulte la página de Personalización en la wiki. Además, si tiene problemas con GitList, consulte la página de Solución de problemas. ¡No olvide informar problemas y sugerir nuevas funciones! :)

Legado

GitList nació en mayo de 2012, una época en la que Composer todavía era una novedad y Silex estaba de moda. Hemos intentado mantener GitList tal como está durante el mayor tiempo posible, pero el ecosistema PHP cambió tanto en todos esos años que su mantenimiento llevó demasiado tiempo. Por lo tanto, 2.0 nació sobre Symfony 6 y seguiremos avanzando con los tiempos.

Legacy, sin embargo, todavía está disponible aquí e intentaremos mantenerlo seguro y funcionando en versiones más nuevas de PHP.