Ginatra est un simple navigateur de référentiel GIT basé sur le Web construit sur Ruby Sinatra.
[Site Web | Captures d'écran | démo]
Il existe 2 façons d'installer Ginatra: en tant que bijou Ruby emballé ou en tant qu'application Sinatra.
Il est recommandé de l'installer comme un joyau de rubis, à moins que vous ne sachiez ce que vous faites.
Exécutez la commande suivante pour installer Ginatra de RubyGems:
gem install ginatra -v 4.1.0Créer un fichier de configuration (voir la section Configuration dans Readme).
Démarrez le serveur Ginatra:
ginatra run Par défaut, Ginatra fonctionnera sur localhost:9797
Exécutez les commandes suivantes pour installer Ginatra à partir de la source:
git clone git://github.com/NARKOZ/ginatra.git
cd ginatra/
git checkout v4.1.0
bundleCréer un fichier config ou modifier la section de configuration (voir la section de configuration dans Readme).
Démarrez le serveur Ginatra:
./bin/ginatra run Par défaut, Ginatra fonctionnera sur localhost:9797
Créez un fichier ~/.ginatra/config.yml avec vos propres paramètres. Voir config.yml pour une référence.
git_dirs - Ginatra examinera ces dossiers pour les référentiels GIT. Il est nécessaire d'ajouter * à la fin du chemin. Exemple: /home/Development/repos/*
sitename - Nom du site. Utilisé dans le titre et l'en-tête de la page.
description - Description de l'interface Web. Utilisé dans la page d'index.
port - Port auquel le serveur Ginatra s'exécutera.
host - Hôte que le serveur Ginatra s'exécutera.
prefix - Préfixe pour l'hôte servant Ginatra. Utilisé lorsque Ginatra est installé dans le sous-répertoire.
git_clone_enabled? - Active la prise en charge SMART HTTP et permet de cloner les référentiels GIT.
log_file - Emplacement du fichier journal où Ginatra enregistrera les avertissements et les erreurs. Si ce paramètre ne présente pas Ginatra se connectera à la sortie standard (STDOUT).
Si vous avez installé Ginatra en tant qu'application, vous pouvez modifier les paramètres en modifiant le fichier config.yml dans le dossier racine.
Vous devez redémarrer le serveur Web après avoir appliqué des modifications au fichier de configuration.
Vous pouvez interagir avec Ginatra via CLI. Les commandes suivantes sont disponibles:
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 Les problèmes ouverts sont étiquetés par difficulté perçue. Voir les directives contributives.