<h1 style="text-align:center;">Primeiros Passos no Git / GitHub</h1>

 Obviamente o primeiro passo é instalar (caso já não esteja instalado) o Git.

No caso de usuários Linux, 99% de chances de já vir instalado por padrão.

Não vou entrar em detalhes de comandos, serei direto e conciso.

Pela linha de comando, acessar a pasta onde encontra-se seu projeto.

cd /<caminho>/<do>/<projeto> 

Agora é configurar a conta para trabalhar com o Git. Existe a configuração local, mas usarei a global para simplificar.

git config --global user.name "<meu nome>"
git config --global user.email "<meu@email.com>"

Agora é iniciar o repositório Git.

Estando dentro da pasta do projeto digite:

git init

Feito isto, será criada a pasta oculta ".git". Pronto! Já temos um controle de versionamento git.

A seguir temos 2 passos que são opcionais, ou seja, não são obrigatórios, mas para alguns pode ser interessante.

1º - criar um README.MD. É um arquivo do tipo readme em markdown. Existem editores para salvar arquivos em markdown, é só escolher e utilizar o de sua preferência.

2º - criar o arquivo .gitignore (sem extensão mesmo). Caso haja arquivos que não deseje ou necessitem ser incluídos no versionamento, acrescente-os neste arquivo. Uma linha para cada arquivo ou diretório que não quer incluir.

Exemplo:

Arquivo1
Arquivo2
Pasta1
Pasta2/subpasta/*.extensão -> sim, você pode usar curingas.

Para salvar o versionamento são 2 passos:

1º - passar os arquivos para a "stage area". É uma área para "pré-salvamento". Você irá selecionar os arquivos para serem salvos.

Estando dentro da pasta digite "git add ." ou "git add --all". Os 2 comandos incluirão todos os arquivos na stage area (menos aqueles informados no gitignore).

Pode-se informar arquivo por arquivo: git add <nome do arquivo> 

ou mais de 1 arquivo separados pelo espaço

git add <arquivo1> <arquivo2> <arquivoN>

usando "git status", serão exibidos os arquivos prontos para serem versionados.

Vamos então salva-los:

git commit -m "mensagem para identificar o tipo de alteração realizada para num possível futuro você reconhecer e voltar para ela."

Pronto! Primeiro versionamento realizado.

Agora vamos enviar para o GitHub. Primeiro deve-se acessar sua conta do GitHub e criar  o repositório.

Depois disso criar um token para poder realizar o "push" do seu computador para o GitHub.

Clique no seu usuário e vá em settings.

Depois Developer settings

Depois Personal access tokens -> Tokens (classic)

Botão generate new token.

Informar um nome, tempo de validade do token, e marcar as permissões que o usuário do token terá.

Feito isto, retornamos ao repositório local e usamos o seguinte comando para adicionar o repositório remoto do GitHub (geralmente chamado de origin).

git remote add origin https://github.com/<seu>/<repositório.git>




git branch -M main




git remote set-url origin https://<seu_token>@github.com/<seu>/<repositorio.git>

Por fim, o envio:

git push -u origin main

Com estes passos os arquivos devem estar no Repositório do GitHub.

Abraços e até a próxima!