LaTeX y Git: ¿Cómo controlar archivos de LaTeX eficientemente?

LATEX y Git
¾Cómo controlar documentos en LATEX ecientemente?
Maikol Solís

LATEX
LATEX es un excelente sistema para crear textos
matemáticos.
Si no sabe como usarlo, pregunte, busque y aprenda porque
lo va a necesitar tarde o temprano.
Maikol Solís LATEX y Git 2 / 51

Sección 1
¾Qué es Git?

Historia
Git fue creado por Linus Torvals en 2005.
La idea era poder controlar los cambios en el kernel Linux.
Las características del nuevo sistema eran:
Velocidad.
Diseño simple.
Desarrollo no lineal (trabajos en paralelo).
Fácil colaboración.
entre otros.

¾Quién usa Git?
y muchísimos proyectos más...

Instalación
Linux: Ubuntu, Debian, OpenSuse, Fedora, ...

Instalación
MacOS: brew install git.

Instalación
Windows:

Instalación
Windows: Es posible pero desconozco como funciona.

Sección 2
Nombres anticipados

El problema
Se empieza un proyecto nuevo (artículo, tesis de maestría, lista de
ejercicios, reporte de proyecto, etc).
¾Cómo guardamos los cambios importantes?

El problema
Una forma es ir haciendo copias de seguridad.
proyecto.tex
proyecto.2013_08_01.tex
...

El problema
Una forma es ir haciendo copias de seguridad.
proyecto.tex
...
Esto podría funcionar bien...

El problema
¾O tal vez no?

Final (¾?)

Antes: Mi tesis de Maestría

Entonces, ¾Cómo funciona Git?
Conserva una única versión de cada archivo.
Evita la repetición de archivos con diferentes nombres.

Toma una foto de los cambios periódicamente.
Los cambios se guardan con el comando git commit.

Toma una foto de los cambios periódicamente.
Los cambios se guardan con el comando git commit.
Esas fotos quedan en una bitácora de cambios.
Este registro es una memoria de largo plazo.

Archivo
proyecto.tex
Registro de cambios
Author: Fulano fulano@gee-mail.com
Date: Sat Mar 15 16:40:33 2008 -0700
agregué un nuevo teorema
Author: Sutano sutano@gee-mail.com
Date: Sat Mar 15 10:31:28 2008 -0700
primera modficación

Después: Artículo controlado

Sección 3
¾Cómo empiezo?

El inicio git init
Lo primero es crear un directorio compatible con Git.
$ cd /directorio/del/proyecto
$ git init
Initialized empty Git repository
in /directorio/del/proyecto/.git/

El inicio git init
$ git init
Recuerde
git init Inicializa cualquier directorio como un directorio Git.

El inicio git init
$ git init
Recuerde
git init Inicializa cualquier directorio como un directorio Git.
½Perfecto! Ya podemos empezar a trabajar.

Aclaración: Dos formas de usar git.
Interfaz gráca: Git-Cola, SmartGit, etc.

Aclaración: Dos formas de usar git.
Consola.

Estado de las cosas git status
$ git status

$ git status
# On branch master
#
# Initial commit
#
# Untracked files:
# (use git add file... to include in what will
#be committed)
#
# proyecto.tex
nothing added to commit but untracked files present
(use git add to track)

$ git status
# On branch master
#
# Initial commit
#
# Untracked files:
# (use git add file... to include in what will
#be committed)
#
# proyecto.tex
nothing added to commit but untracked files present
(use git add to track)
$ git status -s
?? proyecto.tex

Agregando archivos git add
Se tienen que denir cuales archivos quiero controlar.
Estos archivos se agregan a una zona temporal (staging).
$ git add proyecto.tex

Agregando archivos git add
Se tienen que denir cuales archivos quiero controlar.
Estos archivos se agregan a una zona temporal (staging).
$ git add proyecto.tex
$ git status -s
A proyecto.tex

Manos a la obra
Comencemos a escribir nuestro documento...
documentclass{article}
title{Mi nuevo proyecto}
author{Profesor X}
begin{document}
maketitle
Este será un gran proyecto.
end{document}

Manos a la obra
Comencemos a escribir nuestro documento...
documentclass{article}
author{Profesor X}
begin{document}
maketitle
Este será un gran proyecto.
end{document}
Lo primero que notamos es
$ git status -s
AM proyecto.tex

Viendo las diferencias git diff
$ git diff

$ git diff
diff --git a/proyecto.tex b/proyecto.tex
index e69de29..82e2f40 100644
--- a/proyecto.tex
+++ b/proyecto.tex
@@ -0,0 +1,7 @@
+documentclass{article}
+title{Mi nuevo proyecto}
+author{Profesor X}
+begin{document}
+maketitle
+Este será un gran proyecto.
+end{document}

$ git diff
diff --git a/proyecto.tex b/proyecto.tex
index e69de29..82e2f40 100644
--- a/proyecto.tex
+++ b/proyecto.tex
@@ -0,0 +1,7 @@
+documentclass{article}
+title{Mi nuevo proyecto}
+author{Profesor X}
+begin{document}
+maketitle
+Este será un gran proyecto.
+end{document}
+ Línea agregada.
- Línea eliminada.

Guardando los cambios git commit
$ git commit proyecto.tex

Guardando los cambios git commit
$ git commit proyecto.tex
Iniciando mi nuevo proyecto - Mensaje opcional de los cambios.
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# Explicit paths specified without -i nor -o; assuming only paths...
# On branch master
# Changes to be committed:
# (use git reset HEAD file... to unstage)
#
# modified: proyecto.tex
#
# Untracked files:
# (use git add file... to include in what will be committed)
#
# proyecto.aux
# proyecto.log
# proyecto.pdf

Enjuage y repita
Se modica los archivos en la computadora.

Enjuage y repita
git add Agrega eso archivos a una zona temporal

Enjuage y repita
git status Muestra el estado de los archivos modicados.

Enjuage y repita
git di Muestra las diferencias entre lo que está en la zona temporal y
lo que está en el directorio de trabajo.

Enjuage y repita
git di Muestra las diferencias entre lo que está en la zona temporal y
lo que está en el directorio de trabajo.
git commit Guarda todos los cambios de la zona temporal al registro
de cambios.

Vamos por partes hunks
Hagamos algunos cambios a nuestro documento.
documentclass[spanish]{article}
%% Paquetes
usepackage{amsthm}
usepackage{amsmath}
usepackage{amssymb}
%% Tipos de teorema
theoremstyle{plain}
newtheorem{teorema}{Teorema}
%% Titulo
%% Autor
author{Profesor X}
%% Inicio
begin{document}
maketitle
Este ser'a un gran proyecto.
begin{teorema}
Para todo $thetainmathbb{R}$, $
end{teorema}
end{document}

diff git a/proyecto.tex b/proyecto.tex
index 9ba2543..1b8308b 100644
- a/proyecto.tex
+++ b/proyecto.tex
@@ -1,5 +1,10 @@
+%% Paquetes
+usepackage{amsthm}
+usepackage{amsmath}
+usepackage{amssymb}
+
%% Tipos de teorema
theoremstyle{plain}
@@ -16,4 +21,8 @@
+begin{teorema}
+ Para todo $thetainmathbb{R}$,
+ $sin^2theta+cos^2theta=1$.
+end{teorema}
+

diff git a/proyecto.tex b/proyecto.tex
index 9ba2543..1b8308b 100644
- a/proyecto.tex
+++ b/proyecto.tex
@@ -1,5 +1,10 @@
+%% Paquetes
+usepackage{amsthm}
+usepackage{amsmath}
+usepackage{amssymb}
+
%% Tipos de teorema
theoremstyle{plain}
@@ -16,4 +21,8 @@
+begin{teorema}
+ Para todo $thetainmathbb{R}$,
+ $sin^2theta+cos^2theta=1$.
+end{teorema}
+
Tarea
git commit -p Para guardar los cambios selectivamente.

Recordando git log
$ git log

Recordando git log
$ git log
commit 0f82ed2d76d1cfebf1c3bc606fbb7dc4bbf7983d
Author: Maikol Solís maikol.solis@ucr.ac.cr
Date: Fri Jul 26 10:39:26 2013 +0200
Nuevo teorema sobre trigonometría.
commit 902deb5716fe1a609ecb5ea76a61ec8938ebb382
Date: Fri Jul 26 10:38:41 2013 +0200
Agregando los paquetes básicos de matemática

Sección 4
No se ande por las ramas

Trabajando en paralelo
¾Han notado algo raro en el mensaje de git status?
# On branch master

# On branch master
Ramicar nuestro trabajo en diferentes proyectos o tareas
Borradores.
Nuevos elementos (ejemplos, ejercicios, simulaciones, etc.)
Ideas locas.

# On branch master
Ramicar nuestro trabajo en diferentes proyectos o tareas
Borradores.
Nuevos elementos (ejemplos, ejercicios, simulaciones, etc.)
Ideas locas.
git branch nombre-rama copia la última versión de la rama actual a una
nueva rama llamada nombre-rama.

Creando ramas git branch
Para los que hacen tesis
Una rama llamada tutor les va a salvar la vida.

$ git branch tutor

$ git branch tutor
$ git branch nuevo-teorema

$ git branch tutor
$ git branch nuevo-teorema
$ git branch
* master
nuevo-teorema
tutor

De rama en rama git checkout
$ git checkout tutor
Switched to branch 'tutor'

$ git branch
master
nuevo-teorema
* tutor

$ git branch
master
nuevo-teorema
* tutor
Todos los archivos serán modicados en la rama tutor.
Si cambiamos a otra rama (master por ejemplo), todos los cambios se
revertirán hasta el último estado de la otra rama.

$ git branch
master
nuevo-teorema
* tutor
Todos los archivos serán modicados en la rama tutor.
Si cambiamos a otra rama (master por ejemplo), todos los cambios se
revertirán hasta el último estado de la otra rama.
½Ahora si ya podemos trabajar en paralelo!

Modicamos el archivo en la rama tutor. Veamos el resultado:

Modicamos el archivo en la rama tutor. Veamos el resultado:
$ git diff
...
begin{document}
maketitle
-Este será un gran proyecto.
+Mi tutor quiere que cambie la introducción.
begin{teorema}
Para todo $thetainmathbbR$,
$sin^2theta+cos^2theta=1$.

Ejecutamos git checkout nuevo-teorema y modicamos otra vez el
archivo.

Ejecutamos git checkout nuevo-teorema y modicamos otra vez el
archivo.
$ git diff
...
begin{teorema}
- Para todo $thetainmathbb{R}$,
- $sin^2theta+cos^2theta=1$.
+ Para todo $xinmathbb{R}$,
+$e^{ix} = cos x + isin x$ donde $i$
+es la unidad imaginaria.
end{teorema}
end{document}

Ayuda visual gitk
$ gitk

Juntando todo git merge
Queremos incluir los cambios de las ramas nuevo-teorema y tutor
en nuestro documento principal.

¾Qué hacemos?
1 $ git checkout master
Cambiamos a la rama donde queremos los cambios.

¾Qué hacemos?
2 $ git merge nuevo-teorema
Fusionamos los cambios de la rama nuevo-teorema.

¾Qué hacemos?
2 $ git merge nuevo-teorema
Fusionamos los cambios de la rama nuevo-teorema.
3 $ git merge tutor
Hacemos lo mismo con la rama tutor.

¾Lo hice bien?

Resumiendo
git branch Enlista, crea y maneja diferentes ramas de trabajo

Resumiendo
git checkout Cambia a una nueva rama de trabajo.

Resumiendo
git checkout Cambia a una nueva rama de trabajo.
git merge Fusiona una rama de trabajo dentro la rama actual.

Sección 5
½Pasame el .tex!

½Pasame el .tex!
Colaborar con archivos siempre ha sido complicado.
La forma tradicional es usar llave usb, email, etc.
Ahora se puede usar Dropbox, Gdrive, etc.

½Pasame el .tex!
¾Pero cómo sabemos quién cambió qué?

½Pasame el .tex!
¾Pero cómo sabemos quién cambió qué?
A veces tenemos muchas versiones del mismo archivo.
proyecto_definitivo.tex
proyecto_definitivo_cambios_Paco.tex
proyecto_definitivo_cambios_Elena.tex
proyecto_definitivo_Final.tex
...
¾Cuál enviamos?

En las nubes git remote
Git puede sincronizar nuestros documentos en la nube.

Git puede sincronizar nuestros documentos en la nube.
Para eso hay muchos sitios especializados
www.github.com
www.bitbucket.org
etc.

¾Cómo?
$ git remote add mirepo www.servidorgit.com/proyecto.git

¾Cómo?
# Para enviar todo el repositorio por primera vez
$ git push -u mirepo all

¾Cómo?
# Para enviar todo el repositorio por primera vez
$ git push -u mirepo all
www.servidorgit.com/proyecto.git
* [new branch] master - master
* [new branch] nuevo-teorema - nuevo-teorema
* [new branch] tutor - tutor
Branch master set up to track remote branch master from origin.
Branch nuevo-teorema set up to track remote branch nuevo-teorem
Branch tutor set up to track remote branch tutor from origin.

El ataque de los clones git clone
Marcos Ramírez quiere copiar localmente mi repositorio en su computadora

$ git clone www.servidorgit.com/proyecto.git

$ git clone www.servidorgit.com/proyecto.git
Cloning into 'proyecto'...
remote: Counting objects: 21, done.
remote: Compressing objects: 100% (14/14), done.
remote: Total 21 (delta 6), reused 0 (delta 0)
Unpacking objects: 100 % (21/21), done.

Rastreando cambios Tracking branches
$ git branch -a
* master
remotes/origin/HEAD - origin/master
remotes/origin/master
remotes/origin/nuevo-teorema
remotes/origin/tutor

Rastreando cambios Tracking branches
$ git branch -a
* master
remotes/origin/HEAD - origin/master
remotes/origin/master
remotes/origin/nuevo-teorema
remotes/origin/tutor
Tracking branch
Crea una rama local ligada a la rama remota
$ git branch tutorMarcosRamirez remotes/origin/tutor

½Empuje! ½Empuje! git push
Marcos Ramirez modica la introducción en la rama tutor
$ git checkout tutorMarcosRamirez
$ git diff
...
-Mi tutor quiere que cambie la introducción.
+El problema que veremos a continuación es muy
+interesante. Vamos a analizarlo profundamente.
...

½Empuje! ½Empuje! git push
Luego él envía todos esos cambios al servidor remoto:
$ git push
To www.servidorgit.com/proyecto.git
f1afe8e..b0e7428 tutorMarcosRamirez - tutor

½Jale! ½Jale! git pull
Quiero recuperar los cambios que hizo Marcos Ramírez en mi computadora.

½Jale! ½Jale! git pull
Quiero recuperar los cambios que hizo Marcos Ramírez en mi computadora.
$ git pull
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 1), reused 0 (delta 0)
Unpacking objects: 100% (3/3), done.
From www.servidorgit.com/proyecto.git
f1afe8e..b0e7428 tutor - origin/tutor
Updating f1afe8e..b0e7428
Fast-forward
proyecto.tex | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)

Todos ayudan
commit b0e742872d4207b27621b02401f2b601c1a1a067
Author: Marcos Ramírez marcos.ramirez@ucr.ac.cr
Date: Fri Aug 2 13:09:37 2013 -0600
Introducción por Marcos Ramírez
commit f1afe8ed5a928b82aeeb4d511d4b2a39fc01c235
Date: Sat Jul 27 17:33:46 2013 +0200
Un cambio en la introducción

Servidor propio Escuela de Matemática

Servidor propio Escuela de Matemática
$ git remote add mirepo www.emate.ucr.ac.cr/git/proyecto.git
$ git remote add mirepo git.emate.ucr.ac.cr/proyecto.git
Documentos de cursos:
Cartas al estudiante.
Listas de ejercicios.
Libros de texto.
Proyectos para grupos de investigación.
Artículos.
...

Resumiendo
git remote Enlista, agrega y borra repositorios remotos.

Resumiendo
git clone Copia un repositorio git remoto a su computadora para
trabajar localmente.

Resumiendo
git pull Carga los cambios desde un repositorio remoto y trata de
fusionar esos cambios en la rama actual. Otra opción es git fetch.

Resumiendo
git pull Carga los cambios desde un repositorio remoto y trata de
fusionar esos cambios en la rama actual. Otra opción es git fetch.
git push Envía todos los cambios hacia los repositorios remotos.

Sección 6
¾Y qué falta?

TODO...
Revertir versiones.
Recuperar archivos. Git nunca borra, solo rastrea cambios.
Reescribir la historia de cambios.
Creación de roles de trabajo. Administrador, usuarios (lectura o
escritura).
y un gran etcétera.

Sección 7
¾Y la ayuda?

$ git comando --help
$ git help comando
Sitio ocial. www.git-scm.com
Tutoriales. www.atlassian.com/git/tutorial
Internet. Google es su amigo.

¾Qué pasa después de leer la
documentación de Git?

½Muchas gracias por su atención!

LaTeX y Git: ¿Cómo controlar archivos de LaTeX eficientemente?

Más contenido relacionado

La actualidad más candente

Destacado

Similar a LaTeX y Git: ¿Cómo controlar archivos de LaTeX eficientemente?

Último

LaTeX y Git: ¿Cómo controlar archivos de LaTeX eficientemente?