LogoLogo
  • Git e GitHub para Humanos
  • Sumário
  • 1. Antes de Começar
    • 1.1 Este livro é para você?
    • 1.2 A razão por trás deste livro
    • 1.3 Visão geral
    • 1.4 Sobre o GitHub
    • 1.5 Sobre a Cumbuca Dev
    • 1.6 O maravilhoso mundo do open source
    • 1.7 Mapa do livro
    • 1.8 Glossário: capítulo 1
  • 2. Fundamentos de Controle de Versão e Git
    • 2.1 Introdução a sistemas de controle de versão
      • 2.1.1 Sistemas de controle de versão centralizados
      • 2.1.2 Sistemas de controle de versão distribuídos
    • 2.2 Introdução ao Git
    • 2.3 Conceitos Fundamentais do Git
      • 2.3.1 Repositório
      • 2.3.2 Commit
      • 2.3.3 Branch
      • 2.3.4 Merge
    • 2.4 Instalando o Git
      • 2.4.1 Instalando no Linux
      • 2.4.2 Instalando no macOS
      • 2.4.3 Instalando no Windows
    • 2.5 Interagindo com o Git
    • 2.6 O Comando Git
    • 2.7 Inicializando de um Repositório Local
    • 2.8 Configurando de um Repositório Local
    • 2.9 Links Úteis: Capítulo 2
    • 2.10 Glossário: Capítulo 2
  • 3. Operações Locais Básicas no Git
    • 3.1 Explorando Operações Locais do Git
    • 3.2 Salvando Alterações Localmente
      • 3.2.1 Adicionando Arquivos ao Controle de Versão via `git add`
      • 3.2.2 Verificando o Estado do Repositório via `git status`
      • 3.2.3 Criando Commits via `git commit`
      • 3.2.4 Visualizando o Histórico do Repositório via `git log`
      • 3.2.5 Comparando Alterações via `git diff`
      • 3.2.6 Unindo os Pontos
      • 3.2.7 Exemplo Prático
    • 3.3 Trabalhando com Branches Localmente
      • 3.3.1 Gerenciando Branches via `git branch`
      • 3.3.2 Alternando Entre Branches via `git switch`
      • 3.3.3 Mesclando Branches via `git merge`
        • 3.3.3.1 Resolvendo Conflitos de Merge
      • 3.3.4 Unindo os Pontos
      • 3.3.5 Exemplo Prático
    • 3.4 Links Úteis: Capítulo 3
    • 3.5 Glossário: Capítulo 3
  • 4. Ajuste de Mudanças Locais no Git
    • 4.1 Desfazendo Alterações Localmente
      • 4.1.1 Desfazendo Alterações Antes do Commit
      • 4.1.2 Desfazendo Commits
      • 4.1.3 Alterando o Último Commit via `git commit --amend`
      • 4.1.4 Unindo os Pontos
      • 4.1.5 Exemplos Práticos
    • 4.2 Ignorando e Removendo Arquivos do Rastreamento Local
      • 4.2.1 Ignorando Arquivos do Rastreamento Utilizando o arquivo .gitignore
      • 4.2.2 Removendo Arquivos do Rastreamento via `git rm`
    • 4.3 Links Úteis: Capítulo 4
    • 4.4 Glossário: Capítulo 4
  • 5. Introdução ao GitHub
    • 5.1 Qual a diferença entre Git e GitHub?
    • 5.2 Grandes Projetos Abertos no GitHub
    • 5.3 Recursos do GitHub
    • 5.4 Idioma Suportado no GitHub
    • 5.5 Contas no GitHub
      • 5.5.1 Conta Pessoal
      • 5.5.2 Conta de Organização
      • 5.5.3 Conta Corporativa
      • 5.5.4 Unindo os Pontos
    • 5.6 Planos do GitHub
    • 5.7 Criando uma Conta Pessoal no GitHub
    • 5.8 Explorando a Interface do GitHub
      • 5.8.1 Página Principal (Home)
      • 5.8.2 Página de Notificações (Notifications)
      • 5.8.3 Página de Configurações (Settings)
    • 5.9 Links Úteis: Capítulo 5
    • 5.10 Glossário: Capítulo 5
  • 6. Repositórios no GitHub
    • 6.1 O quê é um Repositório no GitHub?
    • 6.2 Criando um Repositório no GitHub
    • 6.3 Página Principal de um Repositório: Aba Code
      • 6.3.1 Editando um Arquivo em um Repositório no GitHub
      • 6.3.2 Explorando o Histórico de Commits de um Repositório no GitHub
      • 6.3.3 Editando Detalhes de um Repositório no GitHub
      • 6.3.4 Explorando um Repositório Ativo em Uso
    • 6.4 Página de Configurações de um Repositório: Aba Settings
      • 6.4.1 Gerenciando Configurações Gerais de um Repositório no GitHub: Menu General
      • 6.4.2 Gerenciando Configurações de Colaboração de um Repositório no GitHub: Menu Collaborators
      • 6.4.3 Explorando Configurações de um Repositório no GitHub na Prática
    • 6.5 Links Úteis: Capítulo 6
    • 6.6 Glossário: Capítulo 6
  • 7. Documentação de Projetos
    • 7.1 O quê é Documentação de Projeto?
    • 7.2 Explorando a Linguagem de Marcação Markdown
    • 7.3 Criando uma Página de Apresentação no GitHub
    • 7.4 Links Úteis: Capítulo 7
    • 7.5 Glossário: Capítulo 7
  • 8. Issues no GitHub
    • 8.1 O quê é GitHub Issues?
    • 8.2 Criando uma Issue no GitHub
    • 8.3 Explorando a Página de uma Issue no GitHub
    • 8.4 Atribuindo uma Issue no GitHub
    • 8.5 Categorizando Issues de um Repositório através de Labels no GitHub
      • 8.5.1 Gerenciando Labels de um Repositório no GitHub
    • 8.6 Página de Issues de um Repositório no GitHub: Aba Issues
    • 8.7 Explorando Issues no Mundo Real
    • 8.8 Links Úteis: Capítulo 8
    • 8.9 Glossário: Capítulo 8
  • 9. Git Remoto
    • 9.1 Explorando Operações Remotas do Git
    • 9.2 Interagindo com o Repositório Remoto Central no Git
      • 9.2.1 Clonando um Repositório Remoto via `git clone`
      • 9.2.2 Buscar Atualizações de um Repositório Remoto via `git fetch`
      • 9.2.3 Enviando Mudanças Locais para o Repositório Remoto via `git push`
      • 9.2.4 Sincronizando o Repositório Local com o Remoto via `git pull`
      • 9.2.5 Unindo os Pontos
      • 9.2.6 Exemplo
    • 9.3 Interagindo com o Repositório Remoto hello-world
      • 9.3.1 Conectando-se ao GitHub via SSH
      • 9.3.2 Clonando o Repositório hello-world
      • 9.3.3 Alterando hello-world Localmente
        • 9.3.3.1 Editor de Código
        • 9.3.3.2 Editando README.md
        • 9.3.3.3 Salvando Alterações no Controle de Versão Local
      • 9.3.4 Enviando Alterações para o Repositório Remoto
    • 9.4 Links Úteis: Capítulo 9
    • 9.5 Glossário: Capítulo 9
  • 10. Pull Requests no GitHub
    • 10.1 O quê é um Pull Requests no GitHub?
    • 10.2 Entendendo as Propriedades de um Pull Request no GitHub
      • 10.2.1 Branches de Origem e de Destino de um Pull Request
      • 10.2.2 Título de um Pull Request
      • 10.2.3 Descrição de um Pull Request
      • 10.2.4 Modificações de um Pull Request
      • 10.2.5 Pessoas Revisoras de um Pull Request
      • 10.2.6 Labels de um Pull Request
    • 10.3 Criando um Pull Request no GitHub
    • 10.4 Página de um Pull Request no GitHub
      • 10.4.1 Aba Conversation
      • 10.4.2 Aba Commits
      • 10.4.3 Aba Checks
      • 10.4.4 Aba Files Changed
    • 10.5 Página de Pull Requests de um Repositório no GitHub: Aba Pull Requests
    • 10.6 Recebendo Revisões em um Pull Request no GitHub
      • 10.6.1 Boas Práticas
      • 10.6.2 Exemplo Prático
        • 10.6.2.1 Adicionando Conta Colaboradora
        • 10.6.2.2 Solicitando Revisão de Pull Request
        • 10.6.2.3 Lidando com o Feedback
    • 10.7 Mesclando um Pull Request no GitHub
      • 10.7.1 Exemplo Prático
    • 10.8 Atualizando um Repositório Local Após Mesclagem
    • 10.9 Explorando Pull Requests no Mundo Real
    • 10.10 Links Úteis: Capítulo 10
    • 10.11 Glossário: Capítulo 10
  • 11. Fluxo de Trabalho
    • 11.1 Fork no GitHub
      • Fork
    • 11.2 Forks e Pull Requests
      • 11.2.1 Criando um Fork no GitHub
      • 11.2.2 Clonando um Fork
      • 11.2.3 Realizando Alterações Localmente
      • 11.2.4 Enviando Alterações Locais para o Fork Remoto
      • 11.2.5 Criando um Pull Request a partir de um Fork no GitHub
      • 11.2.6 Sincronizando um Fork no GitHub
      • 11.2.7 Revisão, Mesclagem e Atualizações Pós-mesclagem
    • 11.3 Fluxo de Trabalho
  • 11.4 Links Úteis - Capítulo 11
  • 11.5 Glossário - Capítulo 11
  • 12. O Caminho Continua
    • 12.1 Conhecendo Ferramentas Adicionais
      • 12.1.1 Indicação: Jogo Oh My Git
    • 12.2 Explorando Projetos Open Source
    • 12.3 Crescendo e Colaborando em Comunidades
    • 12.4 Desafio: GitCaos 🔥
    • 12.5 Links Úteis - Capítulo 12
    • 12.6 Glossário Completo: Git e GitHub para Humanos
Fornecido por GitBook
Nesta página
  • Informações Gerais do Repositório
  • Lista de Arquivos
  • Cabeçalho da Lista de Arquivos
  • Exibição Automática do README
  • Hora de Explorar

Isto foi útil?

Editar no GitHub
Exportar como PDF
  1. 6. Repositórios no GitHub

6.3 Página Principal de um Repositório: Aba Code

Anterior6.2 Criando um Repositório no GitHubPróximo6.3.1 Editando um Arquivo em um Repositório no GitHub

Atualizado há 4 meses

Isto foi útil?

Parabéns por criar seu primeiro repositório! A aba Code é o coração do seu projeto no GitHub, onde você encontrará todos os arquivos que compõem seu código. Vamos explorar cada parte em detalhes.

Informações Gerais do Repositório

  • Nome do Repositório: É o título do seu projeto, que você escolheu ao criá-lo. É importante que seja claro e conciso, refletindo o conteúdo do seu projeto.

  • Conta Dona do Repositório: Neste caso, indica o seu nome da conta no GitHub, ou seja, a conta proprietária do projeto.

  • Branch Principal: Indica a versão principal do seu código. Geralmente é chamada de "main". É aqui que você fará a maior parte do seu trabalho.

  • Visibilidade: Define quem pode ver e acessar o seu repositório. As opções mais comuns são:

    • Público: Qualquer pessoa na internet pode ver e clonar o seu repositório.

    • Privado: Apenas você e as pessoas que você convidar podem ver e acessar o repositório.

  • Descrição do Repositório: Além do arquivo README, você pode adicionar uma breve descrição do seu repositório diretamente na página principal. Essa descrição aparece logo abaixo do nome do repositório e complementa as informações do README.

Lista de Arquivos

A área central da aba Code apresenta uma lista de todos os arquivos que fazem parte do seu repositório. Como, ao criar o repositório, você já o inicializou com um arquivo README, você poderá notar que ele já está na lista de arquivos.

Ao lado de cada arquivo, você verá informações cruciais como:

  • Nome do Arquivo: O nome exato do arquivo, indicando seu propósito dentro do projeto.

  • Mensagem do Último Commit: Descrição da última modificação no arquivo.

  • Data do Último Commit: Quando foi a última alteração realizada no arquivo. Isso é útil para acompanhar o histórico de mudanças e identificar a versão mais recente.

Mas e de onde veio essa mensagem initial commit?

Ao criar um repositório e optar por inicializá-lo com um arquivo README, o GitHub automaticamente realiza o primeiro commit para incluir esse arquivo no projeto. Esse commit é registrado com uma mensagem padrão definida pelo próprio GitHub: initial commit - indicando que se trata da primeira alteração no repositório.

Além disso, a autoria do commit é automaticamente atribuída à sua conta do GitHub, já que foi você quem criou o projeto e escolheu adicionar o README durante a configuração inicial.

Cabeçalho da Lista de Arquivos

Acima da lista de arquivos, você encontrará um cabeçalho que resume as informações mais recentes sobre todo o repositório:

  • Autor da Última Commit: Mostra o nome da conta da pessoa usuária que realizou a última alteração no repositório.

  • Mensagem do Último Commit: Descrição da última alteração feita em qualquer arquivo do repositório.

  • Data do Último Commit: Quando a última alteração foi feita no repositório.

Exibição Automática do README

Uma funcionalidade super útil do GitHub é a exibição automática do conteúdo do arquivo README.md na página principal do repositório. Isso significa que, ao acessar seu repositório, as pessoas verão imediatamente uma descrição concisa do seu projeto, sem precisar procurar pelo arquivo.

Hora de Explorar

A aba Code é o coração do seu projeto no GitHub. É aqui que você pode gerenciar todos os arquivos, acompanhar o histórico de alterações e destacar informações essenciais sobre o projeto por meio do arquivo README.md. Essa aba centraliza tudo o que você precisa para organizar e evoluir seu repositório.

Agora é sua vez! Explore a aba Code no seu repositório hello-world. Observe as seções destacadas, como a lista de arquivos, o conteúdo do README.md e as informações do cabeçalho. Isso ajudará você a se familiarizar com os elementos principais do seu projeto.

Aba Code
Informações da conta e do nome do repositório
Visibilidade, branch principal e descrição do repositório
Lista de arquivos do repositório
Informações de cada arquivo
Exibição Automática do README na página principal do repositório
Interface do GitHub exibindo a aba 'Code' do repositório 'hello-world'. A aba 'Code' está destacada em roxo para indicar a seção onde o usuário pode visualizar e gerenciar os arquivos do projeto
Interface do GitHub exibindo a parte superior da aba 'Code'. O nome do repositório 'hello-world' e o nome da conta do usuário 'aprendizCumbucaDev' estão destacados em roxo e marron, respectivamente.
Interface do GitHub exibindo as configurações básicas de um repositório. As seções destacadas mostram o branch principal, a visibilidade (pública ou privada) e uma breve descrição do projeto.
Interface do GitHub da aba code do repositório 'hello-world'. Estrutura de arquivos do projeto destacada em roxo. A lista mostra todos os arquivos que foram adicionados ao repositório, junto com informações sobre suas últimas modificações. Para este repositório, no caso, há apenas o arquivo README.md.
Interface do GitHub da aba code do repositório 'hello-world'. Destaque para as informações de cada arquivo na lista de arquivos do repositório. Mostra-se o nome de cada arquivo, a mensagem descrevendo a última modificação e quando foi feita a última alteração. No exemplo, apenas o arquivo README.md está presente.
Interface do GitHub da aba code do repositório 'hello-world'. Destaque para o cabeçalho da lista de arquivos do repositório. Mostra-se quem fez última alteração no projeto, a mensagem descrevendo a última modificação e quando essa última alteração foi feita.
Interface do GitHub mostrando a exibição automática do conteúdo do arquivo README.md na página principal do repositório 'hello-world', logo abaixa da lista de arquivos.