Skip to main content

Navegar por arquivos com a nova exibição de código (beta)

Com a nova exibição de código (beta), é possível exibir códigos contextualmente com uma árvore de arquivos de fácil navegação e uma pesquisa de símbolos integrada.

Observação: A nova pesquisa de código e a exibição de código estão em versão beta pública limitada. Para ingressar na lista de espera para acesso, visite https://github.com/features/code-search-code-view/signup.

Para saber mais sobre a nova pesquisa de código, confira "Sobre a Pesquisa de Código do GitHub (beta)".

Sobre a nova exibição de código (beta)

A nova exibição de código (beta) aprimora a navegação com um modo de exibição de árvore de arquivos, além de simplificar a edição de arquivos, apresentar um painel de símbolos para pesquisa de símbolos e navegação e atualizar a exibição de identificação para manter o contexto do arquivo. A nova exibição de código é integrada a um novo mecanismo de pesquisa de código e a uma interface de pesquisa em uma versão beta pública limitada no GitHub.com. Para saber mais sobre a nova pesquisa de código, confira "Sobre a Pesquisa de Código do GitHub (beta)".

Para ter acesso à nova exibição de código (beta) com a nova pesquisa de código, inscreva-se na lista de espera.

Para fornecer comentários sobre a nova exibição de código beta, confira o fórum de discussão.

Habilitar e desabilitar a nova exibição de código e a nova pesquisa de código (beta)

Você receberá um email quando for aceito na lista de espera para ingressar na versão beta. Depois que você receber acesso, a nova pesquisa de código e a exibição de código beta serão habilitadas automaticamente na conta.

Você pode desabilitar ou habilitar a versão beta no GitHub.com a qualquer momento. Observe que essa configuração se aplica à pesquisa de código e à exibição de código.

  1. No canto superior direito de qualquer página, clique na foto do seu perfil e na Visualização de recursos. Botão Visualização de recursos
  2. À direita de "Nova Pesquisa de Código e Exibição de Código (Beta)", clique em Habilitar ou Desabilitar.

Usar o modo de exibição de árvore de arquivos

O novo modo de exibição de árvore de arquivos é um painel que exibe os diretórios e arquivos de um repositório em uma árvore de fácil navegação. É possível percorrer diretórios e arquivos rapidamente e entender o contexto de cada item exibido.

  1. Selecione um repositório e clique em um diretório ou arquivo dentro dele para abrir o modo de exibição de árvore de arquivos.

    Captura de tela do repositório "github/docs" com ênfase no modo de exibição de árvore de arquivos

  2. Para pesquisar um diretório ou arquivo específico, clique na barra de pesquisa Acessar arquivo, digite o nome do diretório ou arquivo e selecione-o nos resultados. É possível exibir o caminho de um diretório ou arquivo abaixo de cada resultado da pesquisa.

    Captura de tela do modo de exibição de árvore de arquivos com ênfase na barra de pesquisa "Acessar arquivo"

    • Para pesquisar no repositório usando a barra de pesquisa do GitHub, clique em .

      Captura de tela do modo de exibição de árvore de arquivos com ênfase no ícone de pesquisa

  3. Para alternar entre branches, selecione o menu suspenso de branches e clique no branch desejado nos resultados. Para exibir todos os branches de um repositório, clique em Exibir todos os branches.

    Captura de tela do modo de exibição de árvore de arquivos com ênfase na guia "Branches" do menu suspenso de branches

  4. Para alternar entre marcas, selecione o menu suspenso de branches , clique na guia Marcas e, em seguida, escolha a marca desejada nos resultados. Para exibir todas as marcas de um repositório, clique em Exibir todas as marcas.

    Captura de tela do modo de exibição de árvore de arquivos com ênfase na guia "Marcas" do menu suspenso de branches

Trabalhando com arquivos

A nova exibição de código também inclui atualizações nas formas de trabalhar com arquivos. As funcionalidades existentes, como editar, criar, carregar e excluir um arquivo ou diretório, foram simplificadas. Agora você tem acesso rápido para editar um arquivo no github.dev ou no GitHub Desktop e uma função integrada de pesquisa no arquivo.

  1. Selecione um repositório e clique em um arquivo dentro dele para abrir a nova exibição de código.

    Captura de tela do repositório "github/docs" com ênfase em um arquivo selecionado no modo de exibição de árvore de arquivos

  2. Para editar um arquivo no editor de arquivos integrado, clique em .

    Captura de tela do editor de arquivos na nova exibição de código com ênfase no ícone de edição

  3. Para editar um arquivo no editor baseado na Web github.dev ou GitHub Desktop, selecione ao lado de e clique em github.dev ou em GitHub Desktop .

    Observação: atualmente, o editor do github.dev está em versão prévia beta. É possível fornecer feedback nas discussões.

    Captura de tela do editor de arquivos na nova exibição de código com ênfase no menu suspenso de edição

  4. Para localizar caracteres específicos em um arquivo, exiba o código bruto dele clicando no botão Código. Em seguida, pressione Command+F (Mac) ouCtrl+F (Windows/Linux) e digite os caracteres que você deseja encontrar. É possível navegar pelos resultados pressionando Return (Mac) ou Enter (Windows/Linux) ou clicando em e em .

    Observação: para usar a função de localização padrão do navegador, pressione Command+F (Mac) ou Ctrl+F (Windows/Linux) duas vezes. Lembre-se de que a função de localização padrão do navegador não poderá pesquisar a totalidade de um arquivo grande, diferentemente da pesquisa integrada na nova exibição de código.

    Captura de tela da função "Localizar no arquivo" na nova exibição de código

  5. Para adicionar um arquivo a um diretório específico, clique nesse diretório e em Novo arquivo ou clique em no modo de exibição de árvore de arquivos.

    Captura de tela do modo de exibição de árvore de arquivos com foco no ícone de adição

  6. Para excluir um diretório ou arquivo, acesse-o e clique em . Em seguida, clique em Excluir diretório ou em Excluir arquivo.

    Captura de tela do menu de opções na nova exibição de código com ênfase na opção "Excluir diretório"

  7. Para carregar um arquivo, acesse o diretório escolhido e clique em Carregar arquivos ou arraste e solte o arquivo no navegador.

    Captura de tela do botão "Carregar arquivos" na nova exibição de código

Usar o painel de símbolos

Agora, com o painel de símbolos, é possível exibir e navegar rapidamente por símbolos como funções ou classes no código. É possível pesquisar um símbolo em um único arquivo, em todos os arquivos de um repositório ou até mesmo em todos os repositórios públicos no GitHub.

A pesquisa de símbolo é um recurso da nova Pesquisa de Código (beta). Para saber mais, confira "Noções básicas sobre a sintaxe da Pesquisa de Código do GitHub (beta)".

  1. Selecione um repositório e navegue até um arquivo que contenha símbolos.

  2. Para abrir o painel de símbolos, clique em .

    Captura de tela do ícone do painel de símbolos na nova exibição de código

    Como alternativa, é possível abrir o painel de símbolos clicando em um símbolo elegível no arquivo. Os símbolos clicáveis são realçados em amarelo quando você passa o mouse sobre eles.

    Captura de tela de um arquivo na nova exibição de código com ênfase em um símbolo clicável

  3. Clique no símbolo que você deseja encontrar no painel de símbolos ou no próprio arquivo.

    Captura de tela do painel de símbolos com ênfase em um símbolo preenchido automaticamente

    • Para pesquisar um símbolo no repositório como um todo, clique em Pesquisar este símbolo neste repositório. Para procurar um símbolo em todos os repositórios no GitHub, clique em Todos os repositórios.

      Captura de tela do painel de símbolos com ênfase nas opções para ampliar o escopo da pesquisa por um símbolo

  4. Para navegar entre as referências de um símbolo, clique em ou em .

    Captura de tela do painel de símbolos com ênfase nas divisas da navegação de pesquisa

  5. Para navegar para uma referência específica a um símbolo, clique em um resultado da pesquisa de símbolo em Neste arquivo.

    Captura de tela do painel de símbolos com ênfase em um resultado da pesquisa de símbolo

  6. Para sair da pesquisa de um símbolo específico, clique em Todos os símbolos.

    Captura de tela do painel de símbolos com ênfase no botão "Todos os símbolos"

Usar a exibição de identificação

Em vez de perder o contexto do arquivo ao entrar na exibição de identificação, agora é possível usar a nova exibição de código para alternar rapidamente entre a exibição de identificação, de código bruto e de um arquivo (dependendo do tipo dele).

  1. Selecione um repositório e clique em um arquivo dentro dele para abrir a nova exibição de código.

    Captura de tela do repositório "github/docs" com ênfase em um arquivo selecionado no modo de exibição de árvore de arquivos

  2. Para ver o histórico de revisões do arquivo, clique em Identificar. 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.

    Captura de tela da nova exibição de código com ênfase no botão "Identificar"

    • Para ver as versões de um arquivo antes de um determinado commit, clique em .

      Captura de tela de um commit na exibição de identificação com ênfase no ícone de versões

    • Para ver mais detalhes sobre commits específicos, clique na descrição do commit.

      Captura de tela de um commit na exibição de identificação com ênfase na descrição do commit

  3. Para retornar à exibição de código bruto, clique em Código.

    Captura de tela da barra de ferramentas de exibição de código com ênfase no botão de exibição de código

    • No caso da exibição de um arquivo markdown, também é possível clicar em Pré-visualização para retornar à exibição com a formatação de markdown aplicada.

      Captura de tela da barra de ferramentas de exibição de código com ênfase no botão de exibição de markdown

Leitura adicional