Guia rápido para usar o Github

Este tutorial é um guia rápido para instalar e usar o GitHub. Veja como criar um repositório local, como conectar esse repositório local ao repositório Github remoto (onde todos podem ver), como confirmar alterações e, finalmente, como enviar todo o conteúdo do repositório local para o GitHub, entre outras tarefas comuns. .

Antes de começar, é importante observar que este tutorial pressupõe um entendimento básico dos termos usados ​​no Git: push, pull, commit, repository, etc. Também requer registro prévio em GitHub.

Instalação do Github

No Debian / Ubuntu e derivados:

sudo apt-get install git

En Fedora e derivados:

sudo yum instalar git

En arco e derivados:

suor pacman -S git

Configuração inicial do Github

Depois que a instalação for concluída com êxito, a próxima etapa é configurar os detalhes de configuração do usuário do GitHub. Para fazer isso, use os comandos a seguir, substituindo "username" pelo seu nome de usuário do GitHub e "email_id" pelo endereço de e-mail usado para criar a conta do GitHub.

git config --global user.name "nome de usuário" git config --global user.email "email_id"

Crie um repositório local

A primeira coisa é criar uma pasta em seu computador, que servirá como repositório local. Para fazer isso, basta executar o seguinte comando:

git init Meu teste

Este comando cria a pasta MyTest. Por sua vez, a subpasta .init torna MyTest reconhecido como um repositório Git local.

Se o repositório for criado com sucesso, uma linha semelhante à seguinte aparecerá:

Repositório Git vazio inicializado em /home/tu_usuario/Mytest/.git/

Então, você deve ir para a pasta MyTest:

cd Meu teste

Crie um arquivo README para descrever o repositório

O arquivo README é geralmente usado para descrever o que o repositório contém ou sobre o que o projeto se trata. Para criar um, basta executar:

gedit LEIA-ME

Depois de inserir a descrição do repositório, não se esqueça de salvar suas alterações.

Adicionando os arquivos do repositório a um índice

Este é um passo importante. Antes de enviar suas alterações para o Github ou outro servidor compatível com Git, você deve indexar todos os arquivos contidos no repositório local. Este índice conterá os novos arquivos, bem como as alterações nos arquivos existentes no repositório local.

Em nosso caso, nosso repositório local já contém um novo arquivo: o README. Portanto, vamos criar outro arquivo com um programa C simples e que chamaremos de example.c. Seu conteúdo será:

#include int main () {printf ("hello world"); return 0; }

Portanto, agora temos 2 arquivos em nosso repositório local: README e exemplo.c.

A próxima etapa é adicionar esses arquivos ao índice:

git add README git add smaple.c

O comando "git add" pode ser usado para adicionar qualquer número de arquivos e pastas ao índice. Para adicionar todas as alterações, sem especificar o nome dos arquivos, é possível executar "git add." (com um ponto final no final).

Salve as alterações feitas no índice

Uma vez que todos os arquivos foram adicionados, é possível deixar um registro dessas mudanças fazendo o que no jargão é chamado de "commit". Isso significa que a adição ou modificação de arquivos foi concluída e as alterações podem ser carregadas no repositório Github remoto. Para fazer isso, você deve executar o seguinte comando:

git commit -m "mensagem"

"Mensagem" pode ser qualquer mensagem que descreva resumidamente as mudanças em questão, por exemplo: "Eu adicionei essa funcionalidade" ou "Eu corrigi tal coisa" e assim por diante.

Crie um repositório no GitHub

O nome do repositório deve ser igual ao do repositório no sistema local. Neste caso, será "MyTest". Para fazer isso, primeiro de tudo, você deve fazer login em Github. Em seguida, clique no sinal de mais (+) no canto superior direito da página e selecione a opção "criar novo repositório". Finalmente, você deve preencher os dados e clicar no botão "criar repositório".

Feito isso, o repositório será criado e será possível fazer o upload do conteúdo do repositório local para o repositório GitHub. Para se conectar ao repositório remoto no GitHub, você deve executar o comando:

git remoto adicionar origem https://github.com/user_name/Mytest.git

Envie arquivos do repositório local para o repositório GitHub

A etapa final é enviar o conteúdo do repositório local para o repositório remoto, usando o comando:

mestre de origem git push

Resta apenas inserir as credenciais de login (nome de usuário e senha).

Isso fará o upload de todo o conteúdo da pasta MyTest (repositório local) para o GitHub (repositório externo). Para projetos subsequentes, você não precisa mais seguir essas etapas do zero. Em vez disso, você pode começar a partir da etapa 3 diretamente. Por fim, não se esqueça que as alterações estarão disponíveis no site do Github.

Criando uma filial

Quando os desenvolvedores desejam corrigir bugs ou adicionar novas funções, eles geralmente criam um branch ou uma cópia do código para que possam fazer commit separadamente, sem afetar o projeto original. Então, quando terminarem, eles podem mesclar este branch de volta ao branch principal (master).

Para criar uma nova filial, existem duas opções:

Opção longa:

git branch mirama # crie um novo branch chamado mirama git checkout mirama - mude para o branch mirama.

Opção curta:

git checkout -b mirama - cria e muda para usar o branch mirama

Assim que as alterações forem feitas, adicione-as ao índice do branch e faça o commit correspondente:

git add. git commit -m "muda para mirama"

Então, você tem que voltar ao branch principal e pegar as mudanças feitas no mirama:

git checkout master git merge mirama

Finalmente, você deve excluir o mirama (uma vez que as alterações foram incorporadas no mestre):

git branch -d mirama

E carregue o master para o Github:

mestre de origem git push

Criação de um repositório Git derivado (fork)

Graças ao Git e à existência de grandes bibliotecas de repositórios públicos, como o Github, na maioria das vezes não é necessário começar a programar nosso projeto do zero. Nesses casos, é possível usar este código base para criar um novo projeto.

Para fazer isso, a primeira coisa a fazer é um fork de um repositório existente, ou seja, um projeto derivado dele com base no código do projeto original. No Github, isso é feito clicando no botão correspondente, conforme visto na imagem abaixo.

Então, o que temos que fazer é clonar o repositório deste novo projeto em nosso computador. Como exemplo, podemos usar meu repositório Ankifox, uma extensão para Firefox que permite adicionar palavras a Anki, que está disponível no Github:

clone do git https://github.com/usemoslinux/Ankifox.git

Não se esqueça de substituir https://github.com/usemoslinux/Ankifox.git pelo URL correspondente ao seu projeto. Conseguir esse endereço é muito fácil, como pode ser visto na imagem abaixo.

Este comando criará um diretório chamado «Ankifox», inicializará o diretório .git dentro dele e fará o download de todos os dados desse repositório, para trabalhar com a versão mais recente.