====== GIT ======
===== Conceptos =====
El **working tree** es el directorio de trabajo, donde se crea un repositorio.

Un **commit** es la actualización del registro local en la máquina; los commits se identifican por un hash. A un commit se le puede asignar una **tag** que es un alias.

Un **push** es la actualización del repositorio remoto a partir de los cambios realizados por el commit.

{{:code:git:mgav9.png?direct&400|}}

Una **branch** es una copia del master desde la cual trabajar. Para fusionar dos branches se hace un **merge**.

Un repositorio **remote** consiste en un repositorio que no está en máquina local. 

**origin** es una keyword que indica el repositorio inicial (donde se recogieron los archivos, donde se empezó a guardar...).
===== Uso =====
==== Clone ====
Obtener un repositorio externo:
<code>
$ git clone <ruta>
</code>
Obtener un repositorio usando con otro nombre en local:
<code>
$ git clone git://github.com/schacon/grit.git otro_nombre
</code>
Obtener una branch concreta de un repsitorio:
<code>
$ git clone git://github.com/schacon/grit.git -b dev
</code>

==== Ficheros ====
=== Borrado ===
Borrar un fichero tanto local como en repositorio:
<code>
$ git rm filename.ext
</code>
Borrar un fichero sólo del repositorio:
<code>
$ git rm --cached mylogfile.log
</code>
Borrar un directorio entero en el repositorio pero no en local:
<code>
$ git rm -r --cached folderName
</code>
==== Commits ====
Indicar el commit con el comentario directamente:
<code>
$ git commit -m "the 1st commit"
</code>
Realizar un commit de cambios actualizando automáticamente los ficheros que ya existen en el working tree pero sin añadir nuevos:
<code>
$ git commit -a -m "commit message"
</code>
==== Push ====
Para subir unos cambios registrados en local al servidor:
<code>
$ git push repo_name branch_name
</code>
==== Tags ====
Para identificar un commit sin tener que referirse a él por el hash haremos (siendo ''3720b35'' el hash):
<code>
$ git tag working 3720b35
</code>
... O podremos taggear el último:
<code>
$ git tag my_identifier
</code>
Muchas veces se hacen tags por versión:
<code>
$ git tag 1.0.3
</code>
Podríamos haccer: 
<code>
$ git diff working..broken 
</code>
Podemos conocer una lista de tags existentes
<code>
$ git tag
</code>
O eliminar una tag concreta:
<code>
$ git tag -d my_tag
</code>
==== Branches ====
Antes de hacer una branch actualiza el master (pull).

Crear una branch: 
<code>
$ git branch my_branch
</code>
Subir la branch a un repositorio externo:
<code>
$ git push origin my_branch
</code>
Cambiar de branch:
<code>
$ git checkout my_branch
</code>
Saber qué branch es la tuya actual (la que tiene estrella):
<code>
$ git branch 
</code>
También podemos:
  * ''git branch -a'', ver todas las branches, las remotas también.
  * ''git branch -v'', ver más información sobre las branches.

Eliminar una branch localmente:
<code>
$ git branch -d the_local_branch
</code>

Eliminar una branch remota:
<code>
$ git push origin --delete the_remote_branch
</code>

Eliminar una branch remota (alternativa):
<code>
$ git push origin :the_remote_branch
</code>

Unir tu branch al repositorio:
<code>
$ git merge master
</code>
Eliminar una branch del working tree:
<code>
$ git branch -d my_branch
</code>
==== Merge de branches ====
=== Forzar\sobreescribir ===
Cuando quieras forzar un merge de una branch te pondrás en la destino (''checkout'') y harás:
<code>
$ git merge -X <opcion> <branch>
</code>
Donde la opción puede ser ''ours'' o ''theirs'' según la versión que se prefiera en caso de conflicto (ours para la versión de la branch actual y theirs para la de la que quieres hacer merge).

===== Versiones =====
Para volver temporalmente a una versión anterior
<code>
$ git checkout <id_commit>
</code>

===== Workflows =====
==== El tuyo ====
=== GitHub ===
Obtener un repsitorio:
<code>
$ git clone https://github.com/ElectronicStars/Hindbrain
</code>
Actualizar el repositorio:
<code>
$ git add .
$ git commit -a
$ git push
</code>
Subir a una branch que no existe en GitHub o que es distinta a la master:
<code>
$ git push origin my_branch
</code>
===== Administración de repositorios =====
===== Git Avanzado =====
===== Notas =====
==== Recursos ====
=== Tutoriales ===
  * [[http://gitimmersion.com/|Git Immersion]]