Criar um repositório

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

Criar um repositório

Você pode armazenar uma série de projetos em repositórios de GitHub AE, incluindo projetos de innersource. Com o innersource, você pode compartilhar código para criar um software melhor e mais confiável. Para obter mais informações sobre innersource, consulte o white paper de GitHub"Uma introdução ao innersource".

  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 AE". Campo para inserir uma descrição do repositório
  4. Escolha uma visibilidade do repositório. Para obter mais informações, consulte "Sobre repositórios". 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 README). Caixa de seleção Initialize this repository with a README (Inicializar este repositório com um README)
  6. Clique em Create Repository (Criar repositório). Button to create repository

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

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

  1. Na linha de comando, acesse o diretório onde você gostaria de criar um clone local do seu novo projeto.

  2. Para criar um repositório para o seu projeto, use o subcomando gh repo create. Substitua project-name pelo nome desejado para o repositório. Se você quiser que o seu projeto pertença a uma organização em vez de sua conta de usuário, especifique o nome da organização e o nome do projeto com organization-name/project-name.

    gh repo create project-name
  3. Siga as instruções interativas. Para clonar o repositório localmente, marque sim quando perguntarem se você deseja clonar o diretório do projeto remoto. Como alternativa, você pode especificar argumentos para pular essas instruções. Para obter mais informações sobre possíveis argumentos, consulte o manual de 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 README. Os arquivos README 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 README é mostrado automaticamente na primeira página do repositório.

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

  1. Na lista de arquivos do repositório, clique em README.m. Arquivo README 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)

Agora que você criou um projeto, você pode começar a fazer commit das alterações.

Os arquivos README 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 README é mostrado automaticamente na primeira página do repositório. Siga estas etapas para adicionar um arquivo README.

  1. Na linha de comando, acesse o diretório raiz do seu novo projeto. (Este diretório foi criado quando você executou o repositório gh repo create.)

  2. Crie um arquivo README com algumas informações sobre o projeto.

    echo "info about this project" >> README.md
  3. Insira git status. Você verá que você tem um arquivo README.md não rastreado.

    $ git status
    
    Untracked files:
      (use "git add ..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
  4. Stage e commit do arquivo.

    git add README.md && git commit -m "Add README"
  5. Faça push das alterações para seu branch.

    git push --set-upstream origin HEAD

Comemore

Parabéns! Você criou um repositório, incluindo um arquivo README, assim como seu primeiro commit no a sua empresa.

Agora você pode clonar um repositório de GitHub AE para criar uma cópia local no seu computador. A partir do seu repositório local, você pode fazer commit e criar um pull request para atualizar as alterações no repositório upstream. Para obter mais informações, consulte "Clonando um repositório" e "Configurar o Git".

Você pode encontrar projetos e repositórios interessantes em GitHub AE e fazer alterações neles criando uma bifurcação no repositório. Para obter mais informações, "Bifurcar um repositório".

Cada repositório em GitHub AE pertence a uma pessoa ou organização. Você pode interagir com as pessoas, repositórios e organizações, conectando-se e seguindo-as em GitHub AE. Para obter mais informações, consulte "Seja social".

GitHub AE tem uma ótima comunidade de suporte onde você pode pedir ajuda e conversar com pessoas de todo o mundo. Junte-se à conversa na Comunidade de Suporte do Github.

Esse documento ajudou você?

Política de Privacidade

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.