Como criar seu primeiro repositório no Github

O popular site Github, junto com a ferramenta git, é um excelente recurso não apenas para distribuir e mostrar seu trabalho, mas também para facilitar o controle de versão profissional e eficiente.

Neste tutorial, vamos explorar como criar um repositório Github, push commits, lançamentos de tags e muito mais.

Crie um Repositório

Para criar um novo repositório, primeiro faça login no Github ou registre-se para uma nova conta. Uma vez logado, clique no botão Criar Novo no canto superior direito da tela, seguido do link Repositório na lista suspensa que aparece.

Você verá a tela de criação de repositório:

O nome e a descrição do repositório podem ser qualquer coisa que você desejar e, para este exemplo, "muo_demo" foi usado como o nome. Deixe o resto dos campos como estão / em branco e clique no botão Criar novo Repositório . Você será levado a uma página exibindo seu novo repositório em branco.

Iniciar Repositório Local

Agora que um repositório no Github foi criado, você precisa inicializar o repositório em seu PC local. Execute os seguintes comandos no terminal para criar um diretório em branco e adicione um arquivo Readme.md.

 mkdir myrepo

 cd myrepo

 echo "# My Test Repository" > Readme.md

 echo "A temporary file" > temp.txt

Ao visualizar um repositório no Github, o conteúdo do arquivo Readme.md é sempre exibido para descrever o repositório ou como a primeira página do manual. A extensão de arquivo .md significa formato Markdown, e se você não está familiarizado com o Markdown, verifique nossa excelente folha de dicas do formato Markdown .

Agora você pode iniciar o repositório dentro do terminal com os comandos.

 git init

 git remote add origin https://github.com/mdizak/muo_demo.git

No segundo comando, você precisa alterar o "mdizak" para seu nome de usuário Github, e a parte "muo_demo" para o nome do seu repositório. Por exemplo, se o seu nome de usuário do Github for "johndoe" e o nome do seu repositório for "test_repo", o comando seria:

 git remote add origin https://github.com/johndoe/test_repo.git

Primeiro Compromisso

Agora você pode sincronizar os repositórios local e Github e adicionar os dois arquivos ao Github, com os seguintes comandos no terminal.

 git add Readme.md temp.txt

 git commit -m "My first commit"

 git push -u origin master

Você será solicitado a fornecer seu nome de usuário e senha do Github e, após a entrada bem-sucedida, os dois arquivos serão carregados para o repositório do Github. Se você recarregar seu repositório Github em seu navegador, verá agora os dois arquivos junto com o cabeçalho "Meu Repositório de Teste" dentro do arquivo Readme.md.

Grandes mensagens de compromisso

Em vez de especificar apenas uma pequena mensagem de confirmação de uma única linha, também é possível incluir uma mensagem de texto maior. Em seu editor de texto favorito, insira o conteúdo da mensagem de confirmação, que pode ser tão grande e quantas linhas desejar. Ao confirmar as alterações mais recentes, use o comando.

 git commit --file=/path/to/commit.txt

Certifique-se de que o comando aponte para o arquivo de texto de sua mensagem de confirmação e seu conteúdo será usado em vez da mensagem de linha única definida por meio da opção -m.

Excluindo Arquivos

A exclusão de arquivos é feita da mesma maneira, exceto para usar o comando git add acima, usamos o comando git rm . Para excluir o arquivo temp.txt adicionado anteriormente, execute os seguintes comandos no terminal.

 git rm temp.txt

 git commit -m "Deleting temp file"

 git push -u origin master

Seu nome de usuário e senha serão solicitados novamente e, uma vez feito isso, o arquivo temp.txt será excluído do seu repositório Github. Isso é tudo que há para fazer!

Lançamentos de marcação

De vez em quando, quando estiver perfeitamente satisfeito com o projeto testado, você pode querer marcar o estado atual como uma versão. Isso informa a outros que o projeto em seu estado está completo e pronto para distribuição ao público.

A marcação de seu repositório como uma versão é feita adicionando uma tag com o número da versão. Por exemplo, para liberar nosso repositório atual como v1.0.0 dentro do terminal, execute os comandos.

 git tag 1.0.0

 git push --tags

Depois de inserir seu nome de usuário e senha do Github, recarregue a página do repositório em seu navegador da web. Você notará que agora há uma versão para o seu repositório. Clicar para ver todas as versões fornecerá um link para o arquivo TAR.GZ do repositório completo no estado de quando a versão foi marcada.

Repositório de clones

Às vezes, você precisará clonar e reinicializar seu repositório do zero. Isso é feito facilmente com os seguintes comandos no terminal.

 git clone https://github.com/mdizak/muo_demo.git myrepo

 cd myrepo

 git init

Da mesma forma que quando inicializamos o repositório, na primeira linha você precisa alterar o nome de usuário do Github e o nome do repositório na URL.

Isso fará o download do conteúdo do repositório do Github no diretório / myrepo / e, em seguida, o reinicializará com o comando git init . A partir daí, você pode continuar adicionando e excluindo arquivos como acima.

Exibir histórico de commits

Você pode voltar e visualizar seus commits anteriores com o log do git , como:

 git log - 3

O comando acima irá mostrar os últimos três commits feitos no repositório. Isso pode ser útil se você precisar modificar ou excluir um commit por qualquer motivo.

Emendar uma mensagem de compromisso

Se você já enviou um commit para o Github, mais tarde percebeu que cometeu um erro na mensagem de commit, existe uma maneira de alterá-lo. Para corrigir a última mensagem de confirmação, execute o comando no terminal.

 git commit --amend

Isso abrirá seu editor de texto padrão com a mensagem de confirmação anterior. Faça as alterações necessárias e feche o editor. Se estiver usando o nano como editor de texto, você pode fechá-lo pressionando Ctrl + X , seguido das teclas Y e Enter .

Depois de salvar a nova mensagem de confirmação, envie-a ao Github com o comando:

 git push --force origin

Pronto para mostrar o seu trabalho!

Parabéns, agora você aprendeu o básico sobre o uso do popular site Github junto com a ferramenta de linha de comando git. Você criou um repositório com sucesso e agora pode adicionar / excluir arquivos, enviar commits, liberar tags e clonar repositórios.

Se você deseja aprender comandos git mais avançados, verifique o site Comandos git avançados .