Sobre a bifurcação
Depois de usar o GitHub por um tempo, você deverá contribuir para o projeto de outra pessoa. Ou talvez você deva usar o projeto de alguém como ponto de partida para o seu próprio projeto. Este processo é conhecido como bifurcação.
A criação de uma "bifurcação" produz uma cópia pessoal do projeto de outra pessoa. As bifurcações atuam como um tipo de ponte entre o repositório original e a sua cópia pessoal. Você pode enviar pull requests para ajudar a melhorar os projetos de outras pessoas oferecendo suas alterações até o projeto original. A bifurcação é um elemento essencial do código social no GitHub. Para obter mais informações, consulte "Bifurcar um repositório".
Bifurcar um repositório
Este tutorial usa o projeto Spoon-Knife, um repositório de teste hospedado em GitHub.com que permite testar o fluxo de trabalho de bifurcação e pull request.
- Acecsse o projeto
Spoon-Knife
em https://github.com/octocat/Spoon-Knife. - Clique em Bifurcação.
- GitHub Enterprise Server irá direcionar você para sua cópia (sua bifurcação) do repositório Spoon-Knife.
Clonando uma bifurcação
Você criou com sucesso o repositório Spoon-Knife mas, até agora, ele existe apenas em GitHub Enterprise Server. Para poder trabalhar no projeto, você deverá cloná-lo para o seu computador.
Você pode clonar a sua bifurcação com a linha de comando, GitHub CLI ou GitHub Desktop.
-
Em GitHub Enterprise Server, vá até your fork (sua bifurcação) no repositório Spoon-Knife.
-
Acima da lista de arquivos, clique em código.
-
Para clonar o repositório usando HTTPS, em "Clonar com HTTPS", clique em . To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click Use SSH, then click . To clone a repository using GitHub CLI, click Use GitHub CLI, then click .
-
Abra TerminalTerminalGit Bash.
-
Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.
-
Digite
git clone
(clonar git) e cole a URL que você copiou anteriormente. Ficará assim, com seu GitHub Enterprise Server nome de usuário no lugar deYOUR-USERNAME
:$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife
-
Pressione Enter. Seu clone local estará criado.
$ git clone https://hostname/YOUR-USERNAME/Spoon-Knife > Clonando para `Spoon-Knife`... > remote: Contando objetos: 10, concluído. > remote: Compactando objetos: 100% (8/8), concluído. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done.
Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."
Para criar um clone da sua bifurcação, use o sinalizador --clone
.
gh repo fork repository --clone=true
-
No menu File (Arquivo), clique em Clone Repository (Clonar repositório).
-
Clique na aba que corresponde � localização do repositório que você deseja clonar. Você também pode clicar URL para inserir manualmente o local do repositório.
-
Escolha o repositório que você quer clonar na lista.
-
Clique em Escolher... e acesse um caminho local onde você deseja clonar o repositório.
-
Clique em Clone (Clonar).
Fazendo e enviando por push as alterações
Siga em frente e faça algumas alterações no projeto usando o seu editor de texto favorito, como Atom. Você pode, por exemplo, alterar o texto em index.html
para adicionar o seu nome de usuário do GitHub.
Quando estiver pronto para enviar suas alterações, teste e faça commit das suas alterações. git add .
informa ao Git que você deseja incluir todas as alterações no próximo commit. git commit
tira um instantâneo dessas alterações.
git add .
git commit -m "Uma breve descrição da alteração"
git add .
git commit -m "Uma breve descrição da alteração"
Para obter mais informações sobre como testar e fazer commit das alterações em GitHub Desktop, consulte "Fazendo commit e revisando as alterações no seu projeto."
Ao testar e fazer commit dos arquivos, você essencialmente diz ao Git, "Ok, tire um instantâneo das minhas alterações!" Você pode continuar fazendo mais alterações e tirar mais instantâneos do commit.
No momento, suas alterações existem apenas localmente. Quando estiver pronto para fazer push das suas alterações para GitHub Enterprise Server, faça push delas para o controle remoto.
git push
git push
Para obter mais informações sobre como fazer push de alterações em GitHub Desktop, consulte "Envio por push das alterações para o GitHub."
Fazendo um pull request
Finalmente, você está pronto para propor alterações no projeto principal! Essa é a última etapa para produzir uma bifurcação do projeto de outra pessoa, e a mais importante, indiscutivelmente. Se você fez uma alteração que você considera que beneficiaria a comunidade como um todo, você deve considerar contribuir de novamente.
Para fazer isso, acesse o repositório GitHub Enterprise Server onde seu projeto encontra-se. Para este exemplo, ela seria em https://www.github.com/<your_username>/Spoon-Knife
. Você verá um banner que indica que o seu branch é um commit � frente do octocat: main
. Clique em Contribuir e, em seguida, Abrir um pull request.
O GitHub Enterprise Server levará você a uma página que mostra as diferenças entre a sua bifurcação e o repositório octocat/Spoon-Knife
. Clique em Create pull request (Criar pull request).
GitHub Enterprise Server levará você a uma página onde você pode inserir um título e uma descrição das suas alterações. É importante fornecer tantas informações úteis e uma razão para o motivo de você estar fazendo este pull request. O proprietário do projeto deve poder determinar se a sua alteração é tão útil para todos quanto você pensa. Por fim, clique em Criar pull request.
Gerenciando feedback
Os pull requests são uma área de discussão. Neste caso, o Octocat está muito ocupado e provavelmente não irá fazer merge das suas alterações. Para outros projetos, não se ofenda se o proprietário do projeto rejeitar o seu pull request ou pedir mais informações sobre o porquê de a alteração ter sido feita. Pode até ser que o proprietário do projeto não faça o merge do seu pull request e isso está perfeitamente bem. Your copy will exist in infamy on the Internet. E quem sabe - talvez alguém que você nunca conheceu, considere as suas alterações muito mais valiosas do que o projeto original.
Encontrando projetos
Você fez uma bifurcação com sucesso e contribuiu de volta para um repositório. Vá em frente e contribua com um pouco mais!