Passo a Passo para Criar o Seu Primeiro Repositório no GitHub

Photo by Roman Synkevych on Unsplash

Criar um repositório

Você pode armazenar uma variedade de projetos nos repositórios do GitHub, incluindo projetos de código aberto. Com projetos de código aberto , você pode compartilhar código para criar um software melhor e mais confiável. Você pode usar repositórios para colaborar com outras pessoas e acompanhar seu trabalho. Para obter mais informações, consulte “ Sobre repositórios .”

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

1. No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório .

2. Digite um nome curto e memorável para seu repositório. Por exemplo, “olá-mundo”.

3. Opcionalmente, adicione uma descrição do seu repositório. Por exemplo, “Meu primeiro repositório no GitHub”.

4. Escolha uma visibilidade do repositório. Para obter mais informações, consulte “ Sobre repositórios .”

5. Selecione Inicializar este repositório com um README .

6. Clique em Criar repositório .

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

Para saber mais sobre a CLI do GitHub, consulte “ Sobre a CLI do GitHub “.

1. Na linha de comando, navegue até o diretório onde você gostaria de criar um clone local do seu novo projeto.
2. Para criar um repositório para seu projeto, use o gh repo createsubcomando. Quando solicitado, selecione Criar um novo repositório no GitHub do zero e insira o nome do seu novo projeto. Se você quiser que 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.
3. Siga as instruções interativas. Para clonar o repositório localmente, confirme sim quando perguntado se deseja clonar o diretório do projeto remoto.
4. Como alternativa, para ignorar os prompts, forneça o nome do repositório e um sinalizador de visibilidade ( --public, --private, ou --internal). Por exemplo gh repo create project-name --public,. Para clonar o repositório localmente, passe o --clonesinalizador. Para obter mais informações sobre possíveis argumentos, consulte o manual GitHub CLI .

Confirme sua primeira alteração

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

Quando você criou seu novo repositório, você o inicializou com um arquivo README . Os arquivos README são um ótimo lugar para descrever seu projeto com mais detalhes ou adicionar alguma documentação, como instalar ou usar seu projeto. O conteúdo do seu arquivo README é mostrado automaticamente na primeira página do seu repositório.

Vamos confirmar uma alteração no arquivo README .

1. Na lista de arquivos do seu repositório, clique em README.md .

2. Acima do conteúdo do arquivo, clique em .

3. Na guia Editar arquivo , digite algumas informações sobre você.

4. Acima do novo conteúdo, clique em Visualizar alterações .

5. Revise as alterações feitas no arquivo. Você verá o novo conteúdo em verde.

6. Na parte inferior da página, digite uma mensagem de confirmação curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem do commit. Para obter mais informações, consulte “ Criando um commit com vários coautores .”

7. Abaixo dos campos de mensagem de confirmação, decida se deseja adicionar sua confirmação à ramificação atual ou a uma nova ramificação. Se sua ramificação atual for a ramificação padrão, você deve optar por criar uma nova ramificação para seu commit e, em seguida, criar uma solicitação pull. Para obter mais informações, consulte “ Criando uma nova solicitação pull “.

8. Clique em Propor alteração de arquivo .

9. Agora que você criou um projeto, você pode começar a confirmar as alterações.

Os arquivos README são um ótimo lugar para descrever seu projeto com mais detalhes ou adicionar alguma documentação, como instalar ou usar seu projeto. O conteúdo do seu arquivo README é mostrado automaticamente na primeira página do seu repositório. Siga estas etapas para adicionar um arquivo README .

1. Na linha de comando, navegue até o diretório raiz do seu novo projeto. (Este diretório foi criado quando você executou o gh repo createcomando.)
2. Crie um arquivo README com algumas informações sobre o projeto.

• echo "info about this project" >> README.md

3. Entre git status. Você verá que tem um README.mdarquivo 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. Prepare e confirme o arquivo.

git add README.md && git commit -m "Add README"

5. Envie as alterações para sua ramificação.

git push --set-upstream origin HEAD

Repositório Criado com Sucesso

Parabéns! Agora você criou um repositório, incluindo um arquivo README , e criou seu primeiro commit no GitHub.com.

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

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

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

O GitHub tem uma ótima comunidade de suporte onde você pode pedir ajuda e conversar com pessoas de todo o mundo. Participe da conversa na comunidade de suporte do Github .