Guia prático GitHub para iniciantes
- #GitHub
- #Git
1. Criando uma Conta no GitHub
- Acesse o site github.com.
- Clique em Sign up no canto superior direito e siga as instruções para criar sua conta.
- Preencha os dados e finalize a criação da conta.
2. Instalando o Git no Computador
- GitHub usa o Git, um sistema de controle de versão. Para usar o Git localmente, você precisa instalá-lo.
- Baixe o Git no site git-scm.com e siga as instruções de instalação.
- Depois de instalar, abra o Terminal (ou Prompt de Comando no Windows) e digite
git --version
para verificar se foi instalado corretamente.
3. Configurando o Git com Seu Usuário
- No terminal, configure o Git para saber seu nome e e-mail:
bash
Copiar código
git config --global user.name "Seu Nome"
git config --global user.email "seuemail@exemplo.com"
4. Criando um Novo Repositório no GitHub
- No GitHub, clique em + no canto superior direito e escolha New repository.
- Dê um nome ao seu projeto (por exemplo,
meu-primeiro-projeto
). - Escolha se o repositório será Público (qualquer um pode ver) ou Privado (somente você vê).
- Clique em Create repository para finalizar.
5. Clonando o Repositório no Seu Computador
- No seu novo repositório, clique em Code e copie o link HTTPS.
- No terminal, digite o comando para clonar o repositório (cole o link depois de
git clone
):
bash
Copiar código
git clone https://github.com/usuario/meu-primeiro-projeto.git
- Isso cria uma pasta local com o mesmo nome do repositório, onde você poderá trabalhar no seu projeto.
6. Adicionando Arquivos ao Projeto
- Coloque os arquivos do seu projeto dentro da pasta recém-criada.
- No terminal, entre na pasta do projeto:
bash
Copiar código
cd meu-primeiro-projeto
- Use o comando
git status
para ver quais arquivos estão prontos para serem enviados ao repositório.
7. Salvando Alterações (Commit) e Enviando ao GitHub
- Para adicionar os arquivos, use:
bash
Copiar código
git add .
- Faça o commit das mudanças, que é como tirar uma "foto" do estado atual do projeto:
bash
Copiar código
git commit -m "Adiciona arquivos iniciais"
- Envie as mudanças para o GitHub:
bash
Copiar código
git push origin main
8. Criando um README.md
- O
README.md
é o arquivo que explica o que seu projeto faz e como ele funciona. - Crie um arquivo chamado
README.md
dentro da pasta do projeto e adicione uma descrição do seu projeto. - Adicione e envie o
README.md
ao GitHub (usando os mesmos comandosgit add .
,git commit
egit push
).
9. Divulgando Seu Projeto
- Com o repositório configurado e com o
README.md
, você já pode divulgar o link para outras pessoas. - No seu repositório, clique no botão Settings e ative GitHub Pages para criar uma página pública (se aplicável).
- Compartilhe o link do repositório ou do GitHub Pages para divulgar seu trabalho!
E pronto! Esses são os primeiros passos para criar e divulgar seu projeto no GitHub.