git-difftool - helper - Online na nuvem

PROGRAMA:

NOME

git-cola - A GUI Git altamente cafeinada

SINOPSE

git cola [opções] [subcomando]

DESCRIÇÃO

git cola é uma GUI Git elegante e poderosa.

OPÇÕES

- alterar
Início git cauda no modo de correção.

--mensagem
Solicita um repositório Git. O padrão é o diretório atual.

-r, --repo
Abra o repositório Git em . O padrão é o diretório atual.

-sim, --filtro de status
Aplique o filtro de caminho ao widget de status.

--versão
Imprima o git cauda versão e sair.

-h, --Socorro
Mostra o uso e os argumentos opcionais.

--help-comandos
Mostra os subcomandos disponíveis.

SUBCOMANDOS

am
Aplique patches.

arquivo
Exportar tarballs do Git.

ramo
Crie ramos.

procurar
Navegue pelos arquivos rastreados.

configuração
Defina as configurações.

dia
Comece o git dia Navegador de histórico do Git.

diff
Diferença de arquivos alterados.

buscar
Buscar histórico de repositórios remotos.

grep
Use git grep para pesquisar conteúdo.

fundir
Mesclar ramos.

puxar
Busque e mescle branches remotos.

empurrar
Empurre ramos para controles remotos.

rebase
Inicie um rebase interativo.

remoto
Crie e edite controles remotos.

search
Procure por commits.

esconder
Stash modificações não confirmadas.

etiqueta
Crie tags.

versão
Imprima o git cauda versão.

CONFIGURAR SUA EDITOR

O editor usado por Ctrl-e é configurado na tela Preferências. O ambiente
variável $ VISUAL é consultado quando nenhum editor foi configurado.

Dica profissional: Configurando seu editor para gwim -f -p irá abrir várias abas ao editar arquivos.
gwim -f -o usa divisões.

git cauda está ciente de {vim, emacs, textpad, notepad ++}. Quando você seleciona uma linha no grep
tela e pressione qualquer um dos Entrar, Ctrl-e, Ou o Editar botão, você é levado exatamente a isso
linha.

A preferência do editor é salva no gui.editor variável usando git configuração.

TECLADO ATALHOS

git cauda tem muitos atalhos de teclado úteis.

Você pode ver os atalhos disponíveis pressionando o ? chave, escolhendo Ajuda -> Teclado
atalhos a partir do menu principal, ou consultando o git cauda teclado atalhos referência.

FERRAMENTAS

A git cauda interface é composta de várias ferramentas de cooperação. Clicar duas vezes em uma ferramenta
abre em sua própria subjanela. Arrastá-lo move e coloca-o dentro da janela.

As ferramentas podem ser ocultadas e reorganizadas como você quiser. git cauda lembra-se cuidadosamente do seu
layout da janela e o restaura na próxima vez que for iniciado.

A Controle- {1, 2, 3, ...} A tecla de atalho dá foco a uma ferramenta específica. Uma ferramenta oculta pode ser
reaberto usando o Ferramentas menu ou o Shift + Control- {1, 2, 3, ...} teclas de atalho.

STATUS

A Status ferramenta fornece um visual analógico para o git estado comando.

Status exibe arquivos que são modificada em relação à área de preparação, encenado para o próximo
comprometer-se, não fundido arquivos de uma mesclagem em andamento e arquivos que são não rastreado para git.

Estas são as mesmas categorias que vemos ao correr git estado na linha de comando.

Você pode navegar pela lista de arquivos usando as setas do teclado, bem como o
ergonômico e semelhante ao vim j e k teclas de atalho.

Existem várias maneiras convenientes de interagir com arquivos no Status ferramenta.

Selecionar um arquivo exibe sua diferença no DIFF visualizador. Clicar duas vezes em um arquivo prepara seu
conteúdo, assim como o Ctrl-s tecla de atalho.

Ctrl-e abre arquivos selecionados no editor configurado, e Ctrl-d abre os arquivos selecionados
utilização git diftool

Ações adicionais podem ser realizadas usando o menu de contexto do botão direito.

Opções
Clicando no Encenado A pasta mostra um diffstat para o índice.

Clicando no Modificado A pasta mostra um diffstat para a árvore de trabalho.

Clicar em arquivos individuais envia diffs para o Dif Ecrã.

Clicar duas vezes em arquivos individuais adiciona e remove seu conteúdo do índice.

Várias ações estão disponíveis por meio do menu de contexto do botão direito. Diferentes ações são
disponível dependendo do status do arquivo.

Etapa Selecionado
Adicione à área de teste usando git adicionar Marca os arquivos não mesclados como resolvidos.

Apresentação livro editor
Inicia o editor de texto visual configurado

Apresentação livro Ferramenta de comparação
Visualize as mudanças usando git diftool.

Reverter Não encenado Edições
Reverte o conteúdo não testado verificando os caminhos selecionados da área de índice / teste

Reverter Não comprometido Edições
Jogue fora edições não confirmadas

Sair do palco Selecionado
Remova da área de índice / preparo com git redefinir

Apresentação livro ir ferramenta
Resolva conflitos usando git fundiretool.

Apagar Arquivos)
Exclua arquivos não rastreados do sistema de arquivos.

Adicionar para .gitignore
Adiciona arquivos não rastreados ao arquivo .gitignore.

DIFF

O visualizador / editor diff exibe diffs para arquivos selecionados. As adições são mostradas em verde
e as remoções são exibidas em vermelho claro. Espaços em branco externos são mostrados com um vermelho puro
fundo.

Clicar com o botão direito no diff fornece acesso a ações adicionais que usam o
localização do cursor ou seleção de texto.

Staging conteúdo para commit
A @@ padrões denotam um novo pedaço de diff. Selecionando linhas de diff e usando o Etapa
Selecionado Linhas comando irá preparar apenas as linhas selecionadas. Clicar em um pedaço diferente
e selecionando Etapa Dif Hunk organiza todo o pedaço de diferença do patch.

Os comandos opostos correspondentes também podem ser executados em arquivos de teste, por exemplo,
o conteúdo pode ser removido seletivamente do índice quando estamos vendo diffs para encenado
conteúdo.

COMPRAR MENSAGEM EDITOR

O editor de mensagens de commit é um widget de texto simples para inserir mensagens de commit.

Você pode navegar entre os Assunto e Alargado Descrição... campos usando o
teclas de seta do teclado.

Pressionando Enter quando estiver dentro do Assunto campo salta para baixo para o campo de descrição estendida.

A Opções menu de botão à esquerda do campo de assunto fornece acesso ao adicional
ações.

A Ctrl + i o atalho de teclado adiciona uma linha padrão "Signed-off-by:" e Ctrl + Enter
cria um novo commit usando a mensagem de commit e o conteúdo preparado.

Placa Off
A Placa Off botão adiciona um padrão:

Assinado por: AU Thor[email protegido]>

linha ao final da mensagem de confirmação.

Invocar esta ação é equivalente a passar o -s opção para git commit.

COMPROMETA-SE
O botão de confirmação é executado git commit. O conteúdo do editor de mensagem de confirmação é fornecido
como a mensagem de confirmação.

Apenas arquivos testados são incluídos no commit - este é o mesmo comportamento da execução git
commit na linha de comando.

Line e Coluna Ecrã
A linha atual e o número da coluna são exibidos pelo editor. Por exemplo, um 5,0 meios de exibição
que o cursor está localizado na linha cinco, coluna zero.

A tela muda de cor quando as linhas ficam muito longas. Amarelo indica o limite seguro
para enviar patches para uma lista de e-mail enquanto mantém espaço para marcadores de resposta embutidos.

Laranja indica que a linha está começando a ficar um pouco longa e deve quebrar em breve.

Vermelho indica que a linha está indo contra o limite padrão de 80 colunas para confirmação
mensagens.

É recomendável manter as mensagens de confirmação com menos de 76 caracteres. git log é um grande
ferramenta, mas longas linhas atrapalham sua formatação para todos os outros, por isso, esteja atento quando
escrever mensagens de confirmação.

Alterar Sobrenome COMPROMETA-SE
Clicando sobre Alterar Sobrenome COMPROMETA-SE faz git cauda alterar o commit anterior em vez de criar
um novo. git cauda carrega a mensagem de confirmação anterior no editor de mensagem de confirmação quando
esta opção é selecionada.

A Status ferramenta irá exibir todas as mudanças para o commit alterado.

Crie Assinado COMPROMETA-SE
Avisar git commit e git fundir para assinar commits usando GPG.

Usar esta opção é equivalente a passar o --gpg-sinal opção para git commit e git
fundir.

O valor padrão desta opção pode ser configurado usando o cola.signcommits • Configuração
variável.

APLICAR REMENDAS

Use o Envie o -> Aplicar Patches item de menu para começar a aplicar patches.

Arrastando e soltando patches no git cauda interface adiciona os patches à lista de
patches para aplicar usando git am.

Você pode arrastar um conjunto de patches ou um diretório contendo patches. Patches podem ser
classificados usando na interface e são aplicados na mesma ordem que está listado na lista.

Quando um diretório é descartado git cauda percorre a árvore de diretórios em busca de patches. git
cauda classifica a lista de patches depois de todos eles terem sido encontrados. Isso permite que você controle
a ordem em que os patches são aplicados, colocando patchsets em ordem alfanumérica
diretórios.

SUPORTE JANELA DEFINIÇÕES

git cauda lembra as modificações no layout e organização das ferramentas dentro do git
cauda interface. As alterações são salvas e restauradas no desligamento / inicialização do aplicativo.

git cauda pode ser configurado para não salvar layouts personalizados, removendo a configuração do Salvar Janela
Configurações opção no git cauda preferências.

CONFIGURAÇÃO VARIÁVEIS

Essas variáveis ​​podem ser definidas usando git configuração ou nas configurações.

cola.blameviewer
O comando usado para culpar arquivos. Padrões para git gui culpa.

cola.navegador acoplável
Se deve criar um widget dock com o Navegador ferramenta. Padrões para falso acelerar
tempo de inicialização.

cola.checkconflitos
Inspecione os arquivos não mesclados em busca de marcadores de conflito antes de prepará-los. Este recurso ajuda
evitar o preparo acidental de conflitos de mesclagem não resolvidos. Padrões para verdadeiro.

cola.defaultrepo
git cauda, quando executado fora de um repositório Git, solicita ao usuário um repositório. Definir
cola.defaultrepo para o caminho de um repostório Git para fazer git cauda tente usar isso
repositório antes de voltar a solicitar ao usuário um repositório.

atributos cola.file
Ativa o suporte à codificação gitattributes por arquivo quando definido como verdadeiro. Isso informa git cauda para
respeitar a codificação configurada ao exibir e aplicar diffs.

cola.fontdiff
Especifica a fonte a ser usada para git caudaexibição de diff de.

cola.inotify
Definir para falso para desativar o monitoramento de alteração do sistema de arquivos. Padrões para verdadeiro, Mas também
requer Linux com suporte para inotify ou Windows com pywin32 instalado para arquivo
monitoramento de alterações do sistema para realmente funcionar.

cola.refreshonfocus
Definir para verdadeiro para atualizar automaticamente quando git cauda ganha foco. Padrões para falso Porque
isso pode causar uma pausa sempre que mudar para git cauda de outro aplicativo.

cola.linebreak
Se deseja quebrar linhas longas automaticamente durante a edição de mensagens de confirmação. Padrões para
verdadeiro. Esta configuração é definida usando o Preferencias caixa de diálogo, mas pode ser alternada para
uso único usando o submenu de opções do editor de mensagem de confirmação.

cola.dragencoding
git cauda codifica caminhos arrastados de seus widgets para UTF-16 ao adicioná-los ao
arrastar e soltar dados MIME (especificamente, o text / x-moz-url entrada). UTF-16 é usado para fazer
terminal gnome veja os caminhos corretos, mas outros terminais podem esperar uma codificação diferente.
Se você estiver usando um terminal que espera uma codificação moderna, por exemplo terminator, então defina isto
valor para UTF-8.

cola.readsize
git cauda evita a leitura de grandes arquivos binários não rastreados. O tamanho máximo para ler é
controlado por cola.readsize e o padrão é 2048.

cola.salvar configurações da janela
git cauda irá lembrar as configurações da janela quando definido para verdadeiro. Configurações de janela e X11
sessões são salvas em $ HOME / .config / git-cola.

cola.signcommits
git cauda assinará commits por padrão quando definido verdadeiro. Padrões para falso. Veja a seção
abaixo sobre como configurar o GPG para obter mais detalhes.

cola.tabwidth
O número de colunas ocupadas por um caractere de tabulação. O padrão é 8.

cola.terminal
O comando a ser usado ao lançar comandos em um terminal gráfico.

cola.terminal o padrão é xterm -e quando não definido. por exemplo, ao abrir uma concha, git cauda precisarão
corrida xterm -e $ SHELL.

Se terminal gnome, terminal xfce4ou console estão instalados, então eles serão
preferido sobre xterm quando cola.terminal não está definido.

cola.textwidth
O número de colunas usadas para quebra de linha. As guias são contadas de acordo com
cola.tabwidth.

cola.color.texto
A cor do texto diff padrão, em notação hexadecimal RRGGBB. O padrão é "030303".

cola.color.add
O diff padrão "adiciona" cor de fundo, em notação hexadecimal RRGGBB. Padrões para
"d2ffe4".

cola.color.remove
O diff padrão "remove" a cor de fundo, em notação hexadecimal RRGGBB. Padrões para
"fee0e4".

cola.color.header
A cor do texto do cabeçalho diff padrão, em notação hexadecimal RRGGBB. O padrão é "bbbbbb".

gui.diffcontext
O número de linhas de contexto diff a serem exibidas.

gui.display não rastreado
git cauda evita mostrar arquivos não rastreados quando definido como falso.

gui.editor
O editor de texto padrão a ser usado é definido em gui.editor. A variável de configuração substitui
a variável de ambiente VISUAL. por exemplo gwim -f -p.

navegador gui.history
O navegador de histórico a ser usado ao visualizar o histórico. Padrões para idiota.

ferramenta de diferença
A ferramenta diff padrão a ser usada.

mesclar.ferramenta
A ferramenta de mesclagem padrão a ser usada.

usuário.e-mail
Seu endereço de e-mail a ser registrado em qualquer commit recém-criado. Pode ser substituído pelo
Variáveis ​​de ambiente 'GIT_AUTHOR_EMAIL', 'GIT_COMMITTER_EMAIL' e 'EMAIL'.

user.name
Seu nome completo deve ser registrado em qualquer commit recém-criado. Pode ser substituído pelo
Variáveis ​​de ambiente 'GIT_AUTHOR_NAME' e 'GIT_COMMITTER_NAME'.

MEIO AMBIENTE VARIÁVEIS

GIT_COLA_SCALE
git cauda pode ser feito para dimensionar sua interface para monitores HiDPI. Quando definido, git cauda
irá dimensionar ícones, caixas de rádio e caixas de seleção de acordo com o fator de escala. O padrão
valor é 1. Um bom valor é 2 para monitores de alta resolução.

As fontes não são escaladas, pois seu tamanho já pode ser definido nas configurações.

GIT_COLA_TRACE
Quando definido, git cauda toras git comandos para stdout. Quando definido para cheio, git cauda também registra
o status de saída e a saída. Quando definido para traçar, git cauda registros para o cônsul ferramenta.

VISUAL
Especifica o editor padrão a ser usado. Isso é ignorado quando o gui.editor • Configuração
variável é definida.

IDIOMA DEFINIÇÕES

git cauda detecta automaticamente o seu idioma e apresenta algumas traduções quando
acessível. Isso pode não ser desejado, ou você pode querer git cauda para usar um idioma específico.

Você pode fazer git cauda usar uma linguagem alternativa criando um
~ / .config / git-cola / idioma arquivo contendo o código padrão de idioma gettext de duas letras,
por exemplo, "en", "de", "ja", "zh" etc .:

mkdir-p ~ / .config / git-cola &&
echo en>~ / .config / git-cola / idioma

Alternativamente, você também pode usar a variável de ambiente LANGAUGE para alterar temporariamente git
caudacomo qualquer outro programa baseado em gettext. Por exemplo, temporariamente
alterar git caudaidioma de para inglês:

LANGUAGE = en git cola

Para fazer git cauda use a tradução zh_TW com zh_HK, zh e en como um substituto:

LANGUAGE = zh_TW: zh_HK: zh: en git cola

SUPORTE GUI AÇÕES

git cauda permite que você defina ações personalizadas da GUI configurando git configuração variáveis. o
O "nome" do comando aparece no menu "Ações".

guitool. .cmd
Especifica a linha de comando do shell a ser executada quando o item correspondente do menu Ferramentas
é invocado. Esta opção é obrigatória para todas as ferramentas. O comando é executado a partir da raiz
do diretório de trabalho, e no ambiente recebe o nome da ferramenta como
GIT_GUITOOL, o nome do arquivo atualmente selecionado como FILENAME, e o nome do
ramificação atual como CUR_BRANCH (se o cabeçote for destacado, CUR_BRANCH está vazio).

guitool. .fundo
Execute o comando em segundo plano (semelhante às ações de edição e difftool). Isso evita
bloqueando a GUI. Configuração fundo para verdadeiro implica sem console e norescan.

guitool. .needsfile
Execute a ferramenta apenas se um diff estiver selecionado na GUI. Garante que FILENAME não é
esvaziar.

guitool. .noconsole
Execute o comando silenciosamente, sem criar uma janela para exibir sua saída.

guitool. .norescan
Não verifique novamente o diretório de trabalho em busca de alterações depois que a ferramenta terminar a execução.

guitool. .confirme
Mostra uma caixa de diálogo de confirmação antes de realmente executar a ferramenta.

guitool. .argprompt
Solicite um argumento de string do usuário e passe-o para a ferramenta por meio do ARGS
variável de ambiente. Uma vez que solicitar um argumento implica confirmação, a confirmação
opção não tem efeito se estiver habilitada. Se a opção for definida como verdadeira, sim ou 1, o
diálogo usa um prompt genérico embutido; caso contrário, o valor exato da variável é usado.

guitool. .revprompt
Solicite uma única revisão válida do usuário e defina a variável de ambiente REVISION.
Em outros aspectos, essa opção é semelhante ao argprompt e pode ser usada junto com ele.

guitool. .revunmerged
Mostrar apenas ramificações não mescladas na caixa de diálogo revprompt. Isso é útil para ferramentas semelhantes
para mesclar ou rebase, mas não para coisas como check-out ou redefinição.

guitool. .título
Especifica o título a ser usado para a caixa de diálogo de prompt. O padrão é o nome da ferramenta.

guitool. .mensagem
Especifica a string de prompt geral a ser exibida na parte superior da caixa de diálogo, antes
subseções para argprompt e revprompt. O valor padrão inclui o comando real.

guitool. .atalho
Especifica um atalho de teclado para a ferramenta personalizada.

O valor deve ser uma string válida compreendida pelo QAction :: setShortcut () API. Ver
http://qt-project.org/doc/qt-4.8/qkeysequence.html# QKeySequence-2 para mais detalhes sobre
os valores suportados.

Evite criar atalhos que entrem em conflito com o integrado existente git cauda atalhos.
A criação de um conflito resultará em nenhuma ação quando o atalho for usado.

DEFINIÇÃO UP GPG PARA ASSINADO COMPROMETE

Ao criar commits assinados gpg tentará ler sua senha no terminal de
qual git cauda foi lançado. A maneira de fazer isso funcionar sem problemas é usar um agente GPG para
que você pode evitar a necessidade de redigitar sua senha toda vez que fizer um commit.

Isso também dá a você um prompt gráfico de senha em vez de ser solicitado por sua
senha no terminal.

Instale agente gpg e amigos
No Mac OS X, você pode precisar fermentação instalar agente gpg e instale o Mac GPG suíte.

No Linux, use seu gerenciador de pacotes para instalar gnupg2, gnupg-agent e pinentry-qt, por exemplo:

sudo apt-get install gnupg2 gnupg-agent pinentry-qt

No Linux, você também deve configurar o Git para que use gpg2 (gnupg2), caso contrário,
obter erros mencionando, "não foi possível abrir / dev / tty". Definir Git's gpg.programa para gpg2:

git config --global gpg.program gpg2

configurar agente gpg e a pin-entrada programa
No Mac OS X, edite ~ / .gnupg / gpg.conf para incluir a linha ,:

agente de uso

Isso normalmente não é necessário no Linux, onde gpg2 é usado, pois este é o valor padrão
quando se utiliza gpg2.

Em seguida, edite ~ / .gnupg / gpg-agent.conf para conter uma linha de programa pinentry apontando para o
programa pinentry para sua plataforma.

O seguinte exemplo ~ / .gnupg / gpg-agent.conf mostra como usar pinentry-qt no Linux:

pinentry-program / usr / bin / pinentry-qt
cache padrão-ttl 3600
ativar-ssh-support
usar soquete padrão

Este exemplo a seguir .gnupg / gpg-agent.conf mostra como usar o aplicativo pinentry do MacGPG2 no On
Mac OS X:

programa pinentry /usr/local/MacGPG2/libexec/pinentry-mac.app/Contents/MacOS/pinentry-mac
cache padrão-ttl 3600
ativar-ssh-support
usar soquete padrão

Uma vez que isso tenha sido configurado, você precisará iniciar o daemon gpg-agent. Primeiro, verifique
se já estiver em execução:

ambiente | grep GPG_AGENT_INFO
echo bye | gpg-conectar-agente

Se você vir a seguinte saída:

GPG_AGENT_INFO = ...
OK fechando conexão

Então o daemon já está em execução e você não precisa iniciá-lo sozinho.

Se não estiver em execução, avalie a saída de agente gpg --daemon em sua concha antes de
de lançamento git cauda.:

eval $ (gpg-agent --daemon)
pegue cola

Windows NOTAS

Git Instalação
Se o Git estiver instalado em um local personalizado, por exemplo, não instalado em C: / Git ou arquivos de programa,
então o caminho para Git deve ser configurado criando um arquivo em seu diretório home
~ / .config / git-cola / git-bindir que aponta para sua instalação git. por exemplo:

C: / Ferramentas / Git / bin

LINKS

Git Cola Git Repositório
https://github.com/git-cola/git-cola/

Git Cola Homepage
https://git-cola.github.io/

Correspondência Lista
https://groups.google.com/group/git-cola

Use git-difftool - helper online usando serviços onworks.net