Skip to main content

Criar um repositório a partir de um modelo

Você pode gerar um novo repositório com os mesmos arquivos e estrutura de diretório de um repositório que já existe.

Quem pode usar esse recurso?

Anyone with read access to a template repository can create a repository from that template.

Sobre modelos de repositório

Você pode criar um modelo a partir de um repositório existente. Qualquer pessoa com acesso ao repositório de modelos pode criar um novo repositório baseado no modelo com a mesma estrutura de diretórios, branchs e arquivos. Para obter mais informações sobre a criação de um modelo de repositório, confira Criar um repositório de modelos.

Dica

Você também pode criar um repositório com base em um modelo usando a GitHub CLI. Para obter mais informações, confira "gh repo create" na documentação da GitHub CLI.

Você pode optar por incluir a estrutura do diretório e os arquivos somente do branch padrão do repositório de template ou incluir todos os branches. Os branches criados a partir de um modelo têm histórico não relacionado, o que significa que você não pode criar pull requests ou fazer merge entre os branches.

Criar um repositório a partir de um modelo é semelhante a bifurcar um repositório, mas há diferenças importantes:

  • Uma nova fork inclui o histórico de commits inteiro do repositório principal, enquanto um repositório criado de um modelo começa com um único commit.
  • Os commits em uma bifurcação não aparecem no gráfico de contribuições, enquanto os commits em um repositório criado a partir de um template aparecem no gráfico de contribuições.
  • Uma bifurcação pode ser uma maneira temporária de contribuir com código para um projeto existente, enquanto criar um repositório a partir de um modelo inicia um novo projeto rapidamente.

Para obter mais informações sobre forks, confira Sobre bifurcações.

Criar um repositório a partir de um modelo

{conteúdo reutilizável.repositórios.navegar-para-repo}

  1. Acima da lista de arquivos, selecione Usar este modelo.

  2. Use o menu suspenso Proprietário para selecionar a conta que deseja atribuir como proprietário do repositório.

    Captura de tela do menu Proprietário de um novo repositório do GitHub. O menu mostra duas opções, octocat e github.

  3. Digite um nome para o repositório (máximo de 100 caracteres) e uma descrição opcional.

    Captura de tela da primeira etapa na criação de um repositório. O campo "Repository name" contém o texto "hello-world" e está contornado em laranja.

  4. Escolha uma visibilidade do repositório. Para saber mais, confira Sobre repositórios.

  5. Opcionalmente, para incluir a estrutura de diretório e os arquivos de todos os branches no modelo e não apenas o branch padrão, selecione Incluir todos os branches.

  6. Clique em Criar repositório do modelo.