Git para LaTeX

Historial, comparación y restauración: versiona tus proyectos LaTeX en BlaBLaTeX.

BlaBLaTeX integra Git para LaTeX para gestionar el historial, las versiones y la trazabilidad de tus proyectos. Puedes clonar un proyecto, trabajar en local (editor, scripts) y luego hacer push para recuperar automáticamente tus cambios en el workspace. También puedes partir de un repositorio Git local ya existente y conectarlo a un proyecto BlaBLaTeX.

Ir a lo esencial

Encontrar la URL Git · Inicio rápido · Repositorio local ya existente · Flujo de trabajo recomendado · Documentación

Volver atrás

Restaura una versión estable (commit) sin multiplicar las copias de archivos.

Comparar

Identifica las diferencias entre dos versiones (diff) y valida una corrección.

Rastrear

Historial claro: quién cambió qué, cuándo y por qué (mensaje de commit).

Compartir

Sincroniza desde/hacia el workspace de BlaBLaTeX para revisión y trabajo en equipo.

Paso 1

Encontrar la URL Git de tu proyecto BlaBLaTeX

Cada proyecto BlaBLaTeX tiene una URL Git dedicada construida a partir del identificador presente en la URL del workspace:

  • Workspace: https://workspace.blablatex.com/project/<ID_DEL_PROYECTO>
  • Git: https://git.blablatex.com/project/<ID_DEL_PROYECTO>.git
Workspace: https://workspace.blablatex.com/project/6940036c696502c3fc2d49dc
Git      : https://git.blablatex.com/project/6940036c696502c3fc2d49dc.git

Si ya sabes usar Git: quédate con clone, pull y push.

Paso 2

Inicio rápido: clonar, modificar, enviar

Copia la URL Git de tu proyecto (sección anterior) y luego: 

# 1) Clonar el proyecto
git clone https://git.blablatex.com/project/<ID_DEL_PROYECTO>.git
cd <carpeta_del_proyecto>

# 2) Verificar el estado
git status
git log --oneline -n 10

# 3) Modificar y enviar a BlaBLaTeX
git add -A
git commit -m "Actualización del documento"
git push

Después de git push, los archivos se actualizan automáticamente en tu workspace de BlaBLaTeX.

Paso 3

Partir de un repositorio Git local ya existente

Si ya tienes un proyecto versionado localmente, puedes conectarlo directamente a BlaBLaTeX. Empieza creando un proyecto en BlaBLaTeX, recupera su identificador y luego añade el remote correspondiente.

Si tu rama local se llama main: 

git remote add blablatex https://git.blablatex.com/project/<ID_DEL_PROYECTO>.git
git push blablatex main

Si tu rama local se llama master: 

git remote add blablatex https://git.blablatex.com/project/<ID_DEL_PROYECTO>.git
git push blablatex master

En el primer envío, el proyecto BlaBLaTeX se inicializa a partir del contenido de tu repositorio local.

Buenas prácticas

Flujo de trabajo recomendado (Git ↔ BlaBLaTeX)

Si a veces modificas el proyecto desde la interfaz de BlaBLaTeX, primero recupera los cambios antes de hacer push: 

# Antes de trabajar
git pull

# Modificaciones locales
git add -A
git commit -m "Descripción clara de los cambios"

# Enviar a BlaBLaTeX
git push

Si usas un remote llamado blablatex

Para recuperar explícitamente los cambios desde BlaBLaTeX: 

# Rama local main
git pull blablatex main

# Rama local master
git pull blablatex master

Utiliza los comandos adaptados a la rama que uses localmente.

Lo que puedes hacer

¿Para qué sirve Git para LaTeX en BlaBLaTeX?

Versionar un informe, una tesis o un artículo

Conserva un historial limpio de main.tex, de los capítulos, de las imágenes y de la bibliografía, y vuelve a una versión estable en cualquier momento.

Trabajar con tus herramientas

Editor local, scripts, automatización, CI… manteniendo BlaBLaTeX como fuente de referencia.

Colaborar sin multiplicar copias

El commit se convierte en tu punto de control: mensaje claro, trazabilidad y revisión más sencilla.

Comparar cambios

Comprende rápidamente qué ha cambiado entre dos versiones gracias a git diff y al historial.