Etiquetas:

O GitHub é uma plataforma de colaboração e gestão de versões de código aberto para programadores de software. Baseia-se no Git, uma ferramenta de controlo de versões de código aberto. Fornece uma cronologia de desenvolvimentos sem perdas, que pode ser facilmente multi-utilizador, especificando o autor, a data e a descrição (mensagem) de cada alteração feita por um dos utilizadores. Existe um sistema de ramificação para diferentes versões de código com um núcleo comum.

Aquilo a que chamamos um repositório Git é uma espécie de sistema de ficheiros (base de dados), que regista as versões dos ficheiros de um projeto em momentos específicos sob a forma de instantâneos. É importante acompanhar os seus desenvolvimentos nos seus projectos bem estruturados.

É importante saber que o Github não é o único site de repositórios que funciona com o Git. As linhas de comando deste tutorial também são compatíveis com GitLab, Gerrit, Bitbucket e Codebase, para citar os mais conhecidos. Neste tutorial, vamos concentrar-nos no Github.

Instalação

Instalar o Git Bash: Isto permitirá que o Terminal do seu computador reconheça e execute os comandos Git que veremos mais tarde.

Também pode instalar o Git no Linux com o seguinte comando na consola :

sudo apt-get install git

Instalando o TortoiseGit: O TortoiseGit é uma extensão do Windows para utilizar os comandos Git graficamente através do Explorador de Ficheiros. As funções Git serão opções adicionais acessíveis ao clicar com o botão direito do rato em qualquer pasta.

Clonagem de um repositório

Uma vez instalado o Git, é necessário começar por clonar um repositório criado no Github. Quando o seu repositório do Github estiver pronto, abra o terminal de comandos e comece por criar o diretório no seu computador que irá receber o clone do repositório.

mkdir nom-de-repertoire
cd nom-de-repertoire

Em seguida, configura o Git com os seus identificadores (adapta o conteúdo):

git init git config --global user.name "VotrePrénom VOTRENOM"git config --global user.email "votremail@mail.com"

E acabamos por clonar o repositório num ficheiro :

git clone https://github.com/VotreRepository [NomRepertoire]

Download de um repositório de linha de comando no Linux

Para descarregar ficheiros de um repositório, é necessária uma chave de segurança (ou token) associada à sua conta github.

Criar uma chave SSH no github :

$ ssh-keygen -t ed25519 -C "your_email@example.com"

iniciar o ssh-agent e adicionar a chave ao ssh-agent

$ eval "$(ssh-agent -s)"
$ ssh-add ~/.ssh/id_ed25519

Por fim, adicione a chave SSH à sua conta

Introduzir o seguinte comando para visualizar a tecla ” “

$ cat ~/.ssh/id_ed25519.pub

Copie o resultado do comando para as definições da sua conta github no menu Chaves SSH e GPG.

Depois de a chave ter sido gerada e associada à sua conta, pode introduzir o seguinte comando para descarregar o repositório

git clone git@github.com:<account_name>/<repo_name>.git

Atualização de alterações (add, commit, push e pull)

Depois de clonar o seu repositório no seu diretório, se tiver feito alterações no diretório, quer seja um novo ficheiro ou uma alteração a um ficheiro existente, terá agora de atualizar o repositório em linha, que manterá um registo das suas alterações:

git add NomDuFichier.extension
git commit -m "commentaire"

add adiciona um novo arquivo ou suas modificações ao repositório atual. Você pode fazer vários em sequência. O commit permite que você faça alterações no repositório, incluindo os arquivos que acabou de adicionar e as alterações feitas nos arquivos com o git add. Você pode adicionar (e isso é altamente recomendado) um comentário ao commit para especificar o que foi alterado, adicionado ou excluído. Isso facilitará a leitura do histórico de commits no repositório.

git push origin main

push é usado para fazer push do branch atual para o branch que você deseja direcionar no repositório remoto. Aqui, origin main especifica o push do branch principal (local) para o branch principal (origem). A partir de agora, você verá as alterações no seu repositório aparecerem no repositório on-line, juntamente com o commit e o respectivo comentário feito imediatamente antes. git add, git commit e git push são comandos complementares.

git pull origin main

pull descarrega e funde novos dados do repositório remoto no seu diretório. Isso atualizará seu diretório em relação ao repositório on-line com os últimos commits que foram enviados para ele. Também pode adicionar a opção -rebase antes do repositório e da origem, para que, em vez de fazer merge dos novos dados, faça rebase do seu diretório (mas nunca faça isto num repositório público).

Listas de comandos básicos

Segue-se uma lista não exaustiva de comandos Git que é útil conhecer:

git status

status mostra o estado dos ficheiros no diretório atual. Existem 3 estados diferentes:- Ficheiros não rastreados: ficheiros não versionados (que não foram adicionados e são novos);- Alterações a confirmar: modificações (adições, eliminações, alterações) carregadas na área de preparação (adicionar mas não confirmar) ou indexadas;- Alterações não preparadas para confirmação: modificações que não foram carregadas na área de preparação (ficheiros que já existem mas não foram adicionados ou confirmados).

git reset Nomdufichier.extension

reset cancela as alterações indexadas a um ficheiro.

git checkout -- Nomdufichier.extension

checkout é utilizado para cancelar alterações a um ficheiro que ainda não tenha sido indexado.

git log 

log mostra o histórico dos commits.

git rm Nomdufichier.extension 

rm é utilizado para indexar a eliminação de um ficheiro. Pode adicionar a opção -cached antes do nome do ficheiro para anular a eliminação do ficheiro.

git diff

diff é usado para exibir detalhes de modificações não indexadas. Você pode adicionar a opção – staged para modificações indexadas.

git remote

remote é usado para exibir a lista de todos os repositórios remotos do projeto (alguns projetos podem funcionar com diferentes repositórios remotos para um único projeto).

git remote add Nom https://github.com/VotreRepository

O remote add é uma alternativa ao git clone, mas enquanto o git clone copia o repositório on-line, aqui você adiciona um novo repositório ao lado de um que já existe no seu computador, no seu diretório.

git fetch origin

fetch recupera alterações de um repositório remoto (o nome do repositório geralmente é origin, mas você pode adaptá-lo para atender às suas necessidades).

Utilizar o Tortoise

Para aqueles que não têm vontade de escrever linhas de comando num terminal no Windows, pode utilizar o TortoiseGit para utilizar o Git graficamente.

Crie uma pasta vazia e clique com o botão direito do rato sobre ela. As opções do TortoiseGit aparecerão, dando-lhe acesso aos vários comandos Git:

tortoise-clone Algumas notas sobre a utilização do Git

Começamos por configurar o TortoiseGit clicando em Settings :

tortoise-settings Algumas notas sobre a utilização do Git

Para alterar o nome e o e-mail, clique em Edit global .gitconfig e introduza o seu nome e e-mail.

Pode então clonar um repositório clicando em Clonar :

tortoise-clone-2 Algumas notas sobre a utilização do Git

Na primeira vez que clonar um repositório, poderão abrir-se janelas adicionais pedindo-lhe para se ligar à sua conta Github. Faça-o.

Para recuperar os dados, basta clicar em Pull. Aqui pode escolher de que ramo e de que repositório pretende obter os dados:

tortoise-pull Algumas notas sobre a utilização do Git

Para enviar as alterações efectuadas localmente, basta clicar em Commit. É aconselhável escrever um comentário, o nome do autor do commit e a data e hora. Também pode fazer Push ao mesmo tempo, utilizando a opção Commit&Push. Clique em Log para ver o histórico de commits:

tortoise-commit-and-comment-1 Algumas notas sobre a utilização do Git

Fontes