gitlist

GitList: penampil repositori git yang elegan

GitList adalah antarmuka web yang elegan dan modern untuk berinteraksi dengan banyak repositori git. Ini memungkinkan Anda menelusuri repositori menggunakan browser favorit Anda, melihat file dalam revisi berbeda, melakukan riwayat, diff. Ini juga menghasilkan umpan RSS/Atom untuk setiap repositori, memungkinkan Anda tetap mengetahui perubahan terbaru kapan saja, di mana saja. GitList ditulis dalam PHP, di atas kerangka Symfony dan didukung oleh mesin templat Twig. Artinya GitList mudah dipasang dan disesuaikan. Selain itu, antarmuka GitList dimungkinkan karena Bootstrap.

Fitur

• Dukungan beberapa repositori
• Dukungan banyak cabang
• Dukungan beberapa tag
• Melakukan sejarah, menyalahkan, berbeda
• Umpan RSS/Atom
• Penyorotan sintaks melalui CodeMirror atau Ace
• Statistik repositori

Tangkapan layar

Persyaratan

Untuk menjalankan GitList di server Anda, Anda memerlukan:

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

Instalasi

• Unduh rilis terbaru atau nightly build dan dekompresi ke folder /var/www/gitlist Anda, atau di mana pun Anda ingin menempatkan GitList.
  • Jangan gunakan rilis sumber, atau unduh cabang atau tag dari GitHub. Ini tidak cocok untuk pengguna akhir, hanya pengembangan.
• Buka config/config.yml dan konfigurasikan instalasi Anda. Anda harus memberikan lokasi repositori Anda.
  • Alternatifnya, Anda dapat mengekspor variabel lingkungan DEFAULT_REPOSITORY_DIR dengan direktori yang berisi repositori Anda
• Buat folder cache dan log dan berikan izin baca/tulis kepada pengguna server web Anda:

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

• Arahkan server web Anda ke folder /var/www/gitlist/public , di mana index.php berada.

Selesai, instalasi selesai! Jika Anda mengalami masalah, periksa halaman Pemecahan Masalah.

Perkembangan

GitList hadir dengan konfigurasi Docker Compose yang ditujukan untuk tujuan pengembangan. Ini berisi gambar PHP dengan semua ekstensi yang diperlukan, serta gambar Node untuk aset frontend.

Untuk memulai, cukup kloning repo dan jalankan skrip pengaturan:

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

Ini harus memberi tahu Anda apa yang hilang, jika ada. Setelah selesai, jalankan test suite untuk memastikan semuanya beres:

make test
make acceptance

Ada perintah lain yang tersedia. Untuk mempelajari lebih lanjut:

make help 

Berkontribusi

Jika Anda seorang pengembang, kami membutuhkan bantuan Anda. GitList kecil, tapi ada banyak hal yang harus kami lakukan. Beberapa pengembang berkontribusi dengan fitur-fitur baru, yang lain dengan perbaikan bug. Namun Anda juga dapat mendedikasikan diri Anda untuk memfaktorkan ulang basis kode saat ini dan meningkatkan apa yang sudah kami miliki. Ini sangat penting, kami ingin GitList menjadi aplikasi tercanggih, dan kami memerlukan bantuan Anda untuk itu.

• Pantau terus kemungkinan bug, kode suboptimal, kode duplikat, ekspresi yang terlalu rumit, dan kode yang tidak digunakan
• Tingkatkan cakupan pengujian dengan membuat pengujian unit dan fungsional

Jika Anda bukan seorang pengembang, Anda juga dapat berkontribusi dengan membantu menerjemahkan GitList.

Informasi lebih lanjut

Jika Anda ingin tahu lebih banyak tentang penyesuaian GitList, periksa halaman Penyesuaian di wiki. Selain itu, jika Anda mengalami masalah dengan GitList, periksa halaman Pemecahan Masalah. Jangan lupa untuk melaporkan masalah dan menyarankan fitur baru! :)

Warisan

GitList lahir pada bulan Mei 2012, saat Komposer masih merupakan hal baru dan Silex sedang populer. Kami telah mencoba mempertahankan GitList apa adanya selama mungkin, namun ekosistem PHP banyak berubah selama bertahun-tahun sehingga menjadi terlalu memakan waktu untuk memeliharanya. Oleh karena itu, 2.0 lahir di atas Symfony 6 dan kami akan terus mengikuti perkembangan zaman.

Namun, warisan masih tersedia di sini dan kami akan mencoba menjaganya tetap aman dan bekerja pada versi PHP yang lebih baru.