====== GIT (old) ======
===== Básico =====


==== Vocabulario y keywords ====
  * **Index**: Índice de cambios que se han realizado entre un commit y otro en un proyecto o working tree.
  * **HEAD**: Keyword para la última versión.








==== Trabajo con GIT en local ====
=== Crear repositorio ===
El repositorio (o working tree) se creará en el directorio donde se llame al siguiente comando:
<code>
$ git init
</code>
Una vez se tiene el repositorio se han de agregar elementos.
=== Agregar elementos al working tree ===
Para añadir un elemento haremos:
<code>
$ git add file.txt
$ git add directory
</code>
La acción de agregar se realiza recursivamente, por lo que si añadimos un directorio al working tree se añadirán también sus subdirectorios y ficheros.
=== Modificar elementos ===
Con el mismo parámetro ''add'' agregamos un cambio.\\
Por ejemplo, si hemos modificado //file.txt// que ya estaba en el repositorio:
<code>
$ git add file.txt
</code>
=== Mover elementos a otros directorios ===
<code>
$ git mv file.txt directory
</code>

==== Multiples repositorios ====
=== Clonar repositorio ===
<code>
$ git clone repo cloned_repo
</code>
=== Ver información sobre el repositorio del que viene ===
Ver nombre del repositorio que viene.
<code>
$ git remote
</code>
Ver información de un repositorio remoto.
<code>
$ git remote show repo_name
</code>
=== Subir cambios a un repositorio remoto ===
<code>
$ git fetch
</code>
Esto sube los cambio pero no los actualiza, para ello debemos hacer:
<code>
$ git fetch
$ git merge origin/master
</code>
O, en un único comando:
<code>
$ git pull
</code>

===== Funcionamiento =====















==== Gestión de commits ====
Cada vez que se realiza un commit la versión actual apunta a la anterior y, en cascada, se van almacenando los cambios en el proyecto.
=== Revertir al último commit ===
Sin haber realizado ningún cambio (''add''):
<code>
$ git checkout somefile.txt
</code>
Habiendo realizado algún cambio (sólo un fichero):
<code>
$ git reset HEAD somefile.txt
</code>
Habiendo realizado algún cambio (todo el proyecto):
<code>
$ git reset HEAD
</code>
=== Revertir a un commit concreto ===
Esto crearía un segundo commit idéntico al escogido pero posterior al actual.
<code>
$ git revert 068b9b9
</code>


==== Visión de cambios ====
=== Ver historial de cambios ===
Historial largo:
<code>
$ git log
</code>
Historial corto:
<code>
$ git log --pretty=oneline --abbrev-commit
</code>
Historial completo:
<code>
$ git log -p
</code>
Formatear el historial:
<code>
$ git log --all --pretty=format:"%h %cd %s (%an)" --since='7 days ago'
$ git log --pretty=format:"%h %ad | %s%d [%an]" --graph --date=short
</code>
=== Ver últimos cambios realizados ===
<code>
$ git status
</code>
=== Ver diferencia entre commits ===
Comparar un commit con su predecesor:
<code>
$ git show 3720b35
</code>
Comparar dos commits:
<code>
git diff a2a1eb3..068b9b9
</code>




==== Configuración ====
=== Datos de usuario (por proyecto) ===
<code>
$ git config user.name "John Q. Public"
$ git config user.email "johnq@example.com"
</code>
=== Datos de usuario (globales)  ===
Para todos los proyectos:
<code>
$ git config --global user.name "John Q. Public"
$ git config --global user.email "johnq@example.com"
</code>
=== Salida por consola ===
Agregar colores (para acciones como ''diff'', ''status''...):
<code>
$ git config --global color.ui auto
</code>









===== Avanzado =====



==== Archivo .gitconfig ====
En el directorio personal de tu usuario existirá un archivo denominado .gitconfig, este tendrá tu configuración.
=== Agregar alias ===
<code>
[alias]
  co = checkout
  ci = commit
  st = status
  br = branch
  hist = log --pretty=format:\"%h %ad | %s%d [%an]\" --graph --date=short
  type = cat-file -t
  dump = cat-file -p
</code>
Si los agregramos, al hacer ''git co'' estaremos haciendo un ''git checkout'' (por ejemplo).

==== Directorio .git ====
  * [[http://gitimmersion.com/lab_22.html|Explicación]]
==== Ignorar ficheros ====
Podemos indicar reglas para ignorar los ficheros de un directorio con el fichero ''.gitignore'' del proyecto. \\ 
Podemos hacerlo globalmente con:
<code>
$ git config --global core.excludesfile ~/.gitignore_global
</code>
O haciendo que no se añadan al repositorio con desde ''.git/info/exclude''.
=== Repositorio ===
  * {{:code:git:python.gitignore.zip|Gitignore recomendado para Python}}
  * [[https://github.com/github/gitignore|Repositorio]]
===== Cómo... =====
=== Ver el último commit? ===
<code>
$ git hist --max-count=1
</code>
=== Impedir el commit ===
<code>
$ git reset
</code>
:!:... Y dejarlo como estaba.
<code>
$ git reset --hard
</code>

==== GitHub ====
  * [[https://github.com/]]
=== Crear repositorio ===
=== Descargar repositorio ===
<code>
$ git clone https://github.com/epintor/Hindoor.git
</code>
=== Actualizar el repositorio ===
Realizar cualquiera de los comandos de modificación:
  * git add 
  * git rm
  * git mv
Hacer un commit.
<code>
$ git commit -a
</code>
Si (y sólo si) hay cambios en la branch 'master':
<code>
$ git pull origin master
</code>
Subir los cambios (a la branch 'master'):
<code>
$ git push origin master
</code>

===== Herramientas =====




==== GUIs ====
=== Meld ===
Para ver cambios realizados en un repositorio:
  * [[http://meld.sourceforge.net/install.html|web]]
  * [[http://www.linux.com/archive/feature/61372|artículo]]
=== QGit ===
  * [[http://digilander.libero.it/mcostalba/|web]]
=== Giggle ===
Visor para GNOME:
  * [[http://live.gnome.org/giggle|web]]


==== Plugins para IDEs ====
=== Egit ===
Plugin para eclipse:
  * [[http://www.eclipse.org/egit/|web]]
  * [[http://wiki.eclipse.org/EGit/User_Guide|tutorial]]
==== Servidor Gitosis ====
En Ubuntu existe el paquete ''gitosis'' que instala un servidor GIT. \\ 

===== Notas =====
==== Links ====
  * Libro de la comunidad de GIT: [[http://book.git-scm.com/]]
  * Los 10 mejores tutoriales: [[http://sixrevisions.com/resources/git-tutorials-beginners/]]