gitlist

GitList: элегантный просмотрщик git-репозитория.

GitList — это элегантный и современный веб-интерфейс для взаимодействия с несколькими репозиториями git. Он позволяет вам просматривать репозитории с помощью вашего любимого браузера, просматривать файлы разных ревизий, историю коммитов, различия. Он также генерирует каналы RSS/Atom для каждого репозитория, что позволяет вам быть в курсе последних изменений в любое время и в любом месте. GitList был написан на PHP, поверх фреймворка Symfony и на базе шаблонизатора Twig. Это означает, что GitList легко установить и легко настроить. Кроме того, интерфейс GitList стал возможен благодаря Bootstrap.

Функции

• Поддержка нескольких репозиториев
• Поддержка нескольких ветвей
• Поддержка нескольких тегов
• Зафиксировать историю, обвинить, отличить
• RSS/Atom-каналы
• Подсветка синтаксиса с помощью CodeMirror или Ace
• Статистика репозитория

Скриншоты

Требования

Чтобы запустить GitList на вашем сервере, вам понадобится:

• PHP 8.1
• мерзавец 2
• Веб-сервер (Apache, nginx)

Установка

• Загрузите последний выпуск или ночную сборку и распакуйте его в папку /var/www/gitlist или в любое другое место, где вы хотите разместить GitList.
  • Не используйте исходный код и не загружайте ветку или тег с GitHub. Он не подходит для конечных пользователей, только для разработки.
• Откройте config/config.yml и настройте свою установку. Вам нужно будет указать, где расположены ваши репозитории.
  • Альтернативно вы можете экспортировать переменную среды DEFAULT_REPOSITORY_DIR с каталогом, содержащим ваши репозитории.
• Создайте папку кеша и журнала и предоставьте ей права на чтение/запись пользователю вашего веб-сервера:

 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 со всеми необходимыми расширениями, а также образ узла для ресурсов внешнего интерфейса.

Для начала просто клонируйте репозиторий и запустите скрипт установки:

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

Он должен позаботиться о том, чтобы сообщить вам, чего не хватает, если вообще чего-то не хватает. После завершения запустите набор тестов, чтобы убедиться, что все в порядке:

make test
make acceptance

Доступны и другие команды. Чтобы узнать больше:

make help 

Содействие

Если вы разработчик, нам нужна ваша помощь. GitList небольшой, но нам есть чем заняться. Некоторые разработчики добавляют новые функции, другие — исправляют ошибки. Но вы также можете посвятить себя рефакторингу текущей кодовой базы и улучшению того, что у нас уже есть. Это очень важно, мы хотим, чтобы GitList был современным приложением, и в этом нам нужна ваша помощь.

• Следите за возможными ошибками, неоптимальным кодом, дублированным кодом, слишком сложными выражениями и неиспользуемым кодом.
• Улучшите тестовое покрытие, создав модульные и функциональные тесты.

Если вы не разработчик, вы также можете внести свой вклад, помогая переводить GitList.

Дополнительная информация

Если вы хотите узнать больше о настройке GitList, посетите страницу настройки в вики. Кроме того, если у вас возникли проблемы с GitList, посетите страницу устранения неполадок. Не забывайте сообщать о проблемах и предлагать новые функции! :)

Наследие

GitList родился в мае 2012 года, когда Composer был еще новинкой, а Silex был в моде. Мы пытались поддерживать GitList в том виде, в котором он есть, как можно дольше, но за все эти годы экосистема PHP настолько изменилась, что ее поддержка стала отнимать слишком много времени. Таким образом, 2.0 родилась на базе Symfony 6, и мы продолжим идти в ногу со временем.

Однако Legacy по-прежнему доступен здесь, и мы постараемся обеспечить его безопасность и работать над новыми версиями PHP.