Exibindo e entendendo arquivos

O GitHub fornece ferramentas para exibir conteúdo bruto, rastrear alterações em linhas específicas e explorar como o conteúdo de um arquivo evoluiu ao longo do tempo. Esses insights revelam como o código foi desenvolvido, sua finalidade atual e sua estrutura, ajudando você a contribuir efetivamente.

Visualizando ou copiando o conteúdo do arquivo sem processamento

Com a visualização sem processamento, você pode visualizar ou copiar o conteúdo não processado de um arquivo sem qualquer estilo.

1. Em GitHub, acesse a página principal do repositório.

2. Clique no arquivo que você deseja visualizar.

3. No canto superior direito da exibição de arquivo, clique em Bruto.

   

4. Opcionalmente, para copiar o conteúdo do arquivo bruto, no canto superior direito da exibição de arquivo, clique em . Para baixar o arquivo bruto, clique em .

Visualizando o histórico de revisão linha por linha para um arquivo

Na exibição de identificação, veja o histórico de revisões linha a linha de um arquivo inteiro.

1. Em GitHub, acesse a página principal do repositório.

2. Clique para abrir o arquivo cujo histórico de linhas você deseja exibir.

3. Acima do conteúdo do arquivo, clique em Blame. Essa exibição fornece um histórico de revisão linha por linha, com o código em um arquivo separado por commit. Cada commit lista o autor, a descrição e a data de realização relacionados a ele.

4. Para conferir as versões de um arquivo antes de um determinado commit, clique em . Como alternativa, para ver mais detalhes sobre um commit específico, clique na mensagem do commit.

   

5. Para retornar à visualização do código bruto, acima do conteúdo do arquivo, clique em Código.

   • No caso da exibição de um arquivo markdown, acima do conteúdo do arquivo, também é possível clicar em Versão prévia para retornar à exibição com a formatação de markdown aplicada.

Ignorar os commits na exibição de blame

Todas as revisões especificadas no arquivo .git-blame-ignore-revs, que precisam estar no diretório raiz do repositório, ficam ocultas na exibição de blame usando a definição de configuração git blame --ignore-revs-file do Git. Para obter mais informações, confira git blame --ignore-revs-file na documentação do Git.

1. No diretório raiz do repositório, crie um arquivo chamado .git-blame-ignore-revs.

2. Adicione os hashes de commit que deseja excluir da exibição de blame desse arquivo. Recomendamos que o arquivo seja estruturado da seguinte maneira, incluindo os comentários:

   # .git-blame-ignore-revs
   # Removed semi-colons from the entire codebase
   a8940f7fbddf7fad9d7d50014d4e8d46baf30592
   # Converted all JavaScript to TypeScript
   69d029cec8337c616552756310748c4a507bd75a
   

3. Faça commit e efetue push das alterações.

Agora, quando você acessar a exibição de blame, as revisões listadas não serão incluídas no blame. Você verá uma faixa Ignorando revisões em .git-blame-ignore-revs, indicando que alguns commits podem estar ocultos:

Isso pode ser útil quando alguns commits fazem alterações extensas no código. Use também o arquivo ao executar git blame localmente:

git blame --ignore-revs-file .git-blame-ignore-revs

Você também pode configurar seu git local para que ele sempre ignore as revisões nesse arquivo:

git config blame.ignoreRevsFile .git-blame-ignore-revs

Ignorar .git-blame-ignore-revs na exibição de blame

Se a exibição de blame de um arquivo mostrar Ignorar revisões em .git-blame-ignore-revs, você ainda poderá ignorar .git-blame-ignore-revs e ver a exibição de blame normal. Na URL, acrescente um ~ ao SHA e a faixa Ignorando revisões em .git-blame-ignore-revs desaparecerá.