Github: Tutorial

{{{1}}}

O Github é um repositório de projetos de código fonte aberto. A maior parte dos grandes projetos open source é desenvolvida por lá, e só para citar alguns dos grandes, estão lá por exemplo: o Linux, o WordPress, vários projetos da fundação Apache, .NET, Django, Rails, o Docker dentre muitos outros.

Segue um tutorial passo a passo para adicionar seu projeto no repositório.

1) crie um repositório do git do zero:

git init

2) adicione os arquivos:

git add -A .

Configure o GIT

git config --global user.email "meu_email@servidor.com"
git config --global user.name "Meu Nome Completo"

3) dê o primeiro commit:

git commit -am "Primeiro commit"

4) Use o comando curl para criar o seu repositório no github. Troque meu_usuario pelo seu usuario e meu_projeto.git pelo nome do seu projeto:

curl -u 'meu_usuario' https://api.github.com/user/repos -d \
'{"name":"meu_projeto.git","description":"Descrevendo meu projeto."}'

5) Adicione o remoto:

git remote add origin https://github.com/meu_usuario/meu_projeto.git

6) Envie tudo para o remoto:

git push -u origin master

Referência: Texto de Flávio Barros (2015). Criando Repositórios no Github a partir do Shell.

Ignorando Arquivos e Pastas

Para ignorar elementos como arquivos compilados, logs, backups, etc, deve-se colocar esses arquivos e pastas em um arquivo chamado .gitignore com os padrões a serem ignorados. Por exemplo:

Fotos-[0-9]-*.jpg
*.jar
[Tt]mp/

Por exemplo, caso não se queira versionar os arquivos .jar, basta adicionar a seguinte linha no arquivo .gitignore:

*.jar

O caractere * é curinga e indica que todos os arquivos com extensão jar devem ser ignorados.

Para testar quais arquivos são afetados por esse padrão usa-se o comando:

$ git ls-files --exclude-standard *.jar -oc

Existem outros padrões que podem ser utilizados, com por exemplo para ignorar um pasta inteira:

bin/

Como o git é case sensitive, para ignorar uma pasta que pode ter inicial tanto maiúscula como minúscula, basta usar:

[Tt]mp/

Pode-se também ignorar arquivos usando expressões regulares:

Foto-[0-9]-*.jpg

Assim caso tivéssemos um arquivo com nome Fotos-3-casa.jpg este seria ignorado.

Caso você queira ignorar arquivos em todos os repositórios, basta criar um arquivo .gitignore no seu diretório de usuário e adicioná-lo ao arquivo de configuração global do git:

$ git config --global core.excludesfile ~/.gitignore

Atualizar seu projeto no github

git add -A .
git commit -m "alterações"
git push origin master

Se você apagou algum arquivo, pode dar conflito. Pode usar o push forçado com o comando:

git push -f origin master

Tutorial