{"id":21508584,"url":"https://github.com/harukaionasao/git_basic_tutorial","last_synced_at":"2025-03-17T14:49:50.499Z","repository":{"id":262145638,"uuid":"886175272","full_name":"HarukaIonaSao/Git_Basic_Tutorial","owner":"HarukaIonaSao","description":"Este repositório é um guia prático para iniciantes em Git e GitHub, com instruções passo a passo sobre instalação, configuração e operações básicas de controle de versão. Criado para tornar o aprendizado mais acessível, ele inclui dicas e melhores práticas para uso eficiente de repositórios.","archived":false,"fork":false,"pushed_at":"2024-11-10T19:50:38.000Z","size":222,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T01:34:31.740Z","etag":null,"topics":["beginner-friendly","beginners","configuracao","git","git-beginner","git-best-practices","git-branch","github","github-config","tutorial"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HarukaIonaSao.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-10T12:03:47.000Z","updated_at":"2024-11-10T19:50:41.000Z","dependencies_parsed_at":"2024-11-10T20:29:40.466Z","dependency_job_id":null,"html_url":"https://github.com/HarukaIonaSao/Git_Basic_Tutorial","commit_stats":null,"previous_names":["harukaionasao/git_basic_tutorial"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaIonaSao%2FGit_Basic_Tutorial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaIonaSao%2FGit_Basic_Tutorial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaIonaSao%2FGit_Basic_Tutorial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HarukaIonaSao%2FGit_Basic_Tutorial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HarukaIonaSao","download_url":"https://codeload.github.com/HarukaIonaSao/Git_Basic_Tutorial/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244055777,"owners_count":20390716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beginner-friendly","beginners","configuracao","git","git-beginner","git-best-practices","git-branch","github","github-config","tutorial"],"created_at":"2024-11-23T21:06:57.474Z","updated_at":"2025-03-17T14:49:50.464Z","avatar_url":"https://github.com/HarukaIonaSao.png","language":null,"readme":"# 📓 Guia Completo de Configuração do Git e Integração com GitHub\n\n\u003e  **Este guia ajuda você a configurar o Git com HTTPS e SSH e a vincular seu repositório local ao GitHub.**\n\n\n\u003cdiv class=\"link-container\" style=\"text-align: center;\"\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic/blob/main/README.MD#passo-1-instale-o-git\" style=\"text-decoration: none;\" \u003eInstalação\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic/blob/main/README.MD#passo-2-configure-usu%C3%A1rio-e-e-mail-no-git\" style=\"text-decoration: none;\"\u003eConfiguração\u003c/a\u003e\u003cbr\u003e  \n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#autentica%C3%A7%C3%A3o-no-github-https-ou-ssh\" style=\"text-decoration: none;\"\u003eAutenticação\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#vincular-o-reposit%C3%B3rio-local-ao-github\" style=\"text-decoration: none;\"\u003eRepositório remoto\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#%EF%B8%8F-substitui%C3%A7%C3%A3o-da-branch-master\" style=\"text-decoration: none;\"\u003eBranch master\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#-passo-a-passo-subindo-c%C3%B3digo-para-o-github\" style=\"text-decoration: none;\"\u003eSubir o código para o GitHub\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#passo-4-como-gerenciar-o-reposit%C3%B3rio\" style=\"text-decoration: none;\"\u003eAlterações no código\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#4-como-realizar-o-commit\" style=\"text-decoration: none;\"\u003eCommits\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#3-usando-commits-sem%C3%A2nticos\" style=\"text-decoration: none;\"\u003eCommits Semânticos\u003c/a\u003e\u003cbr\u003e\n    \u003ca href=\"https://github.com/HarukaIonaSao/Git_Basic_Tutorial/tree/main?tab=readme-ov-file#resumo-do-processo\" style=\"text-decoration: none;\"\u003eResumo\u003c/a\u003e\n\u003c/div\u003e\n\n \n## Passo 1: Instale o Git\n\nSe ainda não tem o Git, faça o download pelo [site oficial do Git](https://git-scm.com/) e siga as instruções de instalação.\n\nVerifique a instalação com:\n\n```bash\ngit --version\n```\n\n## Passo 2: Configure Usuário e E-mail no Git\n\n⚠️ **Importante**: O e-mail usado aqui deve ser o mesmo que está associado à sua conta GitHub para garantir a autenticação e associação correta dos commits.\n\n### Configuração Global (Para Todos os Repositórios na Máquina)\n\nUse `--global` para que o nome e e-mail sejam aplicados a todos os repositórios da sua máquina:\n\n```bash\ngit config --global user.name \"Seu Nome\"\ngit config --global user.email \"seu-email@example.com\"\n```\n\n### Configuração Local (Para um Repositório Específico)\n\nPara definir nome e e-mail apenas para um repositório, navegue até o diretório desse repositório e use os mesmos comandos **sem** o `--global`:\n\n```bash\ncd caminho/do/seu/repositorio\ngit config user.name \"Nome Específico\"\ngit config user.email \"email-especifico@exemplo.com\"\n```\n\n\u003e 🤓 **Dica**: Isso é útil para projetos que exigem configurações diferentes (como um e-mail de trabalho e outro pessoal).\n\nPara verificar as configurações e suas origens, use:\n\n```bash\ngit config --list --show-origin\n```\n\n---\n\n## Autenticação no GitHub: HTTPS ou SSH\n\nVocê pode autenticar no GitHub de duas maneiras: **com HTTPS (token de acesso)** ou **com SSH (chave SSH)**.\n\n---\n\n### Opção 1: Autenticação com HTTPS (Token de Acesso Pessoal)\n\n1. **Crie um Token de Acesso no GitHub**:\n   - Vá para [Configurações do GitHub](https://github.com/settings/tokens) \u003e **Developer settings** \u003e **Personal access tokens** \u003e **Tokens classic** \u003e **Generate new token**.\n   - Escolha as permissões necessárias e clique em **Generate token**. **Guarde o token** em local seguro, pois ele será exibido apenas uma vez.\n\n2. **Clonar o Repositório com HTTPS**:\n   Use o URL no formato HTTPS ao clonar um repositório do GitHub:\n\n   ```bash\n   git clone https://github.com/username/repo-name.git\n   ```\n\n3. **Autenticar com o Token**:\n   - Quando solicitado por nome de usuário e senha, insira seu **nome de usuário do GitHub** e o **token de acesso** como senha.\n   - Para evitar digitar o token sempre, configure o gerenciador de credenciais do Git:\n\n     ```bash\n     git config --global credential.helper cache\n     ```\n\n---\n\n### Opção 2: Autenticação com SSH (Chave SSH)\n\n1. **Gerar uma Chave SSH**:\n   No terminal, execute o seguinte comando (substitua o e-mail pelo seu):\n\n   ```bash\n   ssh-keygen -t ed25519 -C \"seu-email@example.com\"\n   ```\n\n   - Pressione Enter para aceitar o local padrão para salvar a chave.\n   - Opcionalmente, adicione uma senha para segurança adicional.\n\n2. **Adicionar a Chave SSH ao `ssh-agent`**:\n   No terminal, execute:\n\n   ```bash\n   eval \"$(ssh-agent -s)\"\n   ssh-add ~/.ssh/id_ed25519\n   ```\n\n3. **Adicionar a Chave SSH ao GitHub**:\n   - Copie a chave pública (parte `.pub`) com:\n\n     ```bash\n     cat ~/.ssh/id_ed25519.pub\n     ```\n\n   - No GitHub, vá até [Configurações de Chaves SSH](https://github.com/settings/keys) \u003e **SSH and GPG keys** \u003e **New SSH key** e cole a chave pública.\n\n4. **Clonar o Repositório com SSH**:\n   Após configurar a chave SSH, clone o repositório usando o link SSH:\n\n   ```bash\n   git clone git@github.com:username/repo-name.git\n   ```\n\n5. **Testar a Conexão SSH**:\n   Verifique se o GitHub reconhece sua chave SSH:\n\n   ```bash\n   ssh -T git@github.com\n   ```\n\n---\n\n## Vincular o Repositório Local ao GitHub\n\nCaso tenha um repositório local que deseja vincular ao GitHub, siga estes passos:\n\n1. **Adicione o Repositório Remoto**:\n\n   - **Com HTTPS**:\n\n     ```bash\n     git remote add origin https://github.com/username/repo-name.git\n     ```\n\n   - **Com SSH**:\n\n     ```bash\n     git remote add origin git@github.com:username/repo-name.git\n     ```\n\n2. **Enviar o Código para o GitHub**:\n\n   Depois de adicionar o repositório remoto, você pode enviar seus commits para o GitHub:\n\n   ```bash\n   git push -u origin main\n   ```\n\n\u003e 📝 **Nota**: Substitua `main` pelo nome da sua branch principal, caso seja diferente.\n\n---\n\n### ⚠️ **Substituição da Branch `master`**\n\nA **branch `master`** foi historicamente o nome padrão para a branch principal de repositórios Git, mas nos últimos anos, devido a preocupações com a terminologia, muitas plataformas e projetos decidiram descontinuar o uso da branch `master` em favor de nomes mais neutros, como **`main`**, **`primary`** ou outros termos. A mudança está sendo promovida para refletir uma linguagem mais inclusiva e respeitosa em relação a questões sociais.\n\n#### 🌍 **Motivos para a Mudança**\nO uso do termo `master` foi associado a conotações históricas que não são mais vistas como apropriadas em um contexto moderno e inclusivo. Para promover um ambiente mais acolhedor e livre de termos potencialmente problemáticos, a indústria de software começou a substituir a branch `master` por uma alternativa mais neutra.\n\n#### 🔄 **Impacto da Mudança**\n- **GitHub e outras plataformas**: O GitHub, GitLab e outras plataformas populares começaram a adotar **`main`** como o nome padrão para a branch principal em novos repositórios. Isso significa que quando você cria um novo repositório, a branch principal automaticamente será nomeada como `main`, em vez de `master`. Para saber mais, acesse o [site](https://github.com/github/renaming) oficial ou leia esse [arquivo](https://medium.com/rd-shipit/por-que-tamb%C3%A9m-estamos-trocando-o-nome-de-nossa-branch-principal-de-master-para-main-744b9d9b1af2). \n  \n- **Migração**: Para repositórios já existentes, a mudança não é obrigatória. Contudo, é altamente recomendada para que os projetos sigam as melhores práticas inclusivas e estejam alinhados com as diretrizes mais recentes. O GitHub, por exemplo, oferece uma maneira simples de renomear a branch `master` para `main` sem afetar o histórico do projeto.\n\n#### 🛠️ **Como Renomear a Branch `master` para `main`**\n\nSe você está mantendo um repositório que usa `master` e deseja mudar para `main`, pode fazer isso facilmente com os seguintes comandos Git:\n\n1. **Renomeie a branch local**:\n   ```bash\n   git branch -m master main\n   ```\n\n2. **Atualize o repositório remoto**:\n   Após renomear a branch local, você precisará fazer a atualização no repositório remoto (GitHub, GitLab, etc.):\n\n   ```bash\n   git push -u origin main\n   ```\n\n3. **Altere a branch padrão no GitHub**:\n   - Vá para seu repositório no GitHub.\n   - Clique em **Settings** \u003e **Branches**.\n   - Em \"Default branch\", altere de `master` para `main`.\n\n4. **Excluir a antiga branch `master` no repositório remoto** (se desejado):\n   Após garantir que tudo está funcionando com a nova branch, você pode excluir a `master` remota para evitar confusão:\n\n   ```bash\n   git push origin --delete master\n   ```\n\n#### 📅 **Quando Isso Acontece?**\nEmbora o GitHub tenha iniciado a mudança em 2020, o processo de substituição do uso de `master` como padrão ainda está em andamento. Muitos projetos ainda estão em transição, mas a tendência é que o uso de `master` diminua ao longo do tempo, com a maioria dos novos repositórios já adotando `main` ou outro nome neutro como padrão.\n\n#### 📝 **Resumindo**\nEmbora a mudança não seja obrigatória para repositórios antigos, é importante adotar uma terminologia mais inclusiva, alinhada com as melhores práticas da comunidade. Se você ainda usa `master`, considere renomeá-la para `main` para garantir que seu projeto esteja alinhado com a evolução da linguagem e as práticas modernas de desenvolvimento.\n\n---\n\n# 🚀 **Passo a Passo: Subindo Código para o GitHub**\n\n## Passo 1: Criar uma Conta no GitHub\n\n1. **Acesse o site**: [https://github.com](https://github.com).\n2. **Clique em \"Sign up\"** no canto superior direito.\n3. **Preencha o formulário** com seu nome, e-mail, senha e clique em **\"Create account\"**.\n4. Siga as instruções para concluir o processo de configuração da sua conta (verificação de e-mail, escolha do plano, etc.).\n\n---\n\n## Passo 2: Estrutura do Projeto\n\nVamos simular a estrutura de um projeto simples com uma pasta `source` e um arquivo `index.html`.\n\n```\nmeu-projeto/\n│\n├── source/\n│   └── style.css\n│__ index.html\n└── README.md\n```\n\n### Código de exemplo no `index.html`:\n\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"pt-br\"\u003e\n\u003chead\u003e\n    \u003cmeta charset=\"UTF-8\"\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"\u003e\n    \u003ctitle\u003eMeu Projeto\u003c/title\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n    \u003ch1\u003eBem-vindo ao Meu Projeto!\u003c/h1\u003e\n    \u003cp\u003eEste é um projeto simples que estou subindo para o GitHub.\u003c/p\u003e\n\u003c/body\u003e\n\u003c/html\u003e\n```\n\n---\n\n## Passo 3: Subindo o Código para o GitHub\n\n### **Método 1: Usando o Git Bash, Terminal ou PowerShell**\n\n1. **Abra o terminal**:\n   - **Git Bash**: Clique com o botão direito na pasta do seu projeto e selecione **Git Bash Here**.\n   - **Terminal (macOS/Linux)** ou **PowerShell (Windows)**: Abra a janela do terminal na pasta onde está o projeto.\n\n2. **Inicialize o repositório Git**:\n   No terminal, navegue até a pasta do seu projeto e execute o comando para inicializar o repositório:\n\n   ```bash\n   git init\n   ```\n\n3. **Adicione os arquivos ao Git**:\n   Adicione todos os arquivos do projeto ao Git:\n\n   ```bash\n   git add .\n   ```\n\n4. **Crie o primeiro commit**:\n   Execute o commit inicial com uma mensagem explicativa:\n\n   ```bash\n   git commit -m \"Primeiro commit - subindo o projeto para o GitHub\"\n   ```\n\n5. **Adicione o repositório remoto**:\n   Crie um repositório no GitHub e copie a URL do repositório (por exemplo, `https://github.com/username/nome-do-repositorio.git`).\n\n   Adicione o repositório remoto:\n\n   ```bash\n   git remote add origin https://github.com/username/nome-do-repositorio.git\n   ```\n\n6. ** Enviar o Código para o GitHub**:\n   - Acesse seu GitHub e crie um novo repositório clicando no botão **\"New repository\"**.\n   - **Dica**: O GitHub agora usa a **branch `main`** por padrão para novos repositórios, então o nome da branch principal será automaticamente **`main`**.\n\n2. **Adicionar o repositório remoto**:\n   No seu terminal, depois de criar o repositório no GitHub, adicione o repositório remoto:\n\n   ```bash\n   git remote add origin https://github.com/username/nome-do-repositorio.git\n   ```\n\n3. **Envie os arquivos para o GitHub**:\n   Agora, envie seu código para o repositório remoto. Se você estiver usando a **branch `main`**, execute o comando:\n\n   ```bash\n   git push -u origin main\n   ```\n\n   Caso esteja usando **`master`**, o comando será:\n\n   ```bash\n   git push -u origin master\n   ```\n\n   \u003e ⚠️ **Atenção**: Se o repositório já tiver sido criado com a branch `master`, você precisa renomear essa branch para `main`, como discutido anteriormente, para seguir as melhores práticas. **O GitHub e outras plataformas estão movendo-se em direção a uma terminologia mais inclusiva**, substituindo `master` por `main`.\n\n---\n\n### **Método 2: Usando o Gerenciador de Arquivos**\n\nSe você preferir uma interface gráfica, pode fazer isso sem usar o terminal. Embora a maneira mais comum de interagir com Git seja por meio da linha de comando, o GitHub permite carregar arquivos diretamente pela interface web.\n\n1. **Crie o repositório no GitHub**:\n   - Vá para [GitHub](https://github.com) e faça login.\n   - Clique em **+** no canto superior direito e selecione **New repository**.\n   - Dê um nome ao seu repositório e clique em **Create repository**.\n\n2. **Faça o upload dos arquivos**:\n   - No seu repositório no GitHub, clique em **Upload files**.\n   - Arraste e solte os arquivos do seu projeto ou use o botão **choose your files** para selecionar os arquivos.\n   - Clique em **Commit changes** para enviar os arquivos.\n\n\u003e 💡 **Dica**: Embora essa opção seja fácil, ela não é ideal para grandes projetos ou quando você precisar gerenciar várias versões de arquivos. O uso do Git Bash ou GitHub Desktop é recomendado para projetos mais avançados.\n\n---\n\n## Passo 4: Como Gerenciar o Repositório\n\nApós subir o projeto para o GitHub, você pode começar a gerenciar o código de várias maneiras:\n\n### **Fazendo alterações e subindo novamente**\n\n1. **Faça alterações no código** (por exemplo, edite `index.html`).\n2. No terminal, adicione as alterações:\n\n   ```bash\n   git add .\n   ```\n\n3. **Comite as mudanças**:\n\n   ```bash\n   git commit -m \"Alterações no index.html\"\n   ```\n\n4. **Envie para o GitHub**:\n\n   ```bash\n   git push origin main\n   ```\n\nAgora, o GitHub estará atualizado com as últimas alterações feitas no código.\n\n---\n\n## **Resumo do Processo:**\n\n1. **Criar conta no GitHub**: Crie um perfil no GitHub para hospedar seus repositórios.\n2. **Estruturar o projeto**: Crie a estrutura de pastas e arquivos.\n3. **Subir para o GitHub**:\n   - Usando **Git Bash/Terminal/PowerShell** ou o **Gerenciador de Arquivos** no GitHub.\n4. **Gerenciar alterações**: Use o Git para adicionar, commitar e enviar novas versões para o GitHub.\n\nAgora você está pronto para usar o Git e o GitHub de forma eficiente para gerenciar seus projetos! 🚀\n\nPara garantir que suas alterações no código sejam bem organizadas e compreensíveis, é importante seguir boas práticas de **commit**. Isso inclui **fazer commits de forma frequente** e **usando commits semânticos**.\n\n---\n\n# 💻 **Como Fazer Alterações no Código e Commitar na Frequência Correta**\n\n## 1. **Fazendo Alterações no Código**\n\nSempre que você realizar alguma alteração no código, como adicionar uma nova funcionalidade, corrigir um bug ou refatorar uma parte do código, faça isso de forma **incremental**. Isso significa que você não deve esperar até que o código esteja completamente finalizado para fazer um commit. \n\nÉ recomendado **realizar commits pequenos e frequentes**. Isso permite que o histórico do seu projeto seja claro, e facilita a identificação de problemas, caso algum erro aconteça após a alteração.\n\nPor exemplo, se você está trabalhando em uma página de login, você pode:\n\n- Fazer um commit para **adicionar o formulário de login**.\n- Fazer outro commit para **validar os campos do formulário**.\n- Fazer um terceiro commit para **conectar o formulário com a API de login**.\n\nIsso torna o histórico de commits mais legível e facilita o processo de revisão de código.\n\n---\n\n## 2. **Commits na Frequência Correta**\n\nEvite fazer commits grandes que englobam múltiplas alterações. Em vez disso, **faça commits de forma regular**, de preferência **sempre que terminar uma tarefa ou uma unidade de trabalho específica**. \n\nAqui estão algumas situações em que é adequado fazer um commit:\n\n- **Após adicionar uma nova funcionalidade** (ex.: \"Adicionar formulário de login\").\n- **Após corrigir um bug** (ex.: \"Corrigir erro na validação do e-mail\").\n- **Após refatorar ou melhorar o código** (ex.: \"Refatorar função de validação do formulário\").\n- **Após testes ou ajustes** (ex.: \"Ajustar layout da página de login para mobile\").\n\nIsso ajuda a manter o histórico do projeto claro e organizado, além de permitir reverter facilmente a qualquer ponto anterior, caso necessário.\n\n---\n\n## 3. **Usando Commits Semânticos**\n\nOs **commits semânticos** seguem uma convenção específica para que o significado de cada commit seja claro. Em vez de apenas escrever algo como \"Alterações no código\", você deve usar **mensagens de commit mais descritivas** e estruturadas, com base no tipo de alteração que está sendo feita.\n\nAqui estão os principais tipos de commits semânticos:\n\n- **feat**: Adição de nova funcionalidade ao código (ex.: \"feat: adicionar formulário de login\").\n- **fix**: Correção de um bug no código (ex.: \"fix: corrigir erro de validação do e-mail\").\n- **docs**: Modificações na documentação do projeto (ex.: \"docs: atualizar README com instruções de instalação\").\n- **style**: Alterações que não afetam a lógica do código, como mudanças de estilo (ex.: \"style: ajustar indentação e espaçamento\").\n- **refactor**: Alterações no código que não adicionam funcionalidades nem corrigem bugs, mas melhoram a estrutura (ex.: \"refactor: melhorar a legibilidade da função de validação\").\n- **test**: Alterações relacionadas a testes (ex.: \"test: adicionar testes para a função de login\").\n- **chore**: Alterações que não se encaixam em outras categorias (ex.: \"chore: atualizar dependências do projeto\").\n\n### Exemplo de commits semânticos:\n\n```bash\ngit commit -m \"feat: adicionar página de login\"\ngit commit -m \"fix: corrigir erro no envio de dados do formulário\"\ngit commit -m \"docs: atualizar o README com informações de configuração\"\ngit commit -m \"style: corrigir indentação na função de validação\"\n```\n\nVocê pode ler mais sobre **commits semânticos** e sua importância neste repositório:\n\n👉 [Commits Semânticos - GitHub](https://github.com/HarukaIonaSao/Commits-semanticos)\n\n---\n\n## 4. **Como Realizar o Commit**\n\nApós fazer as alterações no seu código, você precisa **adicionar os arquivos modificados** ao Git e **fazer o commit**.\n\n### Passos para adicionar e subir as alterações:\n\n1. **Adicionar os arquivos alterados**:\n\n   ```bash\n   git add .\n   ```\n\n2. **Fazer o commit com uma mensagem semântica**:\n\n   ```bash\n   git commit -m \"feat: adicionar a página de login\"\n   ```\n\n3. **Enviar as alterações para o repositório remoto no GitHub**:\n\n   ```bash\n   git push origin main\n   ```\n\n---\n\n## 5. **Por que é Importante Seguir essas Práticas?**\n\n- **Histórico de código mais claro**: Facilita o entendimento das mudanças feitas no projeto, especialmente em equipes.\n- **Facilidade de reversão**: Com commits pequenos e claros, é mais fácil reverter alterações específicas.\n- **Melhoria na colaboração**: Equipes podem trabalhar de forma mais eficiente com um histórico de commits bem estruturado.\n- **Automação e integrações**: Algumas ferramentas, como CI/CD (Integração Contínua/Entrega Contínua), podem se beneficiar de mensagens de commit claras e bem estruturadas para automatizar o fluxo de trabalho.\n\n---\n| **Passo** | **Descrição**                                                                                             | **Comando/Link**                                                                                                                                  |\n|-----------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| **1**     | Instalar o Git                                                                                             | [Site oficial do Git](https://git-scm.com/)                                                                                                    |\n| **2**     | Configurar Usuário e E-mail no Git (Global)                                                                 | `git config --global user.name \"Seu Nome\"`\u003cbr\u003e`git config --global user.email \"seu-email@example.com\"`                                           |\n| **3**     | Configurar Usuário e E-mail no Git (Local)                                                                  | `cd caminho/do/seu/repositorio`\u003cbr\u003e`git config user.name \"Nome Específico\"`\u003cbr\u003e`git config user.email \"email-especifico@exemplo.com\"`           |\n| **4**     | Verificar Configurações do Git                                                                                | `git config --list --show-origin`                                                                                                                |\n| **5**     | Autenticação no GitHub via HTTPS (Token de Acesso)                                                         | [Criar Token no GitHub](https://github.com/settings/tokens)\u003cbr\u003e`git clone https://github.com/username/repo-name.git`\u003cbr\u003e`git config --global credential.helper cache` |\n| **6**     | Autenticação no GitHub via SSH (Chave SSH)                                                                  | `ssh-keygen -t ed25519 -C \"seu-email@example.com\"`\u003cbr\u003e`eval \"$(ssh-agent -s)\"`\u003cbr\u003e`ssh-add ~/.ssh/id_ed25519`\u003cbr\u003e[Adicionar chave SSH ao GitHub](https://github.com/settings/keys) |\n| **7**     | Clonar Repositório com HTTPS                                                                                 | `git clone https://github.com/username/repo-name.git`                                                                                            |\n| **8**     | Clonar Repositório com SSH                                                                                   | `git clone git@github.com:username/repo-name.git`                                                                                               |\n| **9**     | Vincular Repositório Local ao GitHub (HTTPS)                                                                 | `git remote add origin https://github.com/username/repo-name.git`                                                                                |\n| **10**    | Vincular Repositório Local ao GitHub (SSH)                                                                   | `git remote add origin git@github.com:username/repo-name.git`                                                                                  |\n| **11**    | Enviar Código para o GitHub                                                                                 | `git push -u origin main`                                                                                                                       |\n| **12**    | Renomear Branch `master` para `main` (opcional)                                                              | `git branch -m master main`\u003cbr\u003e`git push -u origin main`\u003cbr\u003e`git push origin --delete master`                                                   |\n| **13**    | Testar Conexão SSH                                                                                          | `ssh -T git@github.com`                                                                                                                         |\n| **14**    | Criar Conta no GitHub                                                                                        | [Criar conta no GitHub](https://github.com)                                                                                                    |\n| **15**    | Estrutura de Projeto Simulada                                                                                | Ver estrutura: `meu-projeto/source/index.html`                                                                                                 |\n| **16**    | Inicializar Repositório Git                                                                                 | `git init`                                                                                                                                      |\n| **17**    | Adicionar Arquivos ao Git                                                                                    | `git add .`                                                                                                                                     |\n| **18**    | Fazer o Primeiro Commit                                                                                     | `git commit -m \"Primeiro commit - subindo o projeto para o GitHub\"`                                                                             |\n| **19**    | Adicionar Repositório Remoto                                                                                 | `git remote add origin https://github.com/username/nome-do-repositorio.git`                                                                    |\n\n\n\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharukaionasao%2Fgit_basic_tutorial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharukaionasao%2Fgit_basic_tutorial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharukaionasao%2Fgit_basic_tutorial/lists"}