Repositórios
Um repositório contém os ficheiros, ramos e o histórico de um projeto. Este guia explica como criar um repositório e ligar-se a ele a partir do seu computador.
Criar um repositório
Seção intitulada “Criar um repositório”- Abra o Git a partir da sua área de trabalho.
- Selecione o menu + no canto superior direito e depois New Repository.
- Introduza um nome e, opcionalmente, uma descrição curta.
- Escolha a visibilidade. Os novos repositórios são Privado por predefinição – somente os membros a quem conceder acesso podem vê-los.
- Opcionalmente, selecione Initialize Repository para adicionar um README, um ficheiro
.gitignoree uma licença. - Selecione Create Repository.
Os colaboradores não podem criar repositórios diretamente na organização Git da área de trabalho; os repositórios são criados pelo PlaidCloud.
Gerar um token de acesso pessoal
Seção intitulada “Gerar um token de acesso pessoal”Como entra pelo PlaidCloud, a sua conta não tem uma palavra-passe Git separada. Para clonar ou fazer push por HTTPS na linha de comando, crie um token de acesso pessoal e use-o no lugar da palavra-passe.
- Selecione o seu avatar no canto superior direito e depois Configurações. O cartão de configuração no separador Git também tem um link direto para esta página.
- Abra o separador Aplicações.
- Em Gerir tokens de acesso, introduza um nome que descreva onde usará o token (por exemplo,
laptop). - Selecione a permissão write:repository para que o token possa clonar e fazer push.
- Selecione Generate Token.
- Copie o token e guarde-o num local seguro. Não poderá voltar a vê-lo.
Clonar um repositório
Seção intitulada “Clonar um repositório”-
Abra o Git na sua área de trabalho e selecione o botão de copiar ao lado do endereço de clone do repositório (selecione How to clone para ver os passos de configuração). Também pode selecionar Código no repositório e copiar a URL HTTPS.
-
Num terminal, execute
git clonecom essa URL:Janela do terminal git clone <clone URL> -
Quando o Git pedir uma palavra-passe, cole o token de acesso. Use o nome de utilizador que já está na URL.
-
Defina o nome e o e-mail que o Git regista nos seus commits, usando os valores que o cartão de configuração mostra:
Janela do terminal git config --global user.name "Your Name"git config --global user.email "you@example.com"
Precisa de acesso de Colaborador ou Administrador para fazer push; como Leitor, pode ler, mas não fazer push. Consulte Níveis de acesso.
Fazer commit e push das alterações
Seção intitulada “Fazer commit e push das alterações”A partir de dentro de um repositório clonado:
- Adicione as suas alterações à área de stage:
git add . - Registe-as com uma mensagem:
git commit -m "Describe what changed" - Envie-as ao PlaidCloud Git:
git push
Os seus commits aparecem nas vistas Commits e Atividade do repositório, e em qualquer ramo ou pull request que os inclua.
Gerir acesso e visibilidade
Seção intitulada “Gerir acesso e visibilidade”Abra o separador Configurações de um repositório para renomeá-lo, alterar a visibilidade ou transferir a propriedade. Para permitir que outros membros contribuam, use Configurações → Collaborators e adicione-os por nome de utilizador com a função Leitura, Escrita ou Administrador.
Próximos passos
Seção intitulada “Próximos passos”- Implementar uma aplicação Panel a partir deste repositório – transforme o código de aplicação que enviou aqui numa aplicação publicada
- Implementar uma aplicação Dash a partir deste repositório – o mesmo caminho para uma aplicação Plotly Dash
- Acompanhe o trabalho com issues
- Proponha alterações com pull requests