Ginatra adalah browser repositori git berbasis web sederhana yang dibangun di atas Ruby Sinatra.
[Situs web | screenshot | demo]
Ada 2 cara untuk menginstal ginatra: sebagai permata ruby yang dikemas atau sebagai aplikasi Sinatra.
Disarankan untuk menginstalnya sebagai permata ruby, kecuali Anda tahu apa yang Anda lakukan.
Jalankan perintah berikut untuk menginstal ginatra dari rubygems:
gem install ginatra -v 4.1.0Buat file konfigurasi (lihat bagian Konfigurasi di ReadMe).
Mulai server ginatra:
ginatra run Secara default ginatra akan berjalan di localhost:9797
Jalankan perintah berikut untuk menginstal ginatra dari sumber:
git clone git://github.com/NARKOZ/ginatra.git
cd ginatra/
git checkout v4.1.0
bundleBuat file konfigurasi atau ubah yang ada (lihat bagian Konfigurasi di ReadMe).
Mulai server ginatra:
./bin/ginatra run Secara default ginatra akan berjalan di localhost:9797
Buat file ~/.ginatra/config.yml dengan pengaturan Anda sendiri. Lihat config.yml untuk referensi.
git_dirs - ginatra akan melihat ke folder ini untuk repositori git. Diperlukan untuk menambahkan * di ujung jalan. Contoh: /home/Development/repos/*
sitename - Nama Situs. Digunakan dalam judul dan header halaman.
description - Deskripsi Antarmuka Web. Digunakan di halaman indeks.
port - Port yang akan dijalankan server ginatra.
host - Host yang akan dijalankan oleh server Ginatra.
prefix - awalan untuk host yang melayani ginatra. Digunakan saat ginatra dipasang di subdirektori.
git_clone_enabled? - Mengaktifkan dukungan HTTP pintar dan memungkinkan untuk mengkloning repositori git.
log_file - Lokasi file log di mana ginatra akan mencatat peringatan dan kesalahan. Jika pengaturan ini tidak menyajikan ginatra akan keluar ke output standar (stdout).
Jika Anda menginstal ginatra sebagai aplikasi, Anda dapat mengubah pengaturan dengan mengedit file config.yml di folder root.
Anda perlu me -restart server web setelah menerapkan perubahan pada file config.
Anda dapat berinteraksi dengan ginatra melalui CLI. Perintah berikut tersedia:
ginatra run # Starts Ginatra server
ginatra stop # Stops Ginatra server
ginatra status # Checks status of the Ginatra server (running or not)
ginatra -v # Shows version of Ginatra
ginatra -h # Lists available commands and their options Masalah terbuka diberi label per kesulitan yang dirasakan. Lihat Pedoman yang Berkontribusi.