Criar um repositório

Criar um repositório a partir da interface do usuário da web

1. No canto superior direito de qualquer página, selecione e clique em Novo repositório.

   

2. Opcionalmente, para criar um repositório com a estrutura de diretório e os arquivos de um repositório existente, selecione o menu suspenso Escolher um modelo e clique em um repositório de modelo. Você verá repositórios de modelo que pertencem a você e às organizações das quais você é integrante ou que usou antes. Para saber mais, confira Criar um repositório a partir de um modelo.

3. Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e os arquivos de todos os branches no modelo, não apenas o branch padrão, selecione Incluir todos os branches.

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

   

5. Digite um nome para o seu repositório e uma descrição opcional.

   

6. Escolha uma visibilidade do repositório. Para obter mais informações, confira "Sobre repositórios".

7. Se você não estiver usando um modelo, haverá um número de itens opcionais com os quais você pode preencher previamente o seu repositório. Se for importar um repositório existente para o GitHub Enterprise Cloud, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível adicionar ou criar arquivos usando a interface de usuário ou optar por adicionar novos arquivos posteriormente usando a linha de comando. Para saber mais, confira Como importar um repositório Git externo usando a linha de comando, Adicionar um arquivo a um repositório e Resolvendo conflitos de mesclagem.

   • Você pode criar um README, que é um documento que descreve seu projeto. Para saber mais, confira Sobre LEIAMEs.
   • Você pode criar um arquivo .gitignore, que é um conjunto de regras a serem ignoradas. Para obter mais informações, confira Ignorar arquivos.
   • Você pode optar por adicionar uma licença de software para seu projeto. Para mais informações, confira Licenciar um repositório.

8. Opcionalmente, se a conta pessoal ou de organização na qual você está criando usar GitHub Apps do GitHub Marketplace, selecione os aplicativos que deseja usar no repositório.

9. Defina as propriedades personalizadas para a criação do repositório, se forem necessárias. Para obter mais informações, confira Como gerenciar propriedades personalizadas para repositórios na sua organização. 1. Clique em Criar repositório.

10. Na parte inferior da página Configuração rápida resultante, em "Import code from an old repository" (Importar código de um repositório antigo), você pode optar por importar um projeto para o novo repositório. Para fazer isso, clique em Importar código.

Criar um repositório a partir de uma consulta de URL

É possível usar parâmetros de consulta para preencher previamente os campos do formulário ao criar um repositório. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para especificar valores para os parâmetros de consulta predefinidos, é necessário corresponder ao par de chave e valor.

O preenchimento prévio de campos de formulário com uma consulta de URL pode ser útil se você deseja criar repositórios com as mesmas configurações padrão. Por exemplo, um professor pode querer que cada aluno de uma turma crie um repositório em sua conta pessoal com o mesmo nome, descrição e visibilidade. Usando uma consulta de URL, o professor pode criar um link que preencha previamente o nome do repositório, a descrição e os campos de visibilidade e compartilhá-lo com toda a turma.

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é necessário ter permissão para criar um repositório em uma organização para especificar a organização como o proprietário do repositório em um parâmetro de consulta. Para saber mais, confira Funções de repositório para uma organização.

Se você criar um URL inválido usando parâmetros de consulta ou se não tiver as permissões adequadas, os parâmetros de consulta inválidos serão ignorados e o restante do URL funcionará normalmente. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro 414 URI Too Long.

Parâmetro de consulta	Exemplo	Valores válidos
name	O https://github.com/new?name=test-repo&owner=avocado-corp cria um repositório chamado "test-repo" de propriedade da organização "avocado-corp".	Qualquer nome de repositório válido. Os espaços devem ser substituídos por + ou %20.
description	O https://github.com/new?description=An+exciting+repository&visibility=private&owner=octocat cria um repositório com a descrição "Um repositório interessante" com visibilidade privada pertencente a @octocat.	Qualquer cadeia de caracteres. Os espaços devem ser substituídos por + ou %20.
visibility	O https://github.com/new?visibility=private cria um repositório com visibilidade privada.	public private internal
owner	O https://github.com/new?owner=avocado-corp&visibility=public cria um repositório público de propriedade da organização "avocado-corp".	Qualquer nome de organização ou nome de usuário válido. Como alternativa, enquanto estiver conectado, use @me para especificar sua conta de usuário como o proprietário.
template_owner e template_name	O https://github.com/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo cria um repositório de propriedade de "avocado-corp" usando o modelo "octo-repo" da avocado-corp.	O nome de usuário do proprietário do modelo e o nome do modelo de repositório.

Leitura adicional

• Gerenciar o acesso do usuário a repositórios da sua organização
• Guias de Código Aberto
• GitHub Skills