Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Criar um repositório

Para colocar seu projeto no GitHub, você precisará criar um repositório no qual ele residirá.

Neste artigo

Você pode armazenar vários projetos nos repositórios do GitHub, incluindo projetos de código aberto. Com os projetos de código aberto, é possível compartilhar código para criar softwares melhores e mais confiáveis.

Observação: você pode criar repositórios públicos para um projeto de código aberto. Ao criar um repositório público, certifique-se de incluir um arquivo de licença que determina como deseja que seu projeto seja compartilhado com outras pessoas. Para mais informações sobre código aberto, especificamente como criar e crescer um projeto de código aberto, Criamos Guias em Código Aberto que ajudarão você a fomentar uma comunidade de código aberto saudável, recomendando as melhores práticas para a criação e manutenção de repositórios para seu projeto de código aberto. Você também pode participar de um curso gratuito GitHub Learning Lab sobre a manutenção de comunidades de código aberto.

  1. No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório.
    Menu suspenso com a opção de criar um novo repositório
  2. Digite um nome curto e fácil de memorizar para seu repositório. Por exemplo, "olá mundo".
    Campo para inserir um nome de repositório
  3. Se desejar, adicione uma descrição do repositório. Por exemplo, "Meu primeiro repositório no GitHub."
    Campo para inserir uma descrição do repositório
  4. Escolha uma visibilidade do repositório. Para obter mais informações, consulte "Sobre a visibilidade do repositório."
    Botões de opção para selecionar a visibilidade do repositório
  5. Selecione Initialize this repository with a README (Inicializar este repositório com um LEIAME).
    Caixa de seleção Initialize this repository with a README (Inicializar este repositório com um LEIAME)
  6. Click Create repository.
    Button to create repository

Parabéns! Você criou com êxito seu primeiro repositório e o inicializou com um arquivo LEIAME.

Dica: Você também pode criar repositórios usando GitHub CLI. Para obter mais informações, consulte "criar repositório gh" na documentação do GitHub CLI.

Fazer commit da primeira alteração

Um commit é como um instantâneo de todos os arquivos no seu projeto em um determinado momento.

Na criação do repositório, você o inicializou com um arquivo LEIAME. Os arquivos LEIAME são um excelente local para descrever seu projeto mais detalhadamente ou para adicionar alguma documentação, por exemplo, como instalar ou usar seu projeto. O conteúdo do arquivo LEIAME é mostrado automaticamente na primeira página do repositório.

Vamos fazer commit de uma alteração no arquivo LEIAME.

  1. Na lista de arquivos do repositório, clique em README.m.
    Arquivo leiame na lista de arquivos
  2. Acima do conteúdo do arquivo, clique em .
  3. Na guia Edit file (Editar arquivo), digite algumas informações sobre si mesmo.
    Novo conteúdo no arquivo
  4. Acima do novo conteúdo, clique em Preview changes (Visualizar alterações).
    Botão de visualização do arquivo
  5. Revise as alterações feitas no arquivo. Você verá o novo conteúdo em verde.
    Visualização de arquivo
  6. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, consulte "Criar um commit com vários co-autores."
    Mensagem do commit para sua alteração
  7. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, consulte "Criar uma nova pull request."
    Opções para fazer commit no branch
  8. Clique em Propose file change (Propor alteração no arquivo).
    Botão Propose changes (Propor alterações)

Comemore

Parabéns! Você criou um repositório, incluindo um arquivo LEIAME, assim como seu primeiro commit no GitHub. O que quer fazer agora?

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.