Dónde y cómo crear el fichero .gitignore

En el apartado "Ignorando Archivos" de http://progit.org/book/es/ch2-2.html se explica de maravilla cómo evitar que vayan a parar a nuestro repositorio determinados ficheros (por ejemplo módulos compilados, ficheros de backup, ejecutables, etc.).

Solo he tropezado con un par de detalles, el dónde y el cómo. Pues bien, el fichero ".gitignore" hay que crearlo en el "working directory" del proyecto y no en el directorio ".git". Respecto al cómo, apuntar que los usuarios de Windows pueden tener problemas al tratar de guardar un fichero solo con extensión y sin nombre, pero se puede hacer fácilmente desde la consola de Git con el comando "git vi .gitignore" (sobre el manejo del editor vi hay información básica en http://es.wikipedia.org/wiki/Vi).

Es fácil ver si el .gitignore está surtiendo efecto. Si creamos o metemos un fichero de los que deseamos ignorar en el directorio de trabajo y hacemos un "git status", éste no aparecerá en la lista de los "Untrucked".

TortoiseGit

Aunque Git dispone de un interfaz gráfico que se puede lanzar desde la consola mediante el comando "gitk", TortoiseGit nos ofrece muchas más posibilidades directamente desde el explorador de archivos de Windows. En primer lugar, con sus indicadores visuales podemos ver el estado de los ficheros y carpetas de nuestro proyecto:

Y con clic derecho disponemos de un amplio menú contextual para interactuar con Git.

Respecto a la instalación no hay mucho que decir. Es muy sencilla y no requiere ajustes posteriores, al menos por lo que he podido ver hasta ahora.

El mejor manual de Git

Mi búsqueda de información sobre Git y algunas pruebas con el producto me han permitido escribir varias entradas sobre mis primeras experiencias con este sistema de control de versiones. También he elaborado una pequeña lista de enlaces interesantes (se encuentran en el apartado "Enlaces" del blog), pero creo que he encontrado el manual ideal. Para todo aquel que quiera un manual es español, útil, riguroso y perfectamente estructurado les recomiendo esta página: Pro Git en español.

Git - Aclarando conceptos: working directory, staging area y repositorio

Comprender la lógica de trabajo de Git requiere entender con claridad estos tres conceptos. Para ello recomiendo la lectura de esta página del fantástico libro "Pro Git" (http://progit.org/book/es/) y, en particular, del apartado "Los tres estados". De él he extraído de forma casi literal estas tres definiciones:

• El directorio de Git es donde Git almacena los metadatos y la base de datos de objetos para el proyecto. Es la parte más importante de Git, y es lo que se copia cuando clonas un repositorio desde otro ordenador. Es el que contiene el repositorio (repository).
  
  
• El directorio de trabajo (working directory) es una copia de una versión del proyecto. Estos archivos se sacan de la base de datos comprimida en el directorio de Git, y se colocan en disco para que los puedas usar o modificar. Se puede decir que es el que aloja físicamente los archivos del proyecto.
  
  
• El área de preparación (staging area) es un sencillo archivo, generalmente contenido en tu directorio de Git, que almacena información acerca de lo que va a ir en tu próxima confirmación. A veces se denomina el índice (index), pero se está convirtiendo en estándar el referirse a ello como el área de preparación.

Los archivos nuevos y los modificados se "pasan" primero al área de preparación (staging area) para luego pasarlos definitivamente al repositorio. Por tanto, los ficheros temporales, ejecutables, etc. que no queremos que vayan al repositorio bastará con que no los pasemos nunca al área de preparación (mediante "git add"). Al no hacerlo, Git los ignorará totalmente.

De esta forma podemos controlar perfectamente los archivos que gestionará Git de nuestro directorio de trabajo y que formarán parte del repositorio. En general no tiene sentido, por ejemplo, que estemos guardando en el repositorio cada cambio de un ejecutable que en todo momento podemos generar con el código fuente que por supuesto sí guardamos en él.

Git para Dummies - Paso 3 - Empezando por fin

Vamos, por fin, a tratar de dar los primeros pasos trabajando realmente con Git. Para ello voy a recurrir a un proyecto ficticio sobre el que haré las pruebas. He creado en mi disco duro una carpeta llamada "MiProyecto" y dentro he creado dos simples ficheros de texto llamados "ModuloA.txt" y "ModuloB.txt" (he evitado las tildes deliberadamente) cuyo contenido es "Fuente A - Versión 1" y "Fuente B - Versión 1" respectivamente.

Ahora vamos a lanzar el Git Bash en el directorio del proyecto. Bastará con un clic con el botón derecho sobre la carpeta y elegir la opción "Git Bash". Ya tenemos la consola de Git en pantalla. Empezamos!

• Paso 1: Creamos un repositorio local con el comando "git init". Esto creo un repositorio local vacío en una carpeta oculta llamada ".git" con una estructura como la que se muestra a continuación:

• Paso 2: Ejecutamos "git add ." para añadir todos los ficheros del proyecto al llamado "index" o "staging area".
  
• Paso 3: Ejecutamos 'git commit -m "Primera copia"' para grabar los cambios de los ficheros registrados en el "staging area" en el repositorio.

Esto es solo un pequeño "aperitivo", un ejemplo de uso de la consola de Git para, al menos, dar un idea de cómo se trabaja con él. En otras entradas iremos profundizando en conceptos, comandos, etc. que creo aclararán al que no lo sepa o haya entendido qué hemos hecho exactamente con estas tres instrucciones.

Aprovecho para recordar que desde la consola podemos obtener directamente ayuda sobre un comando determinado mediante "git help <comando>", por ejemplo "git help commit". Y si simplemente ejecutamos "git" se mostrará la lista de comandos disponibles.

Git para Dummies - Paso 2 - Git Bash - Nociones

Como se vio en la entrada anterior, tras la instalación de Git, una de las nuevas opciones de que disponemos en el menú de programas de Windows es "Git"->"Git Bash". He extraído esta definición de "Bash" de la Wikipedia:

Bash es un programa informático cuya función consiste en interpretar órdenes. Está basado en la shell de Unix y es compatible con POSIX. Fue escrito para el proyecto GNU y es el intérprete de comandos por defecto en la mayoría de las distribuciones de Linux.

(Para información mucho más detallada: http://es.wikipedia.org/wiki/Bash)

Por tanto, el nombre (Git Bash) ya nos dice mucho. Se trata de una consola desde la que ejecutar comandos de Git. El aspecto es como el de la imagen siguiente:

En esta ventana se pueden ejecutar los comandos Linux más habituales, por ejemplo ls, cd, pwd, etc. (clic aquí para una lista completa) pero la idea es ejecutar comandos de Git, como podría ser por ejemplo "git commit". Para conocer los comandos de Git basta con ejecutar "git".

Si en el proceso de instalación hemos elegido "Run Git from de Windows Command Prompt" también podemos ejecutar comandos de Git directamente desde el símbolo del sistema de Windows . En el pantallazo que sigue se ha llamado a Git desde el símbolo del sistema:

En esta ventana lógicamente lo que el sistema entiende son los comandos habituales de Windows y no los de Linux como en el caso del Git Bash pero, igualmente, para ejecutar comandos de git basta con escribirlos en la forma "git comando".

MUY IMPORTANTE: Desde la consola podemos obtener directamente ayuda sobre un comando determinado mediante "git help <comando>", por ejemplo "git help commit". Y si simplemente ejecutamos "git" se mostrará la lista de comandos disponibles.

Git para Dummies - Paso 1 - Instalación en Windows

Como el primer "dummie" total en sistemas de control de versiones, y por supuesto en Git, es el que escribe, hay que tomar estas entradas como un mero reflejo de mi experiencia desde la absoluta y total inexperiencia y desconocimiento de Git. Con el tiempo iré corrigiendo los errores que pueda en estos textos, pero espero que puedan servir al menos para ayudar a otros en algún aspecto.

Bueno, al grano. De momento sigo estos pasos:

• Me dirijo a la Web oficial de Git: http://git-scm.com/
• Hago clic en el enlace "Dowload" y luego en el enlace "Windows" del apartado "Download Git"
• Descargo "Git-1.7.4-preview20110204.exe"

Al ejecutar el instalador tomo las opciones por defecto que el programa propone excepto en el primer paso. En éste elijo "Run Git from the Windows Command Prompt" porque creo que me facilitará las cosas. A continuación muestro en imágenes las tres elecciones que he hecho:

Una vez terminada la instalación, lo primero que encuentro es una nueva opción llamada "Git" en el menú de programas de Windows. Ésta  me da acceso a otras dos: "Git Bash" y "Git GUI" como se muestra en la imagen que sigue:

Imagen A

Ahora, aunque ya se intuye, habrá que averiguar qué es exactamente cada cosa.

El otro cambio que se puede percibir tras la instalación es que en los menús contextuales (al hacer clic con el botón derecho) de cualquier carpeta aparecen estas tres nuevas opciones:

Imagen B 

Vamos a ver qué es todo esto para tratar de entender lo mejor posible cómo funciona Git, pero mi idea (no sé todavía si errónea) es recurrir más adelante a TortoiseGit que parece ofrecer una forma más intuitiva y sencilla de utilizarlo.

Por lo pronto aclarar que llamar al Git Gui (Graphic User Interface for Git) desde el menú de Windows (Imagen A) o desde el contextual de una carpeta  (Imagen B) resulta totalmente indiferente. Se abre la aplicación exactamente de la misma forma. A continuación se muestra un pantallazo:

En el caso de Git Bash la cosa cambia. Si lo ejecutamos desde el menú contextual de una carpeta (Imagen B) la consola estará ya ubicada en ese directorio y si lo ejecutamos desde el menú de programas de Windows (Imagen A) se abrirá en el directorio actual del sistema, por ejemplo "C:\Documents and Settings\PCXX".

¿Git o SubVersion (SVN)?

En cuanto a software de control de versiones para Symfony, el dilema está absolutamente claro: hay que utilizar Git. ¿Por qué? Pues porque Git es el oficial para Symfony 2. Así que Subversion descartado.

Sin duda se han decantado por Git porque éste presenta muchas ventajas. Es opensource, distribuido, no intrusivo, está disponible para Windows, Linux y Mac, etc. Y tiene una característica desde mi punto de vista especialmente destacable: ¡permite llevar un control de versiones incluso de ficheros binarios!

Dos enlaces para ir echando un vistazo:

• Web oficial de Git
• Interfaz TortoiseGit

Si se desconoce totalmente Git o los sistemas de control de versiones aquí hay unos vídeos estupendos y en español. Aunque modestos en la realización, creo que pueden resultar muy útiles para descubrir qué es Git y cómo empezar a utilizarlo. De hecho, en parte, me he inspirado en alguno de ellos para escribir algunas de las próximas entradas.

• Introducción a Git 1/5
  Se explica qué es Git y cuales son sus prestaciones, características fundamentales y ventajas frente a otros sistemas de control de versiones.
• Introducción a Git 2/5 
• Introducción a Git 3/5 
• Introducción a Git 4/5
• Introducción a Git 5/5