↩

Criação de repositório no GitHub e configurações iniciais

1. Por que criar um repositório no GitHub?

O repositório no GitHub é o espaço online do seu projeto. Ele permite compartilhar código, trabalhar em equipe e manter histórico de alterações fora do seu computador.

2. Passo a passo da criação

Passo a passo da criação do repositório no GitHub

3. Opções na criação do repositório

  • Público ou Privado:
    • Público permite que qualquer pessoa veja seu código.
    • Privado apenas você ou colaboradores podem ver seu repositório.
  • README: um arquivo de texto inicial que documenta e explica o projeto.
    Explicação detalhada

    README é um arquivo de extensão .md, esses arquivos utilizam uma linguagem chamada markdown. O markdown permite criar títulos, listas, links, imagens e destacar comandos de forma simples.

  • License: documento que define legalmente como outras pessoas podem usar, modificar e redistribuir o código. Sem licença explícita, o projeto permanece com "todos os direitos reservados".
    Explicação detalhada

    Principais tipos de licença:

    • Permissivas (ex.: MIT, Apache 2.0, BSD): permitem uso, cópia, modificação e redistribuição em projetos livres ou proprietários, geralmente com a condição de manter os créditos ao(s) autor(es).
    • Copyleft (ex.: GPL): autorizam uso e modificação, mas exigem que qualquer obra derivada seja distribuída sob a mesma licença.
    • Específicas (ex.: MPL, algumas Creative Commons): têm requisitos particulares sobre atribuição, compatibilidade com uso comercial ou forma de distribuição.

4. Conectando o repositório ao seu projeto local

O repositório criado no GitHub e aquele que você já criou localmente (lá em Controle de arquivos) ainda não estão conectados. Precisamos criar uma ponte entre eles. Você pode fazer isso a partir do:

Na primeira vez que você interagir com um repositório remoto no seu computador, seja com push, pull, clone ou qualquer outro comando, pode aparecer uma tela pedindo suas credenciais. É isso que acontece:

Tela de autenticação

Copie o endereço HTTPS do repositório (botão "Code" na página do repositório) e rode: 

git remote add origin https://github.com/usuario/nome-repositorio.git
git push origin main
Desde copiar o link até um segundo push

5. Clonando um repositório existente

Depois que o repositório local é conectado e enviado para o GitHub (seção anterior), ele já tem conteúdo lá. Clonar traz esse repositório direto para o seu computador, já conectado com o remoto, útil quando você troca de máquina ou alguém mais entra no projeto: 

git clone https://github.com/usuario/nome-repositorio.git .
Clonando o repositório que já recebeu o push anterior
README ⟶