ginatra

Ginatra

Ginatra é um navegador de repositório Git simples baseado na Web construído sobre Ruby Sinatra.

[Site | Capturas de tela | demonstração]

Características

• Instalação fácil
• Suporte de repositório múltiplo
• Múltipla ramificação/suporte da tag
• Comprometar história, diff, patch
• Feeds em formato de átomo
• Destaque da sintaxe
• Estatísticas do repositório
• Suporte Smart HTTP
• e mais

Instalação

Existem 2 maneiras de instalar o Ginatra: como uma gema rubi embalada ou como um aplicativo Sinatra.
É recomendável instalá -lo como uma jóia Ruby, a menos que você saiba o que está fazendo.

Ginatra Gem

Execute o seguinte comando para instalar Ginatra a partir de Rubygems:

gem install ginatra -v 4.1.0

Crie arquivo de configuração (consulte a seção Configuração no ReadMe).

Inicie o servidor Ginatra:

ginatra run

Por padrão, Ginatra será executado no localhost:9797

App Ginatra

Execute os seguintes comandos para instalar o Ginatra da fonte:

git clone git://github.com/NARKOZ/ginatra.git
cd ginatra/
git checkout v4.1.0
bundle

Crie arquivo de configuração ou modifique a seção de configuração existente (consulte o ReadMe).

Inicie o servidor Ginatra:

./bin/ginatra run

Por padrão, Ginatra será executado no localhost:9797

Configuração

Crie o arquivo ~/.ginatra/config.yml com suas próprias configurações. Consulte config.yml para obter uma referência.

git_dirs - Ginatra procurará essas pastas para repositórios Git. É necessário anexar * no final do caminho. Exemplo: /home/Development/repos/*

sitename - Nome do site. Usado no título e no cabeçalho da página.

description - Descrição da interface da Web. Usado na página de índice.

port - Porta que o servidor Ginatra será executado.

host - Host que o servidor Ginatra será executado.

prefix - Prefixo para o host que serve Ginatra. Usado quando o ginatra é instalado no subdiretório.

git_clone_enabled? - Ativa o suporte Smart HTTP e permite clonar repositórios Git.

log_file - Localização do arquivo de log em que Ginatra registrará avisos e erros. Se essa configuração não apresentar o Ginatra, logot para a saída padrão (STDOUT).

Se você instalou o Ginatra como um aplicativo, pode alterar as configurações editando o arquivo config.yml na pasta root.

Você precisa reiniciar o servidor da web após aplicar alterações no arquivo de configuração.

CLI

Você pode interagir com Ginatra via CLI. Os seguintes comandos estão disponíveis:

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 

Como contribuir

Questões abertas são rotuladas por dificuldade percebida. Consulte Diretrizes contribuintes.