diff --git a/pages.pt_BR/common/git-branch.md b/pages.pt_BR/common/git-branch.md new file mode 100644 index 000000000..26fffdb57 --- /dev/null +++ b/pages.pt_BR/common/git-branch.md @@ -0,0 +1,36 @@ +# git branch + +> Comando principal do Git para trabalhar com branches. +> Mais informações: . + +- Lista todas as branches (locais e remotas; a branch atual é destacada por `*`): + +`git branch --all` + +- Lista quais branches incluem um commit específico do Git em seu histórico: + +`git branch --all --contains {{hash_do_commit}}` + +- Mostra o nome da branch atual: + +`git branch --show-current` + +- Cria uma nova branch baseada no commit atual: + +`git branch {{nome_da_branch}}` + +- Crua uma nova branch baseada em um commit específico: + +`git branch {{nome_da_branch}} {{hash_do_commit}}` + +- Renomeia uma branch (não precisa fazer checkout para isso): + +`git branch -m {{antigo_nome_da_branch}} {{novo_nome_da_branch}}` + +- Exclui a branch local (não precisa fazer checkout para isso): + +`git branch -d {{nome_da_branch}}` + +- Exclui uma branch remota: + +`git push {{nome_remoto}} --delete {{nome_da_branch_remota}}` diff --git a/pages.pt_BR/common/git-checkout.md b/pages.pt_BR/common/git-checkout.md new file mode 100644 index 000000000..1ed58b5a0 --- /dev/null +++ b/pages.pt_BR/common/git-checkout.md @@ -0,0 +1,36 @@ +# git checkout + +> Faz checkout de uma branch ou caminhos para uma árvore de trabalho. +> Mais informações: . + +- Cria e muda para uma nova branch: + +`git checkout -b {{nome_da_branch}}` + +- Cria e muda para uma nova branch com base em uma referência específica (branch, remoto/branch, etiqueta são exemplos de referências válidas): + +`git checkout -b {{nome_da_branch}} {{referência}}` + +- Muda para uma branch local existente: + +`git checkout {{nome_da_branch}}` + +- Muda para uma branch previamente verificada: + +`git checkout -` + +- Muda para uma branch remota existente: + +`git checkout --track {{nome_remoto}}/{{nome_da_branch}}` + +- Descarta todas as alterações não preparadas no diretório atual (consulte `git reset` para mais comandos do tipo desfazer): + +`git checkout .` + +- Descarta alterações não preparadas em um determinado arquivo: + +`git checkout {{caminho/para/arquivo}}` + +- Substitui um arquivo no diretório atual com a versão com commit em uma determinada branch: + +`git checkout {{nome_da_branch}} -- {{caminho/para/arquivo}}` diff --git a/pages.pt_BR/common/git-commit.md b/pages.pt_BR/common/git-commit.md new file mode 100644 index 000000000..cdd3180e4 --- /dev/null +++ b/pages.pt_BR/common/git-commit.md @@ -0,0 +1,32 @@ +# git commit + +> Faz um commit dos arquivos no repositório. +> Mais informações: . + +- Faz um commit com os arquivos preparados no repositório com uma mensagem: + +`git commit --message "{{mensagem}}"` + +- Faz um commit com os arquivos preparados com uma mensagem lida de um arquivo: + +`git commit --file {{caminho/para/arquivo_de_mensagem_do_commit}}` + +- Prepara automaticamente todos os arquivos modificados e excluídos e faz o commit com uma mensagem: + +`git commit --all --message "{{mensagem}}"` + +- Faz um commit com os arquivos preparados e assina-os com a chave GPG especificada (ou a definida no arquivo de configuração se nenhum argumento for especificado): + +`git commit --gpg-sign {{id_da_chave}} --message "{{mensagem}}"` + +- Atualiza o último commit adicionando as alterações atualmente preparadas, alterando o hash do commit: + +`git commit --amend` + +- Faz um commit apenas de arquivos específicos (já preparados): + +`git commit {{caminho/para/arquivo1}} {{caminho/para/arquivo2}}` + +- Cria um commit, mesmo se não haja arquivos preparados: + +`git commit --message "{{mensagem}}" --allow-empty` diff --git a/pages.pt_BR/common/git-diff.md b/pages.pt_BR/common/git-diff.md new file mode 100644 index 000000000..a0ec9efea --- /dev/null +++ b/pages.pt_BR/common/git-diff.md @@ -0,0 +1,36 @@ +# git diff + +> Mostra alterações nos arquivos rastreados. +> Mais informações: . + +- Mostra as alterações não preparadas e sem commit: + +`git diff` + +- Mostra todas as alterações sem commit (incluindo as preparadas): + +`git diff HEAD` + +- Mostra apenas as alterações preparadas (adicionadas, mas ainda sem commit): + +`git diff --staged` + +- Mostra as alterações de todos os commits desde uma determinada data/hora (uma expressão de data, por exemplo, "1 week 2 days" ou uma data ISO): + +`git diff 'HEAD@{3 months|weeks|days|hours|seconds ago}'` + +- Mostra apenas os nomes dos arquivos alterados desde um determinado commit: + +`git diff --name-only {{commit}}` + +- Emite um resumo das criações de arquivos, renomeações e alterações de modo desde um determinado commit: + +`git diff --summary {{commit}}` + +- Compara um único arquivo entre duas branches ou commits: + +`git diff {{branch_1}}..{{branch_2}} [--] {{caminho/para/arquivo}}` + +- Compara diferentes arquivos da branch atual com outra branch: + +`git diff {{branch}}:{{caminho/para/arquivo2}} {{caminho/para/arquivo}}` diff --git a/pages.pt_BR/common/git-init.md b/pages.pt_BR/common/git-init.md new file mode 100644 index 000000000..1cce19d1e --- /dev/null +++ b/pages.pt_BR/common/git-init.md @@ -0,0 +1,20 @@ +# git init + +> Inicializa um novo repositório Git local. +> Mais informações: . + +- Inicializa um novo repositório local: + +`git init` + +- Inicializa um repositório com o nome especificado para a branch inicial: + +`git init --initial-branch={{nome_da_branch}}` + +- Inicializa um repositório usando SHA256 para os hashes de objeto (requer Git versão 2.29+): + +`git init --object-format={{sha256}}` + +- Inicializa um repositório barebones, adequado para usar como um remoto via ssh: + +`git init --bare` diff --git a/pages.pt_BR/common/git-log.md b/pages.pt_BR/common/git-log.md new file mode 100644 index 000000000..34f877b67 --- /dev/null +++ b/pages.pt_BR/common/git-log.md @@ -0,0 +1,36 @@ +# git log + +> Mostra um histórico de commits. +> Mais informações: . + +- Mostra a sequência de commits a partir do atual, em ordem cronológica reverse do repositório Git no diretório de trabalho atual: + +`git log` + +- Mostra o histórico de um arquivo ou diretório determinado, incluindo diferenças: + +`git log -p {{caminho/para/arquivo_ou_diretório}}` + +- Mostra uma visão geral do(s) arquivo(s) alterado(s) em cada commit: + +`git log --stat` + +- Mostra um grafo dos commits no branch atual usando apenas a primera linha de cada mensagem de commit: + +`git log --oneline --graph` + +- Mostra um grafo de todos os commits, etiquetas e branches em todo o repositório: + +`git log --oneline --decorate --all --graph` + +- Mostra apenas os commits cujas mensagem incluem uma determinada cadeia de caracteres (sem distinção entre maiúsculas e minúsculas): + +`git log -i --grep {{cadeia_de_caracteres_para_pesquisa}}` + +- Mostra os últimos N commits de um determinado autor: + +`git log -n {{número}} --author={{autor}}` + +- Mostra os commits entre duas datas(aaaa-mm-dd): + +`git log --before="{{2017-01-29}}" --after="{{2017-01-17}}"` diff --git a/pages.pt_BR/common/git-pull.md b/pages.pt_BR/common/git-pull.md new file mode 100644 index 000000000..eb3da4623 --- /dev/null +++ b/pages.pt_BR/common/git-pull.md @@ -0,0 +1,16 @@ +# git pull + +> Obtém branch de um repositório remoto e mescla-a ao repositório local. +> Mais informações: . + +- Baixa as alterações do repositório remoto padrão e mescla-as: + +`git pull` + +- Baixa as alterações do repositório remoto padrão e usa o avanço rápido: + +`git pull --rebase` + +- Baixa as alterações de um determinado repositório remoto e branch, então, mescla-as no HEAD: + +`git pull {{nome_remoto}} {{branch}}` diff --git a/pages.pt_BR/common/git-push.md b/pages.pt_BR/common/git-push.md new file mode 100644 index 000000000..1b4766941 --- /dev/null +++ b/pages.pt_BR/common/git-push.md @@ -0,0 +1,36 @@ +# git push + +> Envia commits para um repositório remoto. +> Mais informações: . + +- Envia alterações locais na branch atual para sua contraparte remota padrão: + +`git push` + +- Envia alterações de uma branch local específica para sua contraparte remota: + +`git push {{nome_remoto}} {{branch_local}}` + +- Envia alterações de uma branch local específica para sua contraparte remota, e define a branch remota como o destino push/pull padrão da branch local: + +`git push -u {{nome_remoto}} {{branch_local}}` + +- Envia alterações de uma branch local específica para uma branch remota específica: + +`git push {{nome_remoto}} {{branch_local}}:{{branch_remota}}` + +- Envia alterações em todas as branches locais para suas contrapartes em um determinado repositório remoto: + +`git push --all {{nome_remoto}}` + +- Exclui uma branch em um repositório remoto: + +`git push {{nome_remoto}} --delete {{branch_remota}}` + +- Remove branches remotas que não tenham uma contraparte local: + +`git push --prune {{nome_remoto}}` + +- Publica etiquetas que ainda não estão no repositório remoto: + +`git push --tags` diff --git a/pages.pt_BR/common/git-rebase.md b/pages.pt_BR/common/git-rebase.md new file mode 100644 index 000000000..b2101d1da --- /dev/null +++ b/pages.pt_BR/common/git-rebase.md @@ -0,0 +1,37 @@ +# git rebase + +> Reaplica os commits de uma branch sobre outra branch. +> Comumente usado para "mover" uma branch inteira para outra base, criando cópias dos commits na nova localização. +> Mais informações: . + +- Faz um rebase na branch atual sobre outra branch especificada: + +`git rebase {{nova_branch_base}}` + +- Inicia um rebase interativo, que permite os commits serem reordenados, omitidos, combinados ou modificados: + +`git rebase -i {{branch_base_alvo_ou_hash_do_commit}}` + +- Continua um rebase que foi interrompido por uma falha de mesclagem, após a edição de arquivos conflitantes: + +`git rebase --continue` + +- Continua um rebase que foi pausado devido a conflitos de mesclagem, ignorando o commit conflitante: + +`git rebase --skip` + +- Aborta um rebase em andamento (por exemplo, se ele foi interrompido por um conflito de mesclagem): + +`git rebase --abort` + +- Move parte da branch atual para uma nova base, fornecendo a base antiga para começar: + +`git rebase --onto {{base_nova}} {{base_antiga}}` + +- Reaplica os últimos 5 commits no local, parando para permitir que eles sejam reordenados, omitidos, combinados ou modificados: + +`git rebase -i {{HEAD~5}}` + +- Resolve automaticamente quaisquer conflitos favorecendo a versão da branch de trabalho (a palavra-chave `theirs` tem significado invertido nesse caso): + +`git rebase -X theirs {{nome_da_branch}}` diff --git a/pages.pt_BR/common/git-reset.md b/pages.pt_BR/common/git-reset.md new file mode 100644 index 000000000..3c4c58940 --- /dev/null +++ b/pages.pt_BR/common/git-reset.md @@ -0,0 +1,33 @@ +# git reset + +> Desfaz os commits ou as alterações nào preparadas, redefinindo o Git HEAD atual para o estado especificado. +> Se um caminho é passado, funcionará como "não preparado"; se um hash de commit ou uma branch é passado, funcionará como "sem commit". +> Mais informações: . + +- Remove tudo da preparação: + +`git reset` + +- Remove arquivo(s) específico(s) da preparação: + +`git reset {{caminho/para/arquivo1 caminho/para/arquivo2 ...}}` + +- Interativamente remove partes de um arquivo da preparação: + +`git reset --patch {{caminho/para/arquivo}}` + +- Desfaz o último commit, mantendo suas alterações (e quaisquer outras alteração não confirmadas) no sistema de arquivos: + +`git reset HEAD~` + +- Desfaz os últimos dois commits, adicionando suas alterações na área de preparação, isso é, preparando-os para o commit: + +`git reset --soft HEAD~2` + +- Descarta quaisquer alterações sem commit, preparadas ou não (para apenas alterações não preparadas, use o `git checkout`): + +`git reset --hard` + +- Redefine o repositório para um determinado commit, descartando as alterações com commit, preparadas e sem commit desde então: + +`git reset --hard {{commit}}` diff --git a/pages.pt_BR/common/git-status.md b/pages.pt_BR/common/git-status.md new file mode 100644 index 000000000..78dec6194 --- /dev/null +++ b/pages.pt_BR/common/git-status.md @@ -0,0 +1,21 @@ +# git status + +> Mostra as alterações nos arquivos em um repositório Git. +> Lista os arquivos alterados, adicionados e excluídos em comparação com o atual commit verificado. +> Mais informações: . + +- Mostra arquivos alterados que ainda não foram adicionados para commit: + +`git status` + +- Fornece a saída em formato curto: + +`git status -s` + +- Não mostra arquivos não rastreados na saída: + +`git status --untracked-files=no` + +- Mostra a saída em formato curto junto com as informações da branch: + +`git status -sb`