Wiki de Caballero - User contributions [en]

Limpiar Caché rápido para Recargar Páginas

2015-10-05T17:38:35Z

Alex: /* Safari */

== Chrome / Firefox ==

=== Macintosh ===
cmd + shift + r

=== Windows / Linux ===
crtl + shift + r

== Internet Explorer ==
=== Macintosh / Windows / Linux ===
ctrl + F5

== Safari ==
=== Macintosh ===

* Probar con "cmd+r", si no funciona realizar los puntos de a continuación.
* Presionar las teclas "cmd + ,".
* Ir a la pestaña '''Privacity'''.
* Presionar el botón '''Remove All Website Data....'''.
* Click '''Remove Now'''.

=== Windows / Linux ===

* Probar con "ctrl+r", si no funciona realizar los puntos de a continuación.
* Click en '''Tools''' > '''Reset Safari...'''.
* Hacer Check a los casilleros '''Empty the cache''' y '''Remove all cookies'''.
* Presionar botón '''Reset'''.

Limpiar Caché rápido para Recargar Páginas

2015-10-05T16:11:43Z

Alex: /* Windows / Linux */

== Chrome / Firefox ==

=== Macintosh ===
cmd + shift + r

=== Windows / Linux ===
crtl + shift + r

== Internet Explorer ==
=== Macintosh / Windows / Linux ===
ctrl + F5

== Safari ==
=== Macintosh ===
* Presionar las teclas "cmd + ,".
* Ir a la pestaña '''Privacity'''.
* Presionar el botón '''Remove All Website Data....'''.
* Click '''Remove Now'''.

=== Windows / Linux ===

* Click en '''Tools''' > '''Reset Safari...'''.
* Hacer Check a los casilleros '''Empty the cache''' y '''Remove all cookies'''.
* Presionar botón '''Reset'''.

Limpiar Caché rápido para Recargar Páginas

2015-10-05T16:11:10Z

Alex: /* Windows / Linux */

== Chrome / Firefox ==

=== Macintosh ===
cmd + shift + r

=== Windows / Linux ===
crtl + shift + r

== Internet Explorer ==
=== Macintosh / Windows / Linux ===
ctrl + F5

== Safari ==
=== Macintosh ===
* Presionar las teclas "cmd + ,".
* Ir a la pestaña '''Privacity'''.
* Presionar el botón '''Remove All Website Data....'''.
* Click '''Remove Now'''.

=== Windows / Linux ===

* Click en Tools > Reset Safari....
* Hacer Check a los casilleros '''Empty the cache''' y '''Remove all cookies'''.
* Presionar botón '''Reset'''.

Limpiar Caché rápido para Recargar Páginas

2015-10-05T16:07:47Z

Alex: /* Macintosh */

== Chrome / Firefox ==

=== Macintosh ===
cmd + shift + r

=== Windows / Linux ===
crtl + shift + r

== Internet Explorer ==
=== Macintosh / Windows / Linux ===
ctrl + F5

== Safari ==
=== Macintosh ===
* Presionar las teclas "cmd + ,".
* Ir a la pestaña '''Privacity'''.
* Presionar el botón '''Remove All Website Data....'''.
* Click '''Remove Now'''.

=== Windows / Linux ===
ctrl + F5

Limpiar Caché rápido para Recargar Páginas

2015-10-05T15:50:01Z

Alex: /* Windows / Linux */

Limpiar Caché rápido para Recargar Páginas

2015-10-05T15:48:44Z

Alex: Created page with " == Chrome / Firefox == === Macintosh === cmd + shift + r === Windows / Linux === crtl + shift + r == Internet Explorer == === Macintosh / Windows / Linux === ctrl + F5 ==..."

Compass y Sass, Instalación

2015-10-01T19:18:40Z

Alex: /* El Capitan 10.11 */

==Ubuntu==
Instalar Ruby:
<syntaxhighlight lang="bash" line>
sudo apt-get install ruby-full rubygems1.8
</syntaxhighlight>
Instalar SASS:
<syntaxhighlight lang="bash" line start=2>
sudo gem install sass
</syntaxhighlight>
Instalar Compass:
<syntaxhighlight lang="bash" line start=2>
sudo gem install compass
</syntaxhighlight>

==OS X==

===Mavericks 10.9.4===
<source lang="bash">
sudo gem update --system
sudo gem install compass
</source>

===El Capitan 10.11===
En El Capitan, la carpeta por defecto para instalar gemas no se puede acceder por defecto y hay que [[cambiar la configuración de gem para poder instalar en El Capital]]. Luego hay que correr los comandos:

<source lang="bash">
sudo gem update --system
sudo gem install compass
</source>

'''NOTA:''' Tomar en cuenta los errores que aparecen en "Output -Sass (compile)" de Netbeans o del terminal.

Mac OS X, Instalar Collabtive

2015-09-14T15:00:02Z

Alex: /* Instalación de Collabtive */

== Instalación de Collabtive ==

# Descomprima Collabtive.
# Suba todo a su servidor, incluyendo las carpetas "/files" y "/templates_c".(Puede que necesite crear las carpetas "/files" y "/templates_c" de forma manual antes de la instalación)
# Asigne permisos de escritura a los siguientes archivos y carpetas:
* /templates_c
* /files
* /config/standard/config.php
# Cree una nueva base de datos MySQL para Collabtive, con nombre de '''collabtive'''.
# Editar '''/config/standard/config.php''' cambiar '''localhost''' por '''127.0.0.1'''
# Acceda con su navegador a "install.php" y siga las instrucciones.
# Cuando la instalación haya terminado correctamente, borre el archivo "install.php" y "update.php".

Mac OS X, Instalar Collabtive

2015-09-14T14:56:36Z

Alex: Created page with " == Instalación de Collabtive == # Descomprima Collabtive. # Suba todo a su servidor, incluyendo las carpetas "/files" y "/templates_c".(Puede que necesite crear las carpet..."

== Instalación de Collabtive ==

# Descomprima Collabtive.
# Suba todo a su servidor, incluyendo las carpetas "/files" y "/templates_c".(Puede que necesite crear las carpetas "/files" y "/templates_c" de forma manual antes de la instalación)
# Asigne permisos de escritura a los siguientes archivos y carpetas:<br>
- /templates_c<br>
- /files<br>
- /config/standard/config.php<br>
# Cree una nueva base de datos MySQL para Collabtive, con nombre de '''collabtive'''.
# Editar '''/config/standard/config.php''' cambiar '''localhost''' por '''127.0.0.1'''
# Acceda con su navegador a "install.php" y siga las instrucciones.
# Cuando la instalación haya terminado correctamente, borre el archivo "install.php" y "update.php".

Main Page

2015-09-14T14:51:17Z

Alex: /* Mac OS X */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Web==

===Apache===
# [[Habilitar .htaccess]]
# [[Apache, restringir acceso]]
# [[Apache, .htacces]]

===Javascript===
# [[Javascript, Variables en URL como Anchors]]
# [[Crear librería de JavaScript]]
# [[Bloque try catch]]
# [[Asignar multiples eventos a un selector]]

===PHP===
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Subir archivo a servidor |Subir archivo(s) al servidor con PHP]]
# [[Ámbito de clases PHP |Ámbito de clases en PHP]]
# [[Simular "text-overflow:ellipsis" |Simular "text-overflow:ellipsis" ]]

===Compass y Sass===
# [[Compass y Sass, Instalación]]
# [[Compass y Sass, Configuración y uso]]

==Mediawiki==
# [[MediaWiki, elementos colapsables]]
# [[Manejar Permisos Wikimedia]]
# [[Extension Wiki SyntaxHighlight]]

==MySQL==
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Importar archivo.sql por Terminal]]
# [[Usuarios Mysql]]
# [[Errores MySql]]
# [[MySQL, iniciar, detener o reiniciar]]

==NetBeans==
# [[Multiples filas de pestañas NetBeans]]
# [[Cómo documentar un Proyecto en PHP con NetBeans]]
# [[Compilar archivos Sass al grabar en Netbeans]]
==OS==

===*nix (Sistemas tipo Unix)===
# [[*nix, crear alias de comandos]]

===Linux===
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Búsquedas de archivos y texto]]
# [[Linux, Cambiar directorio home por defecto]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado (Ubuntu 14.04)]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Linux, Tips y Trucos]]
# [[Iniciar con Grub Ubuntu]]
# [[Instalar lftp]]
# [[Instalar Firewall Firestarter en Ubuntu 14.04]]
# [[Instalción y uso de ImageMagick]]

===Mac OS X===
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar mcrypt]]
# [[Instalción y uso de ImageMagick]]
# [[OS X, Automator y AppleScript]]
# [[Mac OS X, Instalar Collabtive]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]
# [[Git, Rebase]]

==Trabajo IT==
===Metodologías===
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Como hacer un diagrama de flujo]]
# [[Métodos de programación]]
# [[Método Científico]]
# [[Multitasking versus Monotasking]]

===Estándares===
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Cómo Generar Documentación en JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]
# [[Firmas de funciones en programación]]

Git, Branching

2015-08-24T16:49:27Z

Alex: /* Remotes, ramas remotas */

''Branching'' funciona como caminos diferentes que pueden volver a unirse. En un punto determinado de la historia del proyecto se crean dos caminos que contienen lo mismo pero que pueden cambiar independientemente.

Existe un puntero HEAD que apunta a la rama actual.

La rama maestra se crea por defecto y se llama ''master''.

Antes de cambiar de rama (''checkout'') es buena idea hacer un commit.

El [http://git-scm.com/book/en/Git-Branching-Branching-Workflows libro oficial] muestra un par de formas de trabajo con ramas, flujos de trabajo.

Cuando se trabaja remotamente se trabaja con ramas, la rama remota por defecto es origin/master, origin siendo el ''remote'' y ''master'' siendo la rama.

==Crear una rama nueva, nueva branch==
Para crear una rama nueva se ejecuta el siguiente comando.
<syntaxhighlight lang="bash">
git branch nuevaRama
</syntaxhighlight>
'''Nota''': Esto no carga la rama directamente, solo la crea.

==Listar ramas==
<syntaxhighlight lang="bash">
git branch
</syntaxhighlight>
Para más información ver [http://git-scm.com/book/en/Git-Branching-Branch-Management libro oficial].

==Cargar una rama==
Este comando carga el contenido de una rama y hace que el puntero HEAD apunte a dicha rama.
<syntaxhighlight lang="bash">
git checkout nuevaRama
</syntaxhighlight>

==Cargar la rama maestra==
Este comando carga el contenido de la rama maestra y hace que el puntero HEAD apunte a dicha rama.
<syntaxhighlight lang="bash">
git checkout master
</syntaxhighlight>

==Crear rama y cargarla==
<syntaxhighlight lang="bash">
git checkout -b nuevaRama
</syntaxhighlight>
Es un atajo que hace lo mismo que:
<syntaxhighlight lang="bash">
git branch nuevaRama
git checkout nuevaRama
</syntaxhighlight>

==Merge branches (unificar ramas)==
Lo siguiente deja como rama de trabajo a ''master'' y sobre esta introduce nuevaRama.
<syntaxhighlight lang="bash">
git checkout master # Se carga la rama master estando en otra rama
git merge nuevaRama # Se hace merge de la nuevaRama sobre master
</syntaxhighlight>
Otra forma de llegar al mismo resultado de un ''merge'' es haciendo un ''rebasing'' que integra todos los cambios que se han producido en una rama a otra y desapareciendo la rama. Para más información de cómo funciona y casos de uso ver [http://git-scm.com/book/en/Git-Branching-Rebasing libro oficial].

==Borrar una rama==
Se pueden borrar ramas cuando se desee pero puede ser buena idea hacerlo cuando se planee no usarla más, eso puede ocurrir por ejemplo cuando se trabajo en una rama, se unió al ''master'' y ya no tiene sentido tener la rama todavía porque no se va a trabajar más sobre ella.
<syntaxhighlight lang="bash">
git branch -d nuevaRama
</syntaxhighlight>

==Remotes, ramas remotas==

===Listar rama remota===

Para ver las ramas remotas a las que hacemos seguimiento, utilizamos el comando branch con el parámetro -r:
<syntaxhighlight lang="bash">
git branch -r
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.
<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener rama remota===
No muestra los archivos obtenidos solo los obtiene.
<syntaxhighlight lang="bash">
git fetch nombreRemote [nombreRama] # Si no se especifica nombreRama obtiene master
</syntaxhighlight>

===Obtener cambios de rama remota===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreRemote nombreRamaRemote # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a rama remota===
<syntaxhighlight lang="bash">
git push nombreRemote nombreRama[:nombreRamaEnServidor] # :nombreRamaEnServidor es opcional y setea el nombre de la rama en el servidor
</syntaxhighlight>

===Tracking Branches, ramas locales que siguen una rama remota===
Son ramas que permiten hacer <code>git push</code> y <code>git pull</code> sin argumentos, tienen una relación directa con la rama remota. Los siguientes comandos hacen lo mismo: crean una rama local, obtienen la fuente de una rama remota y asocian la rama remota con la local.
<syntaxhighlight lang="bash">
git checkout -b nombreRamaLocal nombreRemote/nombreRamaRemote # Forma de creación generica
git checkout --track nombreRemote/nombreRamaRemote # Forma reducida, no se especifica nombre local, Git > v1.6.2
</syntaxhighlight>

===Borrar ramas remotas===
Conceptualmente, el siguiente comando hace que se suba una rama local ''inexistente'' en una rama remota, lo que hace que se borre la remota.
<syntaxhighlight lang="bash">
git push nombreRemote :nombreRama
</syntaxhighlight>

==Conflictos==
Para más información sobre cuando se producen conflictos y cómo resolverlos trabajando con ''branches'', ver [http://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging#Basic-Merge-Conflicts libro oficial].

[[Category: Git]]

Cómo documentar un Proyecto en PHP con NetBeans

2015-06-02T15:40:17Z

Alex: /* Usando Terminal para ApiGen 4+ */

==Instalación==
Estas instrucciones aplican para ApiGen 4+.

# Descargar código de http://www.apigen.org.
# Guardarlo en un directorio, se sugiere en OS X en /usr/local/apigen.
# Volver ejecutable el archivo descargado.
# Agregar el archivo al PATH para ser usado desde cualquier parte. <source lang="bash">sudo ln -s /usr/local/apigen/apigen.phar /usr/local/bin/apigen</source>

== Configuración Netbeans ==
'''Nota''': Esta forma no aplica con ApiGen 4+.

Ingresar a la pestaña Profile -> Options.

==== ApiGen ====

- ApiGen Script: '''/usr/local/netbeans-7.3/apigen/apigen.php'''

==Cómo Documentar==

=== Para las Clases ===

#En la línea anterior de cada clase escribir /**.
#En la siguiente línea poner * una breve descripción de la clase
##Si es necesario una descripción mas extensa de la clase, hacer un salto de línea y escribir.
#La tercer línea terminar la documentación con un */.
#En la línea anterior a los parámetros, escribir /**.
#Se creará el parámetro, especificar tipo y describir función.
#Terminar con un */.

==== Ejemplo ====
Esto es solo una calse de ejemplo, para mostrar el formato de documentación.
<syntaxhighlight lang="php">
/**
* Esta clase es una estructura necesaria para interactuar con ProcessMaker
*
* Descripción extensa.
*/
class variableStruct {

/** @var string nombre del parámetro. */
public $name;

/** @var string valor del parámetro. */
public $value;
}
</syntaxhighlight>

=== Para las Funciones ===

#En la línea anterior de cada función escribir /** y presionar la tecla enter.
#Netbeans creará una lista de parámetros utilizados en la función, cada uno con el tipo y su nombre, les aparecerá algo como esto: * @param type $nombre, lo que se debe cambiar es el type, por el tipo de dato (ej:string,array,etc) y después de $nombre en la misma línea escribir que contiene este dato(ej:nombre del usuario).
#En la línea posterior a /**, escribir una breve descripción de la función.
##Si la función es demasiado larga es recomendable utilizar tag de html (ej:<ul><li>paso 1</li><li>paso 2</li></ul>) para ir describiendo paso a paso la función.

==== Ejemplo ====

Esto es solo una función de ejemplo, para mostrar el formato de documentación.

<syntaxhighlight lang="php">
/**
* Reasigna los casos al usuario indicado.
*
* Se llevan a cabo los siguientes pasos:
* <ul>
* <li>Se obtienen los datos del caso a resignar.</li>
* <li>Se obtiene el ID del usuario a reasignar.</li>
* <li>Se reasigna el caso.</li>
* </ul>
*
* @author nombre apellido <correo>
*
* @param string APP_UID del caso.
* @param int DEL_INDEX del caso.
* @param string USR_UID del usuario ya asignado.
* @param string USR_UID del nuevo usuario a asignar.
*/
public function reasignarCaso($idCaso, $delIndex, $idOldUser, $idNewUser) {
G::LoadClass("case");
$cnn = Propel::getConnection("workflow");
$stmt = $cnn->createStatement();
$c = new Cases();
//Reasigna los casos seleccioandos a un nuevo usuario
$var = $c->reassignCase($idCaso, $delIndex, $idOldUser, $idNewUser);
}
</syntaxhighlight>

=== Importante ===

#El formato de la documentación de cada función empieza con /**
#Cada línea de contenido debe comenzar con un *
#Finalizar la documentación con */.

==Generar la documentación==

===Usando NetBeans===

Una vez terminada la documentación de cada función y de todas las páginas php que necesita.
# Ir a la pestaña '''Window->Projects(Ctrl+1)''', donde nos listará todos los proyectos que tenemos en nuestro NetBeans.
# Hacer click derecho encima de nuestro proyecto el cuál hemos documentado y presionar en '''“Properties”''', en la sección de '''“Categories”''' ir a '''“ApiGen”'''
# En '''“Target Directory”''' debemos indicar la carpeta en donde se generará nuestra documentación (es recomendable crear una carpeta nueva “documentación” dentro del mismo proyecto) y ok.
# Luego de hacer los pasos anteriores, volver hacer click derecho a nuestro proyecto y presionar '''“Generate Documentation”'''.
# NetBeans genera la documentación y la muestra en nuestro navegador por defecto, la url sería '''file:///var/www/nombre_proyecto/carpeta_documentación/index.html''', aquí encontraremos la lista de todas las clases y sus funciones documentadas.

===Usando Terminal para ApiGen 4+===

Con NetBeans 8 o previo no se puede generar la documentación usando ApiGen 4+ ya que cambia la forma como se genera la documentación. Para generar la documentación hay que hacerlo como comando desde la línea de comando, de la siguiente manera:
<source lang="bash">
apigen generate --source [directorio a documentar] --destination [directorio de destino]
</source>

Simular "text-overflow:ellipsis"

2015-05-15T19:26:09Z

Alex: /* Como simular "text-overflow:ellipsis" */

== "text-overflow:ellipsis"en textos largos (multilinea) ==

Se explica la forma de simular "text-overflow:ellipsis"(puntos suspensivos), en textos largos de mas de una linea. <br>

Link Explicación: http://notasjs.blogspot.com/2013/05/simular-text-overflowellipsis-para.html?showComment=1431717145580#c3042567897354911128<br>
Link Código Funcionando: http://jsfiddle.net/xeneize100/cct4xy2L/3/

Simular "text-overflow:ellipsis"

2015-05-15T19:25:21Z

Alex: Created page with " == Como simular "text-overflow:ellipsis" == Se explica la forma de simular "text-overflow:ellipsis"(puntos suspensivos), en textos largos de mas de una linea. <br> Link Exp..."

== Como simular "text-overflow:ellipsis" ==

Se explica la forma de simular "text-overflow:ellipsis"(puntos suspensivos), en textos largos de mas de una linea. <br>

Link Explicación: http://notasjs.blogspot.com/2013/05/simular-text-overflowellipsis-para.html?showComment=1431717145580#c3042567897354911128<br>
Link Código Funcionando: http://jsfiddle.net/xeneize100/cct4xy2L/3/

Main Page

2015-05-15T19:16:37Z

Alex: /* PHP */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Web==

===Apache===
# [[Habilitar .htaccess]]
# [[Apache, restringir acceso]]
# [[Apache, .htacces]]

===Javascript===
# [[Javascript, Variables en URL como Anchors]]
# [[Crear librería de JavaScript]]
# [[Bloque try catch]]

===PHP===
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Subir archivo a servidor |Subir archivo(s) al servidor con PHP]]
# [[Ámbito de clases PHP |Ámbito de clases en PHP]]
# [[Simular "text-overflow:ellipsis" |Simular "text-overflow:ellipsis" ]]

===Compass y Sass===
# [[Compass y Sass, Instalación]]
# [[Compass y Sass, Configuración y uso]]
# [[Compilar archivos Sass al grabar en Netbeans]]

==Mediawiki==
# [[MediaWiki, elementos colapsables]]
# [[Manejar Permisos Wikimedia]]
# [[Extension Wiki SyntaxHighlight]]

==MySQL==
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Importar archivo.sql por Terminal]]
# [[Usuarios Mysql]]
# [[Errores MySql]]
# [[MySQL, iniciar, detener o reiniciar]]

==OS==

===*nix (Sistemas tipo Unix)===
# [[*nix, crear alias de comandos]]

===Linux===
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Búsquedas de archivos y texto]]
# [[Linux, Cambiar directorio home por defecto]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado (Ubuntu 14.04)]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Linux, Tips y Trucos]]
# [[Iniciar con Grub Ubuntu]]
# [[Instalar lftp]]
# [[Instalar Firewall Firestarter en Ubuntu 14.04]]
# [[Instalción y uso de ImageMagick]]

===Mac OS X===
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar mcrypt]]
# [[Instalción y uso de ImageMagick]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]
# [[Git, Rebase]]

==Trabajo IT==
===Metodologías===
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Como hacer un diagrama de flujo]]
# [[Métodos de programación]]
# [[Método Científico]]
# [[Multitasking versus Monotasking]]

===Estándares===
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Cómo documentar un Proyecto en PHP con NetBeans]]
# [[Cómo Generar Documentación en JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]

Bloque try catch

2015-04-10T11:33:21Z

Alex:

El bloque <b>Try - Catch</b> es una instrucción que permite controlar los errores que se producen durante la ejecución de un aplicación, dando la opción de que la ejecución del código continue, de así ser necesario.

Esta Instrucción consta de 2 partes principalmente:
<ol>
<li>'''El bloque Try: '''Es el bloque donde se inserta el código que se desea ejecutar normalmente.</li>
<li>'''El bloque Catch: '''En este bloque es donde se especifican las acciones a realizar en caso de que la ejecución del código en el bloque ''Try'' falle.</li>
</ol>

Se puede también agregar al try-catch el bloque '''Finally'''. Las instrucciones indicadas dentro de este bloque siempre se ejecutaran, independiente de si la ejecución del try fue exitosa o si se ejecutaron las instrucciones del catch. Un ejemplo de uso para el bloque finally es la liberación de recursos al finalizar la ejecución de una instrucción (Ya sea del try o catch).
<br />
=== Ejemplo en Javascript ===

En este ejemplo se ejecutaran las instrucciones especificadas en el bloque catch, ya que al llamar a la función en el try, se le esta entregando una variable que no ha sido definida.
<syntaxhighlight lang="javascript">

function funcion() {
var div = 3 / 2;
return div;
}

try
{
// En esta situación se pasara al bloque catch ya que la variable 'a' no esta definida.
funcion(a);
} catch (error) {
alert("Ocurrio un error: " + error);

}
</syntaxhighlight>
=== Ejemplo en PHP ===

<syntaxhighlight lang="php">

function inverse($x) {
if (!$x) {
throw new Exception('Division por cero.');
}
return 1 / $x;
}

try {
echo inverse(5) . "<br>";
} catch (Exception $e) {
echo 'Excepcion capturada: ', $e->getMessage(), "<br>";
} finally {
echo "Primer finally.<br>";
}
}</syntaxhighlight>

Apache, .htacces

2015-03-05T14:54:29Z

Alex: /* ¿Para que sirve? */

== ¿Qué es .htacces? ==
Un fichero .htaccess, también conocido como archivo de configuración distribuida, es un fichero especial, popularizado por el Servidor HTTP Apache que permite definir diferentes directivas de configuración para cada directorio sin necesidad de editar el archivo de configuración principal de Apache.

== ¿Para que sirve? ==
Con este archivo podremos configurar nuestro servidor web para:
* Hacerlo algo más seguro.
* Realizar redirecciones.
* Crear mensajes de error personalizados.
* Restringir el acceso a carpetas.
* Evitar el listado de directorios de nuestro servidor.
* Permitir el uso de nuestro dominio sin usar las famosas 'www'.
* Entre otras.

== Options -Multiviews ==
Las Options (Opciones de directiva) controla qué características del servidor están disponibles en un directorio en particular.
<br>
Por defecto todas las opciones vienen habilitadas, excepto para Multiviews
<br>
Al deshabilitar la opción Multiviews en el archivo .htaccess, hace que apague la negociación de contenido para buscar variantes dentro de los directorios.

== RewriteEngine On ==
El módulo '''mod_rewrite''' utiliza un motor de reescritura compuesta por reglas, basado en un analizador de expresiones regulares PCRE (compatibles con Perl), para reescribir las URL solicitada. De forma predeterminada, '''mod_rewrite''' asigna una dirección URL a una trayectoria del sistema de ficheros. Sin embargo, también se puede utilizar para redirigir un URL a otro URL.

== RewriteBase ==
Establece la base de la URL para reescrituras por directorio.

== RewriteRule ^admin.* - [L] ==
Significa que todo directorio que comience(^) con admin seguido de cualquier archivo o otro directorio, no se sobreescriba.
<br>
La [L] es una configuración especial del RewriteRule llamada bandera (flag).
<br>
A continuación se explicará un poco mas sobre las banderas [L] y [QSA].

=== [L] ===
La bandera [L] provoca en mod_rewrite que deje de procesar el conjunto de reglas siguientes.
<br>
En la mayoría de los contextos, esto significa que si la regla coincide, se procesara sin importar si existen más reglas. Esto corresponde con el last comando en Perl, o break comando en C.
<br>
Utilizar esta opción para indicar que la norma actual se debe aplicar de inmediato sin tener en cuenta otras normas.

=== [QSA] ===
Con la bandera [QSA], una solicitud de
'''/pages/123?one=two'''
se asignará a
'''/page.php?page=123&one=two'''
<br><br>
Sin la bandera [QSA], esa misma solicitud se asignará a '''/page.php?page=123'''
es decir, la cadena de consulta existente será descartado.

== Personalizar Errores ==
* ErrorDocument 400 /directorio/error/404.html
* ErrorDocument 401 /directorio/error/401.html
* ErrorDocument 403 /directorio/error/403.html
* ErrorDocument 404 /directorio/error/404.html

== Proteger carpetas ==
Este archivo .htaccess lo colocaremos en la carpeta que queremos proteger. Editemos el .htaccess con algo similar a :
<br><br>
AuthUserFile /ruta/absoluta/hacia/.htpasswd<br>
AuthName AquiPuedesPonerLoQueQuieras<br>
AuthType Basic<br>
<br>
require user test123

== El archivo .htpasswd ==
Este archivo contiene una lista de nombres de usuario y contraseñas, en formato usuario:contraseña y cada nombre-clave en una línea independiente, por ejemplo :
<br><br>
'''test123''':12JvVkeJRgm8A<br>
'''otrousuario:'''$1$UNHEaBiV$NzwYQ8NhjzIOUmFyfGyrO

Apache, .htacces

2015-03-05T14:54:02Z

Alex: /* Personalizar Errores */

== ¿Qué es .htacces? ==
Un fichero .htaccess, también conocido como archivo de configuración distribuida, es un fichero especial, popularizado por el Servidor HTTP Apache que permite definir diferentes directivas de configuración para cada directorio sin necesidad de editar el archivo de configuración principal de Apache.

== ¿Para que sirve? ==
Con este archivo podremos configurar nuestro servidor web para:
#Hacerlo algo más seguro.
#Realizar redirecciones.
#Crear mensajes de error personalizados.
#Restringir el acceso a carpetas.
#Evitar el listado de directorios de nuestro servidor.
#Permitir el uso de nuestro dominio sin usar las famosas 'www'.
#Entre otras.

== Options -Multiviews ==
Las Options (Opciones de directiva) controla qué características del servidor están disponibles en un directorio en particular.
<br>
Por defecto todas las opciones vienen habilitadas, excepto para Multiviews
<br>
Al deshabilitar la opción Multiviews en el archivo .htaccess, hace que apague la negociación de contenido para buscar variantes dentro de los directorios.

== RewriteEngine On ==
El módulo '''mod_rewrite''' utiliza un motor de reescritura compuesta por reglas, basado en un analizador de expresiones regulares PCRE (compatibles con Perl), para reescribir las URL solicitada. De forma predeterminada, '''mod_rewrite''' asigna una dirección URL a una trayectoria del sistema de ficheros. Sin embargo, también se puede utilizar para redirigir un URL a otro URL.

== RewriteBase ==
Establece la base de la URL para reescrituras por directorio.

== RewriteRule ^admin.* - [L] ==
Significa que todo directorio que comience(^) con admin seguido de cualquier archivo o otro directorio, no se sobreescriba.
<br>
La [L] es una configuración especial del RewriteRule llamada bandera (flag).
<br>
A continuación se explicará un poco mas sobre las banderas [L] y [QSA].

=== [L] ===
La bandera [L] provoca en mod_rewrite que deje de procesar el conjunto de reglas siguientes.
<br>
En la mayoría de los contextos, esto significa que si la regla coincide, se procesara sin importar si existen más reglas. Esto corresponde con el last comando en Perl, o break comando en C.
<br>
Utilizar esta opción para indicar que la norma actual se debe aplicar de inmediato sin tener en cuenta otras normas.

=== [QSA] ===
Con la bandera [QSA], una solicitud de
'''/pages/123?one=two'''
se asignará a
'''/page.php?page=123&one=two'''
<br><br>
Sin la bandera [QSA], esa misma solicitud se asignará a '''/page.php?page=123'''
es decir, la cadena de consulta existente será descartado.

== Personalizar Errores ==
* ErrorDocument 400 /directorio/error/404.html
* ErrorDocument 401 /directorio/error/401.html
* ErrorDocument 403 /directorio/error/403.html
* ErrorDocument 404 /directorio/error/404.html

== Proteger carpetas ==
Este archivo .htaccess lo colocaremos en la carpeta que queremos proteger. Editemos el .htaccess con algo similar a :
<br><br>
AuthUserFile /ruta/absoluta/hacia/.htpasswd<br>
AuthName AquiPuedesPonerLoQueQuieras<br>
AuthType Basic<br>
<br>
require user test123

== El archivo .htpasswd ==
Este archivo contiene una lista de nombres de usuario y contraseñas, en formato usuario:contraseña y cada nombre-clave en una línea independiente, por ejemplo :
<br><br>
'''test123''':12JvVkeJRgm8A<br>
'''otrousuario:'''$1$UNHEaBiV$NzwYQ8NhjzIOUmFyfGyrO

Apache, .htacces

2015-03-05T14:50:47Z

Alex: Created page with " == ¿Qué es .htacces? == Un fichero .htaccess, también conocido como archivo de configuración distribuida, es un fichero especial, popularizado por el Servidor HTTP Apache..."

== ¿Qué es .htacces? ==
Un fichero .htaccess, también conocido como archivo de configuración distribuida, es un fichero especial, popularizado por el Servidor HTTP Apache que permite definir diferentes directivas de configuración para cada directorio sin necesidad de editar el archivo de configuración principal de Apache.

== ¿Para que sirve? ==
Con este archivo podremos configurar nuestro servidor web para:
#Hacerlo algo más seguro.
#Realizar redirecciones.
#Crear mensajes de error personalizados.
#Restringir el acceso a carpetas.
#Evitar el listado de directorios de nuestro servidor.
#Permitir el uso de nuestro dominio sin usar las famosas 'www'.
#Entre otras.

== Options -Multiviews ==
Las Options (Opciones de directiva) controla qué características del servidor están disponibles en un directorio en particular.
<br>
Por defecto todas las opciones vienen habilitadas, excepto para Multiviews
<br>
Al deshabilitar la opción Multiviews en el archivo .htaccess, hace que apague la negociación de contenido para buscar variantes dentro de los directorios.

== RewriteEngine On ==
El módulo '''mod_rewrite''' utiliza un motor de reescritura compuesta por reglas, basado en un analizador de expresiones regulares PCRE (compatibles con Perl), para reescribir las URL solicitada. De forma predeterminada, '''mod_rewrite''' asigna una dirección URL a una trayectoria del sistema de ficheros. Sin embargo, también se puede utilizar para redirigir un URL a otro URL.

== RewriteBase ==
Establece la base de la URL para reescrituras por directorio.

== RewriteRule ^admin.* - [L] ==
Significa que todo directorio que comience(^) con admin seguido de cualquier archivo o otro directorio, no se sobreescriba.
<br>
La [L] es una configuración especial del RewriteRule llamada bandera (flag).
<br>
A continuación se explicará un poco mas sobre las banderas [L] y [QSA].

=== [L] ===
La bandera [L] provoca en mod_rewrite que deje de procesar el conjunto de reglas siguientes.
<br>
En la mayoría de los contextos, esto significa que si la regla coincide, se procesara sin importar si existen más reglas. Esto corresponde con el last comando en Perl, o break comando en C.
<br>
Utilizar esta opción para indicar que la norma actual se debe aplicar de inmediato sin tener en cuenta otras normas.

=== [QSA] ===
Con la bandera [QSA], una solicitud de
'''/pages/123?one=two'''
se asignará a
'''/page.php?page=123&one=two'''
<br><br>
Sin la bandera [QSA], esa misma solicitud se asignará a '''/page.php?page=123'''
es decir, la cadena de consulta existente será descartado.

== Personalizar Errores ==
##ErrorDocument 400 /directorio/error/404.html
##ErrorDocument 401 /directorio/error/401.html
##ErrorDocument 403 /directorio/error/403.html
##ErrorDocument 404 /directorio/error/404.html

== Proteger carpetas ==
Este archivo .htaccess lo colocaremos en la carpeta que queremos proteger. Editemos el .htaccess con algo similar a :
<br><br>
AuthUserFile /ruta/absoluta/hacia/.htpasswd<br>
AuthName AquiPuedesPonerLoQueQuieras<br>
AuthType Basic<br>
<br>
require user test123

== El archivo .htpasswd ==
Este archivo contiene una lista de nombres de usuario y contraseñas, en formato usuario:contraseña y cada nombre-clave en una línea independiente, por ejemplo :
<br><br>
'''test123''':12JvVkeJRgm8A<br>
'''otrousuario:'''$1$UNHEaBiV$NzwYQ8NhjzIOUmFyfGyrO

Main Page

2015-03-05T14:34:55Z

Alex: /* Apache */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Web==

===Apache===
# [[Habilitar .htaccess]]
# [[Apache, restringir acceso]]
# [[Apache, .htacces]]

===Javascript===
# [[Javascript, Variables en URL como Anchors]]
# [[Crear librería de JavaScript]]

===PHP===
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Subir archivo a servidor |Subir archivo(s) al servidor con PHP]]
# [[Ámbito de clases PHP |Ámbito de clases en PHP]]

===Compass y Sass===
# [[Compass y Sass, Instalación]]
# [[Compass y Sass, Configuración y uso]]
# [[Compilar archivos Sass al grabar en Netbeans]]

==Mediawiki==
# [[MediaWiki, elementos colapsables]]
# [[Manejar Permisos Wikimedia]]
# [[Extension Wiki SyntaxHighlight]]

==MySQL==
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Importar archivo.sql por Terminal]]
# [[Usuarios Mysql]]
# [[Errores MySql]]
# [[MySQL, iniciar, detener o reiniciar]]

==OS==

===*nix (Sistemas tipo Unix)===
# [[*nix, crear alias de comandos]]

===Linux===
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Búsquedas de archivos y texto]]
# [[Linux, Cambiar directorio home por defecto]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado (Ubuntu 14.04)]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Linux, Tips y Trucos]]
# [[Iniciar con Grub Ubuntu]]
# [[Instalar lftp]]
# [[Instalar Firewall Firestarter en Ubuntu 14.04]]
# [[Instalción y uso de ImageMagick]]

===Mac OS X===
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar mcrypt]]
# [[Instalción y uso de ImageMagick]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]
# [[Git, Rebase]]

==Trabajo IT==
===Metodologías===
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Como hacer un diagrama de flujo]]
# [[Métodos de programación]]
# [[Método Científico]]
# [[Multitasking versus Monotasking]]

===Estándares===
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Cómo documentar un Proyecto en PHP con NetBeans]]
# [[Cómo Generar Documentación en JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]

Ámbito de clases PHP

2014-12-05T19:41:50Z

Alex: /* Tipo Public */

== Tipo Public ==
Los miembros de clases declarados como public pueden ser accedidos desde cualquier lado.Si se declaran usando var, serán definidas como public.

== Tipo Private ==

Aquellos miembros definidos como private, únicamentede pueden ser accedidos desde la clase que los definió.

== Tipo Protected ==
Los miembros declarados como protected, sólo desde la misma clase, desde las clases que hereden de ella y desde las clases parent.

== Ejemplo ==
<syntaxhighlight lang="php">
<?php
/**
* Definición de MyClass
*/
class MyClass
{
public $public = 'Public';
protected $protected = 'Protected';
private $private = 'Private';

function printHello()
{
echo $this->public;
echo $this->protected;
echo $this->private;
}
}

$obj = new MyClass();
echo $obj->public; // Funciona bien
echo $obj->protected; // Error Fatal
echo $obj->private; // Error Fatal
$obj->printHello(); // Muestra Public, Protected y Private

/**
* Definición de MyClass2
*/
class MyClass2 extends MyClass
{
// Se puede redeclarar los métodos public y protected, pero no el private
protected $protected = 'Protected2';

function printHello()
{
echo $this->public;
echo $this->protected;
echo $this->private;
}
}

$obj2 = new MyClass2();
echo $obj2->public; // Funciona bien
echo $obj2->protected; // Error Fatal
echo $obj2->private; // Undefined
$obj2->printHello(); // Muestra Public, Protected2, Undefined

?>
</syntaxhighlight>

Ámbito de clases PHP

2014-12-05T19:41:34Z

Alex:

Ámbito de clases PHP

2014-12-05T19:39:24Z

Alex: Created page with "'''Tipo Public''' Los miembros de clases declarados como public pueden ser accedidos desde cualquier lado.Si se declaran usando var, serán definidas como public. '''Tipo Pri..."

'''Tipo Public'''
Los miembros de clases declarados como public pueden ser accedidos desde cualquier lado.Si se declaran usando var, serán definidas como public.

'''Tipo Private'''
Aquellos miembros definidos como private, únicamentede pueden ser accedidos desde la clase que los definió.

'''Tipo Protected'''
Los miembros declarados como protected, sólo desde la misma clase, desde las clases que hereden de ella y desde las clases parent.

'''Ejemplo'''
<syntaxhighlight lang="php">
<?php
/**
* Definición de MyClass
*/
class MyClass
{
public $public = 'Public';
protected $protected = 'Protected';
private $private = 'Private';

function printHello()
{
echo $this->public;
echo $this->protected;
echo $this->private;
}
}

$obj = new MyClass();
echo $obj->public; // Funciona bien
echo $obj->protected; // Error Fatal
echo $obj->private; // Error Fatal
$obj->printHello(); // Muestra Public, Protected y Private

/**
* Definición de MyClass2
*/
class MyClass2 extends MyClass
{
// Se puede redeclarar los métodos public y protected, pero no el private
protected $protected = 'Protected2';

function printHello()
{
echo $this->public;
echo $this->protected;
echo $this->private;
}
}

$obj2 = new MyClass2();
echo $obj2->public; // Funciona bien
echo $obj2->protected; // Error Fatal
echo $obj2->private; // Undefined
$obj2->printHello(); // Muestra Public, Protected2, Undefined

?>
</syntaxhighlight>

Main Page

2014-12-05T19:34:51Z

Alex: /* PHP */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Web==

===Apache===
# [[Habilitar .htaccess]]
# [[Apache, restringir acceso]]

===Javascript===
# [[Javascript, Variables en URL como Anchors]]
# [[Crear librería de JavaScript]]

===PHP===
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Subir archivo a servidor |Subir archivo(s) al servidor con PHP]]
# [[Ámbito de clases PHP |Ámbito de clases en PHP]]

===Compass y Sass===
# [[Compass y Sass, Instalación]]
# [[Compass y Sass, Configuración y uso]]
# [[Compilar archivos Sass al grabar en Netbeans]]

==Mediawiki==
# [[MediaWiki, elementos colapsables]]
# [[Manejar Permisos Wikimedia]]
# [[Extension Wiki SyntaxHighlight]]

==MySQL==
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Importar archivo.sql por Terminal]]
# [[Usuarios Mysql]]
# [[Errores MySql]]

==OS==

===*nix (Sistemas tipo Unix)===
# [[*nix, crear alias de comandos]]

===Linux===
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Búsquedas de archivos y texto]]
# [[Linux, Cambiar directorio home por defecto]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado (Ubuntu 14.04)]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Linux, Tips y Trucos]]
# [[Iniciar con Grub Ubuntu]]
# [[Instalar lftp]]
# [[Instalar Firewall Firestarter en Ubuntu 14.04]]
# [[Instalción y uso de ImageMagick]]

===Mac OS X===
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar mcrypt]]
# [[Instalción y uso de ImageMagick]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]
# [[Git, Rebase]]

==Trabajo IT==
===Metodologías===
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Como hacer un diagrama de flujo]]
# [[Métodos de programación]]
# [[Método Científico]]

===Estándares===
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Como documentar un Proyecto en PHP con NetBeans]]
# [[Cómo documentar JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]

Main Page

2014-12-05T19:34:11Z

Alex: /* PHP */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Web==

===Apache===
# [[Habilitar .htaccess]]
# [[Apache, restringir acceso]]

===Javascript===
# [[Javascript, Variables en URL como Anchors]]
# [[Crear librería de JavaScript]]

===PHP===
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Subir archivo a servidor |Subir archivo(s) al servidor con PHP]]
# [[Clases en PHP |Clases en PHP]]

===Compass y Sass===
# [[Compass y Sass, Instalación]]
# [[Compass y Sass, Configuración y uso]]
# [[Compilar archivos Sass al grabar en Netbeans]]

==Mediawiki==
# [[MediaWiki, elementos colapsables]]
# [[Manejar Permisos Wikimedia]]
# [[Extension Wiki SyntaxHighlight]]

==MySQL==
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Importar archivo.sql por Terminal]]
# [[Usuarios Mysql]]
# [[Errores MySql]]

==OS==

===*nix (Sistemas tipo Unix)===
# [[*nix, crear alias de comandos]]

===Linux===
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Búsquedas de archivos y texto]]
# [[Linux, Cambiar directorio home por defecto]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado (Ubuntu 14.04)]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Linux, Tips y Trucos]]
# [[Iniciar con Grub Ubuntu]]
# [[Instalar lftp]]
# [[Instalar Firewall Firestarter en Ubuntu 14.04]]
# [[Instalción y uso de ImageMagick]]

===Mac OS X===
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar mcrypt]]
# [[Instalción y uso de ImageMagick]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]
# [[Git, Rebase]]

==Trabajo IT==
===Metodologías===
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Como hacer un diagrama de flujo]]
# [[Métodos de programación]]
# [[Método Científico]]

===Estándares===
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Como documentar un Proyecto en PHP con NetBeans]]
# [[Cómo documentar JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]

Git, lo Básico

2014-11-11T15:57:09Z

Alex: /* Comandos de Ayuda */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

1. Agregar el archivo '''git-completion.bash''' al home.

'''Descargar:'''<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

2. Modificar el archivo '''.profile''' por terminal.
<syntaxhighlight lang="bash">
vim ~/.profile
</syntaxhighlight>

3. Persionamos la letra '''i''' y agregamos '''source ~/git-completion.bash''' al principio del archivo.
<syntaxhighlight lang="bash">
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxhighlight>

4. Por último presionamos la tecla '''esc''', a continuación ''':''' y '''wq''' para guardar el archivo.

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

== Instalar gitk ==

=== mac OS X 10.10 ===
<syntaxhighlight lang="bash">
sudo port install git k
</syntaxhighlight>

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Compass y Sass, Instalación

2014-11-06T20:35:18Z

Alex: /* OS X */

Instalar mcrypt

2014-10-29T21:02:24Z

Alex: /* Instalar mcrypt por MacPorts */

<span style="font-weight: bold; color: red;">Nota</span>: Se puede instalar usando ''macports''.

Este tutorial esta pensado para instalar ''mcrypt'' en OS X.
== Instalar Xcode ==

Ir a [[Instalar Xcode]]

=== Configurar Xcode ===

# Abrir la Aplicación de Xcode.
# Ir a preferencias.
# En al pestaña '''Downloads''' instalar '''command line tools'''.

== Requisitos para instalar mcryprt Manualmente ==

# Descargar libmcrypt: http://sourceforge.net/projects/mcrypt/files/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.gz/download
# Descargar php.
## Para ver que version se encuentra instalada.
<syntaxhighlight lang='bash' line start='1'>
php -v
</syntaxhighlight>

== Crear carpetas para las descargas ==

Crear e ingresar a carpeta mcrypt.
<syntaxhighlight lang="bash" line start="1">
cd ~ ; mkdir mcrypt ; cd mcrypt
</syntaxhighlight>
Descomprimir php y libmcrypt.
<syntaxhighlight lang="bash" line start="2">
tar -zxvf archivo.tar.gz
</syntaxhighlight>

== Configurar libmcrypt ==

Ingresar a libmcrypt.
<syntaxhighlight lang="bash" line start="1">
cd libmcrypt-2.5.8
</syntaxhighlight>
configurar libmcrypt.
<syntaxhighlight lang="bash" line start="2">
./configure
make
sudo make install
</syntaxhighlight>

== Instalar Autoconf ==

Autoconf por defecto no viene instalado.
<syntaxhighlight lang="bash" line start="1">
cd ~/mcrypt
curl -O http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
tar xvfz autoconf-latest.tar.gz
cd autoconf-2.69/
./configure
make
sudo make install
</syntaxhighlight>

== Compilar mcrypt php Extension ==

<syntaxhighlight lang="bash" line start="1">
cd ../php-5.3.13/ext/mcrypt/
/usr/bin/phpize
</syntaxhighlight>

'''Resultado correcto:'''<br>
Configuring for: <br>
PHP Api Version: 20090626 <br>
Zend Module Api No: 20090626 <br>
Zend Extension Api No: 220090626 <br>
configure.in:3: warning: prefer named diversions <br>
configure.in:3: warning: prefer named diversions <br>

<syntaxhighlight lang="bash" line start="3">
./configure
make
sudo make install
</syntaxhighlight>

'''Resultado correcto:'''<br>
Installing shared extensions: /usr/lib/php/extensions/no-debug-non-zts-20090626/

== Instalar mcrypt por MacPorts ==

# Descargar MacPorts para la version de Mac OS X que se tenga instalada, desde el siguiente link: https://www.macports.org/install.php
# Reiniciar el Terminal.
# Copiar el nombre del paquete del mcrypt de la version de php que se necesite, desde el siguiente link: https://www.macports.org/ports.php
# Desde el terminal, instalar mcrypt con el siguiente comando:
<syntaxhighlight lang="bash">
sudo port install nombre-de-mcrypt-php
</syntaxhighlight>

== Habilitar mcrypt.so en php Extension ==

<syntaxhighlight lang="bash" line start="1">
sudo cp /etc/php.ini.default /etc/php.ini
sudo chmod u+w /etc/php.ini
sudo nano /etc/php.ini
</syntaxhighlight>
Agregar la siguiente línea al final del archivo
<syntaxhighlight lang="bash" line start="4">
extension=mcrypt.so
</syntaxhighlight>

== Reiniciar Apache ==

<syntaxhighlight lang="bash" line start="1">
sudo apachectl restart
</syntaxhighlight>

== Referencia ==

# http://coolestguidesontheplanet.com/how-to-install-mcrypt-for-php-on-mac-osx-lion-10-7-development-server/

Instalar mcrypt

2014-10-29T21:01:12Z

Alex: /* Instalar mcrypt por MacPorts */

<span style="font-weight: bold; color: red;">Nota</span>: Se puede instalar usando ''macports''.

Este tutorial esta pensado para instalar ''mcrypt'' en OS X.
== Instalar Xcode ==

Ir a [[Instalar Xcode]]

=== Configurar Xcode ===

# Abrir la Aplicación de Xcode.
# Ir a preferencias.
# En al pestaña '''Downloads''' instalar '''command line tools'''.

== Requisitos para instalar mcryprt Manualmente ==

# Descargar libmcrypt: http://sourceforge.net/projects/mcrypt/files/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.gz/download
# Descargar php.
## Para ver que version se encuentra instalada.
<syntaxhighlight lang='bash' line start='1'>
php -v
</syntaxhighlight>

== Crear carpetas para las descargas ==

Crear e ingresar a carpeta mcrypt.
<syntaxhighlight lang="bash" line start="1">
cd ~ ; mkdir mcrypt ; cd mcrypt
</syntaxhighlight>
Descomprimir php y libmcrypt.
<syntaxhighlight lang="bash" line start="2">
tar -zxvf archivo.tar.gz
</syntaxhighlight>

== Configurar libmcrypt ==

Ingresar a libmcrypt.
<syntaxhighlight lang="bash" line start="1">
cd libmcrypt-2.5.8
</syntaxhighlight>
configurar libmcrypt.
<syntaxhighlight lang="bash" line start="2">
./configure
make
sudo make install
</syntaxhighlight>

== Instalar Autoconf ==

Autoconf por defecto no viene instalado.
<syntaxhighlight lang="bash" line start="1">
cd ~/mcrypt
curl -O http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
tar xvfz autoconf-latest.tar.gz
cd autoconf-2.69/
./configure
make
sudo make install
</syntaxhighlight>

== Compilar mcrypt php Extension ==

<syntaxhighlight lang="bash" line start="1">
cd ../php-5.3.13/ext/mcrypt/
/usr/bin/phpize
</syntaxhighlight>

'''Resultado correcto:'''<br>
Configuring for: <br>
PHP Api Version: 20090626 <br>
Zend Module Api No: 20090626 <br>
Zend Extension Api No: 220090626 <br>
configure.in:3: warning: prefer named diversions <br>
configure.in:3: warning: prefer named diversions <br>

<syntaxhighlight lang="bash" line start="3">
./configure
make
sudo make install
</syntaxhighlight>

'''Resultado correcto:'''<br>
Installing shared extensions: /usr/lib/php/extensions/no-debug-non-zts-20090626/

== Instalar mcrypt por MacPorts ==

# Descargar MacPorts para la version de Mac OS X que se tenga instalada, desde el siguiente link: https://www.macports.org/install.php
# Reiniciar el Terminal.
# Copiar el nombre del paquete del mcrypt de la version de php que se necesite, desde el siguiente link: https://www.macports.org/ports.php
# Desde el terminal, instalar mcrypt con el siguiente comando:
<syntaxlight lang='bash'>
sudo port install nombre-de-mcrypt-php
</syntaxlight>

== Habilitar mcrypt.so en php Extension ==

<syntaxhighlight lang="bash" line start="1">
sudo cp /etc/php.ini.default /etc/php.ini
sudo chmod u+w /etc/php.ini
sudo nano /etc/php.ini
</syntaxhighlight>
Agregar la siguiente línea al final del archivo
<syntaxhighlight lang="bash" line start="4">
extension=mcrypt.so
</syntaxhighlight>

== Reiniciar Apache ==

<syntaxhighlight lang="bash" line start="1">
sudo apachectl restart
</syntaxhighlight>

== Referencia ==

# http://coolestguidesontheplanet.com/how-to-install-mcrypt-for-php-on-mac-osx-lion-10-7-development-server/

Instalar mcrypt

2014-10-29T20:55:41Z

Alex: /* Compilar mcrypt php Extension */

<span style="font-weight: bold; color: red;">Nota</span>: Se puede instalar usando ''macports''.

Este tutorial esta pensado para instalar ''mcrypt'' en OS X.
== Instalar Xcode ==

Ir a [[Instalar Xcode]]

=== Configurar Xcode ===

# Abrir la Aplicación de Xcode.
# Ir a preferencias.
# En al pestaña '''Downloads''' instalar '''command line tools'''.

== Requisitos para instalar mcryprt Manualmente ==

# Descargar libmcrypt: http://sourceforge.net/projects/mcrypt/files/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.gz/download
# Descargar php.
## Para ver que version se encuentra instalada.
<syntaxhighlight lang='bash' line start='1'>
php -v
</syntaxhighlight>

== Crear carpetas para las descargas ==

Crear e ingresar a carpeta mcrypt.
<syntaxhighlight lang="bash" line start="1">
cd ~ ; mkdir mcrypt ; cd mcrypt
</syntaxhighlight>
Descomprimir php y libmcrypt.
<syntaxhighlight lang="bash" line start="2">
tar -zxvf archivo.tar.gz
</syntaxhighlight>

== Configurar libmcrypt ==

Ingresar a libmcrypt.
<syntaxhighlight lang="bash" line start="1">
cd libmcrypt-2.5.8
</syntaxhighlight>
configurar libmcrypt.
<syntaxhighlight lang="bash" line start="2">
./configure
make
sudo make install
</syntaxhighlight>

== Instalar Autoconf ==

Autoconf por defecto no viene instalado.
<syntaxhighlight lang="bash" line start="1">
cd ~/mcrypt
curl -O http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
tar xvfz autoconf-latest.tar.gz
cd autoconf-2.69/
./configure
make
sudo make install
</syntaxhighlight>

== Compilar mcrypt php Extension ==

<syntaxhighlight lang="bash" line start="1">
cd ../php-5.3.13/ext/mcrypt/
/usr/bin/phpize
</syntaxhighlight>

'''Resultado correcto:'''<br>
Configuring for: <br>
PHP Api Version: 20090626 <br>
Zend Module Api No: 20090626 <br>
Zend Extension Api No: 220090626 <br>
configure.in:3: warning: prefer named diversions <br>
configure.in:3: warning: prefer named diversions <br>

<syntaxhighlight lang="bash" line start="3">
./configure
make
sudo make install
</syntaxhighlight>

'''Resultado correcto:'''<br>
Installing shared extensions: /usr/lib/php/extensions/no-debug-non-zts-20090626/

== Instalar mcrypt por MacPorts ==

== Habilitar mcrypt.so en php Extension ==

<syntaxhighlight lang="bash" line start="1">
sudo cp /etc/php.ini.default /etc/php.ini
sudo chmod u+w /etc/php.ini
sudo nano /etc/php.ini
</syntaxhighlight>
Agregar la siguiente línea al final del archivo
<syntaxhighlight lang="bash" line start="4">
extension=mcrypt.so
</syntaxhighlight>

== Reiniciar Apache ==

<syntaxhighlight lang="bash" line start="1">
sudo apachectl restart
</syntaxhighlight>

== Referencia ==

# http://coolestguidesontheplanet.com/how-to-install-mcrypt-for-php-on-mac-osx-lion-10-7-development-server/

Instalar mcrypt

2014-10-29T20:54:54Z

Alex: /* Requisitos para instalar mcryprt */

<span style="font-weight: bold; color: red;">Nota</span>: Se puede instalar usando ''macports''.

Este tutorial esta pensado para instalar ''mcrypt'' en OS X.
== Instalar Xcode ==

Ir a [[Instalar Xcode]]

=== Configurar Xcode ===

# Abrir la Aplicación de Xcode.
# Ir a preferencias.
# En al pestaña '''Downloads''' instalar '''command line tools'''.

== Requisitos para instalar mcryprt Manualmente ==

# Descargar libmcrypt: http://sourceforge.net/projects/mcrypt/files/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.gz/download
# Descargar php.
## Para ver que version se encuentra instalada.
<syntaxhighlight lang='bash' line start='1'>
php -v
</syntaxhighlight>

== Crear carpetas para las descargas ==

Crear e ingresar a carpeta mcrypt.
<syntaxhighlight lang="bash" line start="1">
cd ~ ; mkdir mcrypt ; cd mcrypt
</syntaxhighlight>
Descomprimir php y libmcrypt.
<syntaxhighlight lang="bash" line start="2">
tar -zxvf archivo.tar.gz
</syntaxhighlight>

== Configurar libmcrypt ==

Ingresar a libmcrypt.
<syntaxhighlight lang="bash" line start="1">
cd libmcrypt-2.5.8
</syntaxhighlight>
configurar libmcrypt.
<syntaxhighlight lang="bash" line start="2">
./configure
make
sudo make install
</syntaxhighlight>

== Instalar Autoconf ==

Autoconf por defecto no viene instalado.
<syntaxhighlight lang="bash" line start="1">
cd ~/mcrypt
curl -O http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
tar xvfz autoconf-latest.tar.gz
cd autoconf-2.69/
./configure
make
sudo make install
</syntaxhighlight>

== Compilar mcrypt php Extension ==

<syntaxhighlight lang="bash" line start="1">
cd ../php-5.3.13/ext/mcrypt/
/usr/bin/phpize
</syntaxhighlight>

'''Resultado correcto:'''<br>
Configuring for: <br>
PHP Api Version: 20090626 <br>
Zend Module Api No: 20090626 <br>
Zend Extension Api No: 220090626 <br>
configure.in:3: warning: prefer named diversions <br>
configure.in:3: warning: prefer named diversions <br>

<syntaxhighlight lang="bash" line start="3">
./configure
make
sudo make install
</syntaxhighlight>

'''Resultado correcto:'''<br>
Installing shared extensions: /usr/lib/php/extensions/no-debug-non-zts-20090626/

== Habilitar mcrypt.so en php Extension ==

<syntaxhighlight lang="bash" line start="1">
sudo cp /etc/php.ini.default /etc/php.ini
sudo chmod u+w /etc/php.ini
sudo nano /etc/php.ini
</syntaxhighlight>
Agregar la siguiente línea al final del archivo
<syntaxhighlight lang="bash" line start="4">
extension=mcrypt.so
</syntaxhighlight>

== Reiniciar Apache ==

<syntaxhighlight lang="bash" line start="1">
sudo apachectl restart
</syntaxhighlight>

== Referencia ==

# http://coolestguidesontheplanet.com/how-to-install-mcrypt-for-php-on-mac-osx-lion-10-7-development-server/

Importar archivo.sql por Terminal

2014-06-05T14:34:36Z

Alex:

Para importar un archivo.sql por terminal existen 2 formas, una es ingresando a mysql (es recomendable, ya que, muestra log del script.sql importado) y sin ingresar a mysql.

== Ingresando a mysql ==
1. Ingresar al directorio donde se encuentra el script.sql que se desea importar. <br>
2. Una vez estando en el directorio, ingresar a mysql:
<syntaxhighlight lang="bash">
mysql -u root -p
</syntaxhighlight>
3. Mencionar la base de datos a utilizar.
<syntaxhighlight lang="mysql">
use nameDatabase;
</syntaxhighlight>
4. Agregar el siguiente comando para importar el script.sql
<syntaxhighlight lang="mysql">
source script.sql
</syntaxhighlight>

== Sin ingresar a mysql ==
1. Ingresar al directorio donde se encuentra el script.sql que se desea importar. <br>
2. Ingresar el siguiente comando.
<syntaxhighlight lang="bash">
mysql -u root -p < script.sql
</syntaxhighlight>

Importar archivo.sql por Terminal

2014-06-05T14:33:03Z

Alex: /* Ingresando a mysql */

Para importar un archivo.sql por terminal existen 2 formas de hacerlo:

== Ingresando a mysql ==
1. Ingresar al directorio donde se encuentra el script.sql que se desea importar. <br>
2. Una vez estando en el directorio, ingresar a mysql:
<syntaxhighlight lang="bash">
mysql -u root -p
</syntaxhighlight>
3. Mencionar la base de datos a utilizar.
<syntaxhighlight lang="mysql">
use nameDatabase;
</syntaxhighlight>
4. Agregar el siguiente comando para importar el script.sql
<syntaxhighlight lang="mysql">
source script.sql
</syntaxhighlight>

== Sin ingresar a mysql ==
1. Ingresar al directorio donde se encuentra el script.sql que se desea importar. <br>
2. Ingresar el siguiente comando.
<syntaxhighlight lang="bash">
mysql -u root -p < script.sql
</syntaxhighlight>

Importar archivo.sql por Terminal

2014-06-05T14:30:55Z

Alex:

Para importar un archivo.sql por terminal existen 2 formas de hacerlo:

== Ingresando a mysql ==
1. Ingresar al directorio donde se encuentra el archivo.sql que se desea importar. <br>
2. Una vez estando en el directorio, ingresar a mysql:
<syntaxhighlight lang="bash">
mysql -u root -p
</syntaxhighlight>
3. Mencionar la base de datos a utilizar.
<syntaxhighlight lang="mysql">
use nameDatabase;
</syntaxhighlight>
4. Agregar el siguiente comando para importar el archivo.sql
<syntaxhighlight lang="mysql">
source archivo.sql
</syntaxhighlight>

Main Page

2014-06-05T14:25:02Z

Alex: /* Tutoriales */

<div style="font-size: 15px; color: gray;">Este es el wiki de [http://www.flat.cl/ Flat Estrategia Digital (Flat)]</div>

==Tutoriales==
# [[Enviar mail con archivos adjuntos PHP |Enviar mail con archivos adjuntos PHP]]
# [[Habilitar .htaccess]]
# [[Metodologías para encontrar errores]]
# [[Metodologías para encontrar soluciones]]
# [[Metodología de trabajo por encargo]]
# [[Iniciar con Grub Ubuntu]]
# [[Como hacer un diagrama de flujo]]
# [[Extension Wiki SyntaxHighlight]]
# [[Usuarios Mysql]]
# [[Variables en URL como Anchors]]
# [[Mac OS X, Como incluir directorios en PATH]]
# [[Instalar lftp]]
# [[Linux, Borrar o renombrar archivos con caracteres "raros" en su nombre]]
# [[Crear claves publicas y privadas para conectarse por SSH al servidor]]
# [[Linux, Tips y Trucos]]
# [[Errores MySql]]
# [[Linux, hacer que el botón de power (on/off) apague el computador solo si no hay nadie loggeado]]
# [[Instalar mcrypt]]
# [[Generar diccionario de datos con MySQL Workbench]]
# [[Crear librería de JavaScript]]
# [[Crear enlace ODBC para conectar Excel con MySQL]]
# [[Manejar Permisos Wikimedia]]
# [[Importar archivo.sql por Terminal]]

==Estándares==
# [[Estándares de Desarrollo]]
# [[Ejemplo de HTML5 válido]]
# [[Como documentar un Proyecto en PHP con NetBeans]]
# [[Cómo documentar JavaScript]]
# [[Code Design Patterns (Patrones de Diseño de Código)]]

==Git==
# [[Git, lo Básico]]
# [[Git, Tagging]]
# [[Git, Branching]]
# [[Git, Stashing]]

Importar archivo.sql por Terminal

2014-06-05T14:24:27Z

Alex: Created page with "Para importar un archivo.sql por terminal existen 2 formas de hacerlo: == Ingresando a mysql == 1. Se debe ingresar a mysql: <syntaxhighlight"

Para importar un archivo.sql por terminal existen 2 formas de hacerlo:

== Ingresando a mysql ==

1. Se debe ingresar a mysql:

<syntaxhighlight

Git, lo Básico

2014-04-25T18:51:32Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

1. Agregar el archivo '''git-completion.bash''' al home.

'''Descargar:'''<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

2. Modificar el archivo '''.profile''' por terminal.
<syntaxhighlight lang="bash">
vim ~/.profile
</syntaxhighlight>

3. Persionamos la letra '''i''' y agregamos '''source ~/git-completion.bash''' al principio del archivo.
<syntaxhighlight lang="bash">
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxhighlight>

4. Por último presionamos la tecla '''esc''', a continuación ''':''' y '''wq''' para guardar el archivo.

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:50:38Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

1. Agregar el archivo '''git-completion.bash''' al home.

'''Descargar:'''<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

2. Modificar el archivo '''.profile''' por terminal.
<syntaxhighlight lang="bash">
vim ~/.profile
</syntaxhighlight>

3. Persionamos la letra '''i''' y agregamos '''source ~/git-completion.bash''' al principio del archivo.
<syntaxhighlight lang="bash">
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxhighlight>

4. Para guardar presionamos la tecla '''esc''', a continuación ''':''' y '''w+q''' para guardar el archivo.

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:49:42Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

#Agregar el archivo '''git-completion.bash''' al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

1. Modificar el archivo '''.profile''' por terminal.
<syntaxhighlight lang="bash">
vim ~/.profile
</syntaxhighlight>

2. Persionamos la letra '''i''' y agregamos '''source ~/git-completion.bash''' al principio del archivo.
<syntaxhighlight lang="bash">
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxhighlight>

3. Para guardar presionamos la tecla '''esc''', a continuación ''':''' y '''w+q''' para guardar el archivo.

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:47:29Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

#Agregar el archivo '''git-completion.bash''' al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

#Modificar el archivo '''.profile''' por terminal.
<syntaxhighlight lang="bash">
vim ~/.profile
</syntaxhighlight>

#Agregar '''source ~/git-completion.bash''' al principio del archivo.
<syntaxhighlight lang="bash">
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxhighlight>

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:46:15Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

#Agregar el archivo '''git-completion.bash''' al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

#Modificar el archivo '''.profile''' por terminal.
<syntaxheightlight lang='bash'>
vim ~/.profile
</syntaxleheighlight>

#Agregar '''source ~/git-completion.bash''' al principio del archivo.
<syntaxleheightlight lang='bash'>
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</syntaxheighlight>

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:43:56Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

Necesario para SO Macintosh (Ubuntu viene por defecto).

#Agregar el archivo '''git-completion.bash''' al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

#Modificar el archivo '''.profile''' por terminal.
<styleheightlight lang='bash'>
vim ~/.profile
</styleheighlight>

#Agregar '''source ~/git-completion.bash''' al principio del archivo.
<styleheightlight lang='bash'>
source ~/git-completion.bash

# MacPorts Installer addition on 2014-03-26_at_11:37:57: adding an appropriate PATH variable for use with MacPorts.
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
# Finished adapting your PATH environment variable for use with MacPorts.
</styleheighlight>

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:38:59Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

'''Necesario para SO Macintosh.'''

Agregar el siguiente archivo al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [[Media:Git-completion.bash.zip | Git-completion.bash version 2.0 ]]

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Git, lo Básico

2014-04-25T18:37:04Z

Alex: /* Configurar autocompletación en Terminal */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

'''Necesario para SO Macintosh.'''

Agregar el siguiente archivo al home.

Descargar:<br>
Opción 1 (github.com): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash <br>
Opción 2 (Wiki): [Media:Git-completion.bash.zip]

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

File:Git-completion.bash.zip

2014-04-25T18:36:13Z

Alex:

Git, lo Básico

2014-04-25T18:34:18Z

Alex: /* Configuración */

==Contexto==

===Los Estados de los archivos===
Los archivos adentro de una carpeta que usa Git pueden estar ''tracked'' o no, esto significa que están asociados al control de versión o no. Los archivos ''tracked'' pueden estar en uno de tres estados:

;''Commited'' ("Comprometido")
:El archivos ya quedó guardado en la base de datos local.
;Modified (Modificado)
:El archivo se ha modificado pero no se ha ''commited'' (''comprometido'') aún.
;''Staged'' ("En Escenario")
:Se ha marcado el archivo para agregarlo al próximo commit.

===Un flujo común de Git===
# Se obtiene el proyecto desde un directorio de git
# Se modifican archivos
# Se preparan para el ''commit'', se hacen ''staged''
# Se hace el ''commit''

[[File:18333fig0106-tn.png|300px|thumb|none|Flujo común de Git]]

==Instalar Git==
===Obtener Git===
Git se puede instalar desde diferentes fuentes, [http://git-scm.com/downloads esta] es la oficial. Desde ahí se pueden descargar los comandos y clientes gráficos.

Además hay más programas en Internet que se pueden usar para trabajar con Git. Por ejemplo NetBeans lo soporta.

'''Nota''': Es posible que Git ya esté instalado en el sistema. Si se reinstala podría causar algún conflicto. Revisar si está instalado, si la función instalada es suficiente no hacer nada, sino buscar la forma de instalar la versión deseada.

===Configuración===
Antes de empezar a usar Git se configuran algunas variables para el uso de un usuario. Estas variables se usan para guardar en los repositorios información de quien hace el ''commit'' y configurar cosas como el editor a usar. Quedan almacenadas en uno de tres directorios, ordenados por relevancia siendo más relevante el último:

* <code>/etc/gitconfig</code> contiene configuración para todos los usuarios del sistema en todos los repositorios
* <code>~/.gitconfig</code> contiene configuración para el usuario actual
* <code>.git/config</code> contiene configuración para el repositorio en el que se está trabajando actualmente

A continuación algunas configuraciones básicas pero existen más configuraciones no documentadas aquí:

====Configuración Personal====
Esta información se usa a la hora de hacer ''commits''.
<syntaxhighlight lang="bash">
git config --global user.name "John Flat" # Setea el nombre del usuario
git config --global user.email john.flat@empresa.com # Setea el mail del usuario
</syntaxhighlight>

====Configuración Ambiente de Trabajo====
<syntaxhighlight lang="bash">
git config --global core.editor emacs # Setea el editor por defecto
git config --global merge.tool vimdiff # Setea el visualizador de diferencias
</syntaxhighlight>

====Revisar configuraciones====
<syntaxhighlight lang="bash">
git config --list # Lista todas las configuraciones, pueden repetirse si se repiten en varios archivos de configuración
git config {key} # Muestra el valor de una variable en específico
git config user.name # Muestra el valor del nombre de usuario guardado en la configuración
</syntaxhighlight>

====Configurar autocompletación en Terminal====

'''Necesario para SO Macintosh.'''

Agregar el siguiente archivo al home.

Descargar:<br>
Opción 1 (Git): https://github.com/git/git/blob/master/contrib/completion/git-completion.bash
Versión 2.0:

===Instalar en un servidor===
Instalar en un servidor es sencillo conceptualmente. Hay que permitir acceso a un directorio con un proyecto Git. El directorio es igual al que hay en un proyecto localmente. También hay que definir para cada usuario si puede hacer ''pull'' y ''push''. Para esto, una forma sencilla de hacerlo es usando acceso SSH (aunque existen otra formas, ver ''[http://gitolite.com/3-server-usage/git-server.html setting up your own git server]''), de esta forma también se le puede dar permiso al usuario de lectura y escritura.

Para crear el repositorio hay que ingresar al servidor remoto y ejecutar algunos comandos. Lo siguiente es un ejemplo, la ubicación y el nombre del proyecto pueden cambiar. Por convención se usa el nombre de la carpeta del proyecto con ''.git''. El comando <code>--bare</code>, al inicializar el proyecto, indica que se crea sin la estructura de directorio de trabajo, este directorio queda con archivos como los que quedan adentro de la carpeta .git de un repositorio de trabajo local.
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
mkdir project.git # Se crea una carpeta donde va a quedar el repositorio
cd project.git # Se ingresa a la carpeta del proyecto
git --bare init # Se inicializa el proyecto
</syntaxhighlight>
Lo mismo del código anterior se puede lograr así:
<syntaxhighlight lang="bash">
cd /opt/git # Se navega a la ubicación donde se quiere dejar el repositorio
git --bare init project.git # Se crea el directorio del proyecto y se inicializa
</syntaxhighlight>

Para obtener el repositorio el usuario puede hacer:
<syntaxhighlight lang="bash">
git clone usuario@servidor.com:/directorio/donde/esta/el/proyecto
</syntaxhighlight>

Si se desea hacer usuarios que solo puedan interactuar con Git en este servidor, es buena idea dejar que solo usen un ''shell'' desarrollado para este propósito. Esto significa que no pueden moverse a través de los directorios, crear archivos, ver archivos y más. Para esto, hay que editar el archivo <code>/etc/passwd</code> (en Ubuntu por ejemplo), en el usuario que solo va a usar Git, pasar de esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/bin/sh
</syntaxhighlight>
a esto:
<syntaxhighlight lang="bash">
nombreUsuario:x:1000:1000::/home/nombreUsuario:/usr/bin/git-shell
</syntaxhighlight>

Para más información de cómo interactuar con el servidor remoto, ver [[Git, Branching]], la sección de ''remotes''.

==Comandos de Ayuda==
Tres formas de obtener ayuda sobre un <verb> (verbo), es decir una acción de Git:
<syntaxhighlight lang="bash">
git help <verb>
git <verb> --help
man git-<verb>
</syntaxhighlight>

Ejemplo de ayuda
<syntaxhighlight lang="bash">
git help config
git config --help
man git-config
</syntaxhighlight>

==Crear Repositorios==
Formas de hacer que un proyecto tenga manejo de versiones usando Git. Todas las formas incluyen un directorio .git que guarda la información de versiones.

===Empezar un proyecto con Git===
Se crea un directorio nuevo, se navega hacia él y se inicializa Git.
<syntaxhighlight lang="bash">
mkdir nuevoProyecto # Crear nuevo directorio
cd nuevoProyecto # Navegar a directorio
git init # Inicializar Git
touch x # Crea un archivo "x" vacío
git add x # Se pasa "x" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, solo un archivo en blanco' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Agregar Git a un proyecto existente===
Se navega al directorio donde está el proyecto exitente y se inicializa Git.
<syntaxhighlight lang="bash">
cd proyectoExistente # Se navega al proyecto existente
git init # Inicializar Git
git add archivoExistente # Se pasa "archivoExistente" al staging area, es decir, se prepara para el commit
git commit -m 'Commit inicial, se agrega archivo existente' # Se hace el commit y queda guardado localmente
</syntaxhighlight>

===Obtener un proyecto desde una fuente existente===
Se obtiene una copia del repositorio y se guarda en una carpeta con el nombre del repositorio.
<syntaxhighlight lang="bash">
git clone [url] # Forma genérica
git clone /path/to/repository # Obtener copia localmente
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

==Ignorar archivos==

===.gitignore===
Git puede ignorar algunos archivos, esto se hace manualmente editando (creando) el archivo ''.gitignore''. A continuación un ejemplo de este archivo:
<syntaxhighlight lang="bash">
# Esto es un comentario que empieza con '#'
# Omitir todos los archivos que terminan con .log
*.log
# Pero track super.log usando la negación
!super.log
# Ignorar la carpeta LOG, si existe una carpeta LOG adentro de otra carpeta no se va a ignorar
/LOG
# Ignorar todos los archivos en la carpeta error
error/
# Ignorar los archivos .txt adentro de la carpeta media
media/*.txt
</syntaxhighlight>

===Asumir que algún archivo no ha cambiado===
El siguiente comando hace que Git no tome en cuenta los cambios del archivo en cuestión.
<syntaxhighlight lang="bash">
git update-index --assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

Para deshacer esto:
<syntaxhighlight lang="bash">
git update-index --no-assume-unchanged archivoParaNoTomarEnCuenta
</syntaxhighlight>

==Git Local==

===Proceso de guardado de archivos (commit)===
Para hacer un ''commit'' hay que hacer los siguientes pasos:
# Agregar (o modificar) archivos (por ejemplo usando un editor de texto)
# Avisarle a git que tiene que llevar a cabo los cambios, por ejemplo agregando un archivo (<code>git add archivoNuevo</code>)
# Hacer el ''commit'', git commit -m <nowiki>'texto del commit'</nowiki>

Se puede hacer el commit así:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit # Se realiza el commit
# No se le entrega mensaje, con lo que se abre el editor de texto configurado
</syntaxhighlight>
O
<syntaxhighlight lang="bash">
touch archivoNuevo # Se agrega un nuevo archivo al directorio de trabajo
git add archivoNuevo # Se agrega el archivo a Git
git commit -m 'texto del commit' # Se realiza el commit
# Se escribe el mensaje directamente y no se abre un editor de texto
</syntaxhighlight>

Siempre es necesario incluir un mensaje en el ''commit'' ya que esto permite revisar el historial de lo que se haya hecho antes. De esta forma se puede tener una imagen bastante clara de la evolución del proyecto.

===Hacer un ''commit'' viendo las diferencias en los archivos===
Lo siguiente muestra el editor de texto para agregar un mensaje, en los comentarios muestra los archivos modificados (comportamiento por defecto) y adicionalmente muestra las diferencias en los archivos (<code>-v</code>).
<syntaxhighlight lang="bash">
git commit -v
</syntaxhighlight>

===Track nuevos archivos===
Se dice que un archivo está siendo ''tracked'' cuando Git lo toma en cuenta. Para esto se ejecuta lo siguiente:
<syntaxhighlight lang="bash">
touch archivoNuevo # Se crea nuevo archivo vacío
git add archivoNuevo # Se hace que Git lo agregue
</syntaxhighlight>

===Agregar archivos al staging area===
Los archivos modificados no pasan directamente al siguiente ''commit'', hay que pasarlos al ''staging area'' antes. El comando es el mismo que para agregar archivos nuevos.
<syntaxhighlight lang="bash">
echo nuevaLinea >> archivoYaEnGit # Se le agrega la línea nuevaLinea a un archivo que ya estaba en Git
git add archivoYaEnGit # Se pasa archivo al staging area
</syntaxhighlight>

===Mover (o renombrar) Archivos===
<syntaxhighlight lang="bash">
git mv archivoViejoNombre archivoNuevoNombre # También se puede mover adentro de un directorio
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
mv archivoViejoNombre archivoNuevoNombre # Se mueve el archivo usando un comando del sistema operativo
git rm archivoViejoNombre # Se borra de Git el del nombre viejo
git add archivoNuevoNombre # Se agrega el del nombre nuevo
</syntaxhighlight>

===Borrar archivos===
<syntaxhighlight lang="bash">
git rm archivoABorrar
</syntaxhighlight>
Esta operación reemplaza los siguientes comandos:
<syntaxhighlight lang="bash">
rm archivoABorrar # Borra el archivo usando un comando del sistema operativo
git rm archivoABorrar # Le avisa a Git que el archivo va a ser eliminado en el próximo commit
</syntaxhighlight>

===Borrar archivos en el staging area===
<syntaxhighlight lang="bash">
git rm --cached archivoNoStaging
</syntaxhighlight>

===Quitar archivos del staging area===
<syntaxhighlight lang="bash">
git reset HEAD archivoNoStaging
</syntaxhighlight>

===Revertir cambios de archivo===
<syntaxhighlight lang="bash">
git checkout -- archivoAResetear
</syntaxhighlight>

===Revertir cambios en el directorio de trabajo===
<syntaxhighlight lang="bash">
git reset --hard # Deshace cambios del staging area y del directorio de trabajo
git clean -f -d # Quita archivos no ''trackeados''
git clean -f -x -d # CUIDADO! Quita archivos no ''trackeados'' PERO ADEMÁS quita archivos ignorados (.gitignore)
</syntaxhighlight>
Fuente: [http://stackoverflow.com/questions/1090309/git-undo-all-working-dir-changes-including-new-files stackoverflow]

===Revertir cambios de ''commit''===
Suponiendo que el Git se encuentra en el siguiente estado:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master

A, B y C son commits. F es el estado del directorio de trabajo. C es el último commit.
</syntaxhighlight>
Se pueden hacer algunos comandos para deshacer ''commits'':
<ul>

<li> Borrar el ''commit'' definitivamente:
<syntaxhighlight lang="bash">
git reset --hard HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'':
<syntaxhighlight lang="bash">
git reset HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>

<li> Borrar el ''commit'' pero mantener los cambios hechos en archivos hasta antes del ''commit'' '''y''' manteniendo el index (''staging area''):
<syntaxhighlight lang="bash">
git reset --soft HEAD~1
</syntaxhighlight>
El estado de Git queda así:
<syntaxhighlight lang="text">
(F)
A-B-C
↑
master
</syntaxhighlight>
</li>
</ul>
Fuente: [http://stackoverflow.com/a/6866485 stackoverflow]

Nota: Para resucitar un commit muerto ver la nota en la fuente.

===Hacer cambios al útlimo ''commit'' con ''--amend''===
Si hay algún archivo que debería haber hecho parte del ''commit'' anterior, se puede agregar con <code>git commit --amend</code>. Un ejemplo de cómo funciona esto:
<syntaxhighlight lang="bash">
git commit -m 'primer commit' # Commit inicial
touch nuevoArchivo # Se agrega nuevo archivo al directorio
git add nuevoArchivo # Se le avisa a Git que hay un nuevo archivo que trackear
git commit --amend # Se actualiza el último commit, debería abrir el editor de texto por defecto
</syntaxhighlight>

===Estado de Archivos===

Para saber el estado de los archivos existen dos comandos posibles: <code>git status</code> y <code>git diff</code>.

====git status====
Muestra información del estado de los archivos que han cambiado. Puede mostrar archivos ''untracked'', ''staged'' y ''modified''. No muestra información de archivos que no han cambiado desde el último ''commit''.

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo sin cambios
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
nothing to commit (working directory clean)
</syntaxhighlight>
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed">
git status: ejemplo de diferentes estados
<div class="mw-collapsible-content">
En el siguiente ejemplo, ''archivoA'' y ''archivoB'' ya están siendo ''tracked'' y ya hicieron parte del commit anterior; ambos fueron modificados. ''archivoA'' no se agregó al ''staging area'' por lo que no va a hacer parte del ''commit''. ''archivoB'' se agregó al ''staging area'' y se va a guardar en el próximo ''commit''.

''archivoC'' es un archivo nuevo que se va a guardar en el próximo ''commit'' y ''archivoD'' es un archivo nuevo no ''tracked'' por Git.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: archivoB
# new file: archivoC
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: archivoA
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# archivoD
</syntaxhighlight>
</div>
</div>

====git diff====
<code>git diff</code> se usa para ver las diferencias que han tenido los archivos y no solo saber si han cambiado o no. <code>git diff</code> por si sólo muestra las diferencias en archivos que no están en el ''staging area''. Para mostrar los cambios en los archivos que están en el ''staging area'' hay que usar el commando con la opción ''--staged'': <code>git diff --staged</code> (para versiones anteriores a 1.6.1 cambiar ''--staged'' por ''--cached'').

<div class="toccolours mw-collapsible mw-collapsed">
git diff: ejemplo
<div class="mw-collapsible-content">

En ''archivoA'' se agregaron dos líneas con el mismo contenido, el nombre del archivo. En ''archivoB'' se agregó una línea con el nombre del archivo.
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Resultado:
<syntaxhighlight lang="bash">
diff --git a/archivoA b/archivoA
index 7898192..c065858 100644
--- a/archivoA
+++ b/archivoA
@@ -1 +1,2 @@
-a
+archivoA
+archivoA
diff --git a/archivoB b/archivoB
index 6178079..df239cf 100644
--- a/archivoB
+++ b/archivoB
@@ -1 +1 @@
-b
+archivoB
</syntaxhighlight>
</div>
</div>

===Historial===
Para ver el historial se usa el comando <code>git log</code>. Se puede usar con varios parámetros para obtener un output más preciso. Para obtener más información ver [http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History este link] o usar <code>git help log</code>.

Algunos parámetros:

;-(n)
:(n) es la cantidad de ''commits'' a mostrar (ej: <code>git log -3</code>)
;--since, --after
:Se le entrega un valor de fecha y muestra ''commits'' solamente a partir de cierta fecha (ej: <code>git log --since=2.weeks</code>)
;--until, --before
:Se le entrega un valor de fecha y muestra ''commits'' solamente desde cierta fecha (ej: <code>git log --until=2.weeks</code>)
;--author
:Se le proporciona a Git el autor para la búsqueda
;--stat
:Se muestran los archivos modificados.

==Git Remoto==
Para poder colaborar en un proyecto, se necesitan servidores remotos, ''remotes''.

===Crear nuevo proyecto a partir de un remote===
El siguiente comando crea una carpeta con el proyecto obtenido desde una fuente externa, crea la carpeta .git y obtiene los archivos del proyecto.
<syntaxhighlight lang="bash">
git clone username@host:/path/to/repository # Obtener copia remotamente
</syntaxhighlight>

===Agregar remote===
El siguiente comando agrega un ''remote'' al proyecto Git actual, esto solo asocia un ''remote'' al proyecto pero no obtiene los archivos. nombreReferencia es un nombre arbitratio que se le da al remote para referenciarlo.

<syntaxhighlight lang="bash">
git remote add nombreReferencia username@host:/path/to/nombreRepositorio
</syntaxhighlight>

===Obtener archivos de remote===
El siguiente comando obtiene los archivos desde un ''remote'' ya agregado '''pero''' no los deja en el directorio de trabajo, quedan "escondidos" en la base de datos de Git.
<syntaxhighlight lang="bash">
git fetch nombreReferencia
</syntaxhighlight>

===Mezclar lo obtenido en el directorio actual===
Este comando mezcla la rama de nombreReferencia al directorio actual ([http://stackoverflow.com/questions/3419658/understanding-git-fetch-then-merge más info en stackoverflow]).
<syntaxhighlight lang="bash">
git merge nombreReferencia/rama
</syntaxhighlight>

===Obtener y Mezclar (merge) archivos de remote===
Se obtienen los archivos y luego se mezclan con lo que hay en el directorio de trabajo.
<syntaxhighlight lang="bash">
git pull nombreReferencia HEAD # Si no especifico HEAD me pide una versión
</syntaxhighlight>

===Subir cambios a remote===
Se suben los cambios al ''remote'' origin en la branch (rama) master.
<syntaxhighlight lang="bash">
git push origin master
</syntaxhighlight>

===Listar remotes===

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos
<div class="mw-collapsible-content">
<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>
Resultado:

<syntaxhighlight lang="bash">
origin
ticgit
</syntaxhighlight>

</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Listar remotos con URLs
<div class="mw-collapsible-content">

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Resultado:

<syntaxhighlight lang="bash">
origin /gitExample2/../gitExample (fetch)
origin /gitExample2/../gitExample (push)
ticgit git://github.com/schacon/ticgit.git (fetch)
ticgit git://github.com/schacon/ticgit.git (push)
</syntaxhighlight>

</div></div>

===Obtener información de un remote===
Con este comando se obtiene la información del ''remote'' y de las ''branches'' (ramas) que se están ''tracking''.
<syntaxhighlight lang="bash">
git remote show ticgit
</syntaxhighlight>

===Renombre remote===
<syntaxhighlight lang="bash">
git remote rename nombreViejo nombreNuevo
</syntaxhighlight>

===Quitar remote===
<syntaxhighlight lang="bash">
git remote rm remoteName
</syntaxhighlight>

==Otras páginas utiles adentro del Wiki==
* [[Git, Branching]], ''branching'' es una forma de llevar el desarrollo por diferentes caminos sin que se pisen entre ellos.
* [[Git, Tagging]], el ''tagging'' sirve para referenciar diferentes ''commits'' en el tiempo.
* [[Git, Stashing]], el ''stashing'' sirve para limpiar las modificaciones actuales en el espacio de trabajo y guardarlas temporalmente fuera de vista. Se pueden recuperar luego.

==Links útiles==
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Auto-Completion Hacer que Git autocomplete]
* [http://git-scm.com/book/en/Git-Basics-Tips-and-Tricks#Git-Aliases Hacer alias para comandos]

==Más información==
* [https://na1.salesforce.com/help/pdfs/en/salesforce_git_developer_cheatsheet.pdf Git Cheat Sheet]
* [http://ndpsoftware.com/git-cheatsheet.html Git Cheatsheet • NDP Software]
* [http://git-scm.com/book/en/ Libro Oficial]
* [http://rogerdudler.github.io/git-guide/ git - the simple guide]

[[Category:Git]]

Generar diccionario de datos con MySQL Workbench

2014-04-22T15:31:12Z

Alex: /* Instalación del Plugin */

== Instalación del Plugin ==

# Descargamos el archivo [[Media:Plungin_MW.zip | Plugin Diccionario de Datos MysqlWorbench]].
# Ahora descomprimimos la carpeta que esta dentro del paquete que descargamos.
# Abrimos MySQL Workbench y seleccionamos en el menu superior la opción '''Scripting''' y luego '''Install Plugin/Module'''.
# Se abrirá una ventana y buscamos el archivo datadict_grt.py en la carpeta que descomprimimos en el paso 2.
# Aparecerá el resultado de la instalación.
# Reiniciamos MySQL Workbench.

== Generar el diccionario de datos ==

# Abrimos nuestro modelo ERR (al que queremos generar nuestro diccionario).
# Una vez abierto vamos al menú superior y seleccionamos la opción '''Tools''', luego '''Catalog''' , y por último '''Generate HTML Data Dictionary'''.
# Aparecerá una ventana donde daremos nombre al archivo a generar y seleccionaremos la ruta donde queremos almacenar el archivo .html, damos click en el botón guardar y aparecerá el resultado de la acción.
# Ahora si buscamos el archivo en la ruta indicada y lo abrimos se abrira nuestro navegador web con el diccionario de datos.

Generar diccionario de datos con MySQL Workbench

2014-04-22T15:30:23Z

Alex: /* Instalación del Plugin */

== Instalación del Plugin ==

# Vamos a la dirección [[Media:Plungin_MW.zip | asd]] y descargamos el archivo.
# Ahora descomprimimos la carpeta que esta dentro del paquete que descargamos.
# Abrimos MySQL Workbench y seleccionamos en el menu superior la opción '''Scripting''' y luego '''Install Plugin/Module'''.
# Se abrirá una ventana y buscamos el archivo datadict_grt.py en la carpeta que descomprimimos en el paso 2.
# Aparecerá el resultado de la instalación.
# Reiniciamos MySQL Workbench.

== Generar el diccionario de datos ==

# Abrimos nuestro modelo ERR (al que queremos generar nuestro diccionario).
# Una vez abierto vamos al menú superior y seleccionamos la opción '''Tools''', luego '''Catalog''' , y por último '''Generate HTML Data Dictionary'''.
# Aparecerá una ventana donde daremos nombre al archivo a generar y seleccionaremos la ruta donde queremos almacenar el archivo .html, damos click en el botón guardar y aparecerá el resultado de la acción.
# Ahora si buscamos el archivo en la ruta indicada y lo abrimos se abrira nuestro navegador web con el diccionario de datos.

Generar diccionario de datos con MySQL Workbench

2014-04-22T15:30:03Z

Alex: /* Instalación del Plugin */

== Instalación del Plugin ==

# Vamos a la dirección [[Media:Plungin_MW.zip asd]] y descargamos el archivo.
# Ahora descomprimimos la carpeta que esta dentro del paquete que descargamos.
# Abrimos MySQL Workbench y seleccionamos en el menu superior la opción '''Scripting''' y luego '''Install Plugin/Module'''.
# Se abrirá una ventana y buscamos el archivo datadict_grt.py en la carpeta que descomprimimos en el paso 2.
# Aparecerá el resultado de la instalación.
# Reiniciamos MySQL Workbench.

== Generar el diccionario de datos ==

# Abrimos nuestro modelo ERR (al que queremos generar nuestro diccionario).
# Una vez abierto vamos al menú superior y seleccionamos la opción '''Tools''', luego '''Catalog''' , y por último '''Generate HTML Data Dictionary'''.
# Aparecerá una ventana donde daremos nombre al archivo a generar y seleccionaremos la ruta donde queremos almacenar el archivo .html, damos click en el botón guardar y aparecerá el resultado de la acción.
# Ahora si buscamos el archivo en la ruta indicada y lo abrimos se abrira nuestro navegador web con el diccionario de datos.

File:Plungin MW.zip

2014-04-22T15:29:20Z

Alex: