Carregar um projeto no GitHub

Introdução

Este tutorial mostrará como carregar um grupo de arquivos em um repositório GitHub.

Carregar seus arquivos em um repositório GitHub permite que você:

• Aplique o controle de versão ao fazer edições nos arquivos, para que o histórico do projeto seja protegido e gerenciável.
• Faça backup do seu trabalho, porque seus arquivos agora estão armazenados na nuvem.
• Fixe o repositório no seu perfil pessoal, para que outras pessoas possam ver o seu trabalho.
• Compartilhe e discuta seu trabalho com outras pessoas, seja pública ou privadamente.

Se você já tiver familiaridade com o Git e estiver procurando informações sobre como carregar um repositório Git armazenado localmente em GitHub, consulte "Adicionando o código localmente hospedado no GitHub".

Pré-requisitos

• Você deve ter uma conta do GitHub. Para mais informações, confira "Criar uma conta no GitHub".
• Você deve ter um grupo de arquivos que gostaria de carregar.

Etapa 1: Criar um novo repositório para seu projeto

É uma boa ideia criar um novo repositório para cada projeto individual em que você está trabalhando. Se você estiver escrevendo um projeto de software, agrupar todos os arquivos relacionados em um novo repositório facilita a manutenção e o gerenciamento da base de código ao longo do tempo.

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

   

2. Na caixa "Nome do repositório", digite um nome para o projeto. Por exemplo, digite "meu-primeiro-projeto".

3. Na caixa "Descrição", digite uma breve descrição. Por exemplo, digite "Este é meu primeiro projeto no GitHub."

4. Selecione se o repositório será Público ou Privado. Selecione "Público" se quiser que outras pessoas possam ver seu projeto.

5. Selecione Adicionar um arquivo LEIAME. Você editará esse arquivo em uma etapa posterior.

6. Clique em Criar repositório.

Etapa 2: Fazer upload de arquivos para o repositório do seu projeto

Até agora, você só deve ver um arquivo listado no repositório, o arquivo README.md que você criou quando inicializou o repositório. Agora, vamos carregar alguns de seus próprios arquivos.

1. À direita da página, selecione o menu suspenso Adicionar arquivo.
2. No menu suspenso, clique em Carregar arquivos.
3. No computador, abra a pasta que contém o trabalho e arraste e solte todos os arquivos e pastas no navegador.
4. Na parte inferior da página, em "Confirmar alterações", selecione "Confirmar diretamente na ramificação main e clique em Confirmar alterações.

Etapa 3: Editar o arquivo LEIAME para o repositório do seu projeto

O arquivo LEIAME do repositório é normalmente o primeiro item que alguém verá ao visitá-lo. Ele geralmente contém informações sobre o que é o seu projeto e por que o seu projeto é útil.

Como aprendemos no tutorial "Olá, Mundo", o arquivo LEIAME (README.md) é escrito na sintaxe Markdown. O Markdown é uma linguagem fácil de ler e de gravar para formatar texto sem formatação.

Nesta etapa, editaremos o README.md do seu projeto usando Markdown para que ele inclua algumas informações básicas sobre o projeto.

1. Na lista de arquivos, clique em README.md para exibir o arquivo.

2. No canto superior direito da exibição de arquivo, clique em para abrir o editor de arquivos.

   • Você verá que algumas informações sobre seu projeto foram pré-preenchidas para você. Por exemplo, você deve ver o nome do repositório e a descrição do repositório que você concluiu na Etapa 1 exibidos na linha 1 e na linha 2.

3. Exclua o texto existente além do # e digite um título adequado para o projeto.

   • Exemplo: # About my first project on GitHub.

4. Em seguida, adicione algumas informações sobre seu projeto, como uma descrição da finalidade do projeto ou seus principais recursos.

   Observação: se você não tiver certeza do que escrever, dê uma olhada em outros repositórios no GitHub para ver como outras pessoas descrevem seus projetos.

   Para aplicar formatação mais sofisticada, como adicionar imagens, links e notas de rodapé, consulte "Sintaxe básica de gravação e formatação no GitHub".

5. Acima do novo conteúdo, clique em Visualizar.

   

6. Veja como o arquivo será renderizado depois que salvarmos nossas alterações e, em seguida, alterne novamente para "Editar".

7. Continue a editar e visualizar o texto até o conteúdo do LEIAME estar satisfatório.

8. No canto superior direito, clique em Confirmar alterações.

9. Na caixa de diálogo que é aberta, uma mensagem do commit foi pré-preenchida para você ("Atualizar LEIAME.md") e, por padrão, a opção "Confirmar diretamente na ramificação main" foi selecionada. Deixe essas opções como estão, siga em frente e clique em Confirmar alterações.

Conclusão

Você criou um novo repositório, carregou alguns arquivos nele e adicionou um projeto LEIAME.

Se você definir a visibilidade do repositório como "Público", o repositório será exibido em seu perfil pessoal e você poderá compartilhar a URL do repositório com outras pessoas.

À medida que você adiciona, edita ou exclui arquivos diretamente no navegador em GitHub, GitHub rastreará essas alterações ("confirmações"), para que você possa começar a gerenciar o histórico e a evolução do seu projeto.

Ao fazer alterações, lembre-se de que você pode criar uma nova ramificação a partir da ramificação main do repositório, para que possa experimentar sem afetar a cópia principal dos arquivos. Em seguida, quando estiver satisfeito com um conjunto de alterações, abra uma solicitação de pull para mesclar as alterações em sua ramificação main. Para obter um lembrete de como fazer isso, consulte "Olá, Mundo".

Próximas etapas

• A maioria das pessoas deseja continuar trabalhando em seus arquivos localmente (ou seja, em seu próprio computador) e, em seguida, sincronizar continuamente essas alterações feitas localmente com o repositório "remoto" (na nuvem) no GitHub. Há muitas ferramentas que permitem que você faça isso, como o GitHub Desktop. Para começar, você precisaria:

  • Instalar o GitHub Desktop. Para obter mais informações, confira "Introdução ao GitHub Desktop".
  • Clonar o repositório remoto, para ter uma cópia dele em seu próprio computador. Para obter mais informações, confira "Clonagem e bifurcar repositórios do GitHub Desktop".
  • Sincronizar continuamente suas alterações locais com esse repositório remoto. Para obter mais informações, confira "Sincronizar seu branch no GitHub Desktop".

• Para saber mais sobre outras ferramentas disponíveis para trabalhar com repositórios hospedados no GitHub, consulte "Como conectar-se ao GitHub".

Leitura adicional

• "Sobre LEIAMEs"
• "Gerenciar arquivos"
• "Clonar um repositório"