Fórum Unificado de Romhacking e Tradução

Neste guia, você aprenderá os passos essenciais para começar a usar o GitHub, incluindo:

• Criar um repositório
• Linkar uma pasta local a um repositório
• Adicionar e commitar alterações
• Criar um pull request

Esse tutorial visa cobrir apenas o uso mais básico do git, não tendo a pretensão de ensinar comandos avançados ou automatização, se quiserem saber mais, acessem: https://docs.github.com/pt/get-started/start-your-journey/git-and-github-learning-resources (https://docs.github.com/pt/get-started/start-your-journey/git-and-github-learning-resources).

1. Criar um Repositório no GitHub

• Acesse github.com (https://github.com) e faça login.
• Clique no botão "+" no canto superior direito e selecione "New repository".
• Dê um nome ao repositório, ex:
  Código Selecionar Expandir
  meu-projeto
• Escolha se será público (visível a todos) ou privado (somente você e colaboradores).
• Marque "Add a README file" (opcional, mas recomendado).
• Clique em "Create repository".

Pronto! Seu repositório está criado.

2. Linkar uma Pasta Local ao Repositório

Se você já tem um projeto na sua máquina e quer conectá-lo ao GitHub:

Opção A: Clonar o Repositório (se ainda não tem os arquivos localmente)

• No seu repositório no GitHub, clique em "Code" e copie o link (HTTPS ou SSH).
• Abra o terminal (Git Bash, Command Prompt, etc.) e execute:
  
  Código Selecionar Expandir
  git clone https://github.com/seu-usuario/meu-projeto.git
• Entre na pasta do projeto:
  
  Código Selecionar Expandir
  cd meu-projeto

Opção B: Inicializar Git em uma Pasta Existente

• Abra o terminal na pasta do seu projeto.
• Execute:
  
  Código Selecionar Expandir
  git init
git remote add origin https://github.com/seu-usuario/meu-projeto.git
git pull origin main # Sincroniza com o repositório remoto

3. Adicionar e Commitar Alterações

Sempre que você modificar arquivos, siga estes passos para salvar as mudanças:

• Verifique as alterações feitas:
  
  Código Selecionar Expandir
  git status
• Adicione os arquivos modificados ao staging area (preparação para commit):
  
  Código Selecionar Expandir
  git add . # Adiciona todos os arquivos alterados
ou
git add arquivo.md # Adiciona um arquivo específico
• Faça um commit (registro das alterações):
  
  Código Selecionar Expandir
  git commit -m "Descrição das mudanças"
• Envie as alterações para o GitHub:
  
  Código Selecionar Expandir
  git push origin main # Se sua branch principal for "main"

4. Criar um Pull Request (Contribuição em Projetos)

Um pull request (PR) é usado para propor mudanças em um repositório (principalmente em projetos colaborativos).
Passos para Criar um PR:

• Faça um fork do repositório original (no GitHub, clique em "Fork").
• Clone o seu fork para sua máquina:
  
  Código Selecionar Expandir
  git clone https://github.com/seu-usuario/repositorio-forkado.git
• Crie uma nova branch para suas alterações:
  
  Código Selecionar Expandir
  git checkout -b minha-feature
• Faça as alterações, commit e push:
  
  Código Selecionar Expandir
  git add .
git commit -m "Minha contribuição"
git push origin minha-feature
• No GitHub, vá até o repositório original e clique em "Pull Request".
• Descreva suas alterações e envie o PR para revisão.

No que isso pode ser útil para romhacking?

Além de manter seus arquivos salvos remotamente, evitando perdas, vocês podem criar projetos inteiros com os scripts e tools para serem traduzidos em grupo. Postei esse tutorial porque notei que não havia nada semelhante aqui no fórum, espero que seja útil.