Git para LaTeX

Histórico, comparação e restauro: versionar os seus projetos LaTeX no BlaBLaTeX.

O BlaBLaTeX integra Git para LaTeX para gerir o histórico, as versões e a rastreabilidade dos seus projetos. Pode clonar um projeto, trabalhar localmente (editor, scripts), e depois fazer push para ver automaticamente as alterações no workspace.

Voltar atrás

Restaure uma versão estável (commit) sem multiplicar cópias de ficheiros.

Comparar

Identifique diferenças entre duas versões (diff) e valide uma correção.

Rastrear

Histórico claro: quem alterou o quê, quando e porquê (mensagem de commit).

Partilhar

Sincronize de/para o workspace do BlaBLaTeX para revisão e trabalho em equipa.

Passo 1

Encontrar o URL Git do seu projeto BlaBLaTeX

Cada projeto BlaBLaTeX tem um URL Git dedicado, construído a partir do identificador presente no URL do workspace:

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

Se já utiliza Git: retenha clone, pull (idealmente --rebase) e push.

Passo 2

Início rápido: clonar, alterar, enviar

Copie o URL Git do seu projeto (secção anterior) e depois:

# 1) Clonar o projeto
git clone https://git.blablatex.com/project/<ID_DO_PROJETO>.git
cd <pasta_do_projeto>

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

# 3) Alterar e enviar para o BlaBLaTeX
git add -A
git commit -m "Atualização do documento"
git push

Após git push, os ficheiros ficam atualizados automaticamente no seu workspace BlaBLaTeX.

Boas práticas

Fluxo de trabalho recomendado (Git ↔ BlaBLaTeX)

Se por vezes altera o projeto na interface do BlaBLaTeX, recupere primeiro as alterações antes de fazer push:

# Antes de trabalhar
git pull --rebase

# Alterações locais
git add -A
git commit -m "Descrição clara das alterações"

# Enviar para o BlaBLaTeX
git push

Porquê --rebase?

Isto evita muitas vezes um commit de merge desnecessário e reduz erros do tipo “fetch first” ao fazer push.

O que permite fazer

Para que serve Git para LaTeX no BlaBLaTeX?

Versionar um relatório, uma tese, um artigo

Mantenha um histórico limpo do main.tex, capítulos, imagens e bibliografia, e volte a uma versão estável em qualquer momento.

Trabalhar com as suas ferramentas

Editor local, scripts, automatização, CI… mantendo o BlaBLaTeX como fonte de verdade.

Colaborar sem multiplicar cópias

O commit torna-se o seu ponto de controlo: mensagem clara, rastreabilidade e revisão mais simples.

Comparar alterações

Perceba rapidamente o que mudou entre duas versões com git diff e o histórico.