Manual de Git e GitHub
Do Zero ao Repositório Remoto
1 Introdução
Bem-vindo ao Manual de Git e GitHub!
Este material foi criado para quem está começando a usar controle de versão e quer aprender de forma prática e objetiva. Não é necessário nenhum conhecimento prévio — partimos do zero e avançamos gradualmente.
1.1 Para quem é este manual?
- Estudantes e pesquisadores que querem organizar seus projetos
- Professores que desejam versionar e publicar materiais didáticos
- Cientistas de dados iniciando com boas práticas de código
- Qualquer pessoa curiosa sobre Git e GitHub
1.2 O que você vai aprender?
Este manual está organizado em uma sequência progressiva:
Preparação do ambiente
Começamos pelo básico: como usar o Terminal (linha de comando) e como instalar programas de forma eficiente usando gerenciadores de pacotes — Homebrew no Mac e winget no Windows. Essas ferramentas facilitarão todo o resto.
Fundamentos do Git
Você vai conhecer a história do Git e do GitHub, entender o que é controle de versão e aprender os conceitos fundamentais: repositório, commit, branch, merge, push, pull e outros termos que fazem parte do vocabulário diário de quem usa Git.
Prática com Git
Com os conceitos claros, partimos para a prática: instalar e configurar o Git, criar repositórios, fazer commits e sincronizar com o GitHub.
Três formas de usar Git
Este manual cobre três abordagens complementares:
- Terminal (linha de comando): a forma mais fundamental e poderosa de interagir com Git
- GitHub Desktop: interface gráfica oficial do GitHub, ideal para quem prefere clicar a digitar
- Positron IDE: integração nativa para cientistas de dados que trabalham com R e Python
Você não precisa dominar as três — escolha a que melhor se adapta ao seu fluxo de trabalho. O importante é entender os conceitos, que são os mesmos independentemente da ferramenta.
Publicação com GitHub Pages
Por fim, você aprenderá a transformar seu repositório em um site na internet usando o GitHub Pages. É a cereja do bolo: compartilhar seu trabalho com o mundo, de graça, sem complicação.
1.3 Estrutura do manual
| Capítulo | Conteúdo |
|---|---|
| 1. Terminal | Introdução à linha de comando |
| 2. Homebrew | Gerenciador de pacotes para Mac |
| 3. Winget | Gerenciador de pacotes para Windows |
| 4. Git e GitHub | História e contexto |
| 5. Conceitos do Git | Vocabulário e fundamentos |
| 6. Configuração | Instalação e primeiros passos |
| 7. GitHub Desktop | Interface gráfica |
| 8. Positron | Git integrado ao IDE |
| 9. GitHub Pages | Publicando seu site |
1.4 Como usar este manual
Cada capítulo foi pensado para ser lido em sequência, especialmente se você está começando do zero. Os capítulos iniciais preparam o terreno para os seguintes.
Se você já conhece o Terminal e já tem o Git instalado, pode ir direto para os capítulos 4 e 5 (conceitos) e depois escolher entre Terminal, GitHub Desktop ou Positron para a prática.
Este manual foi escrito para ambos os sistemas. Quando houver diferenças entre Mac e Windows, elas serão indicadas claramente. Os conceitos são os mesmos — apenas alguns comandos e atalhos mudam.
1.5 Convenções
Ao longo do texto, você encontrará:
código em linhapara comandos e nomes de arquivos- Negrito para elementos de interface (botões, menus) e nomes de ferramentas
- Itálico para ênfase e termos em inglês
Os comandos de terminal são apresentados em blocos de código:
git statusQuando um comando for diferente no Mac e no Windows, ambas as versões serão mostradas.
Caixas verdes trazem dicas e boas práticas.
Caixas amarelas alertam sobre erros comuns ou situações que exigem atenção.
Caixas azuis trazem informações complementares.
1.6 Sobre o autor
Este manual foi escrito por Henrique Alvarenga, professor na Universidade Federal de São João del-Rei (UFSJ), como material de apoio para estudantes e pesquisadores que desejam adotar boas práticas de versionamento e publicação de materiais acadêmicos.
- Site pessoal: henriquealvarenga.com
- Currículo Lattes: lattes.cnpq.br/6147640440978297
Bons estudos — e bons commits!