Git para LaTeX

Histórico, comparação e restauração: versione 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 reencontrar automaticamente as suas alterações no workspace. Também pode partir de um repositório Git local já existente e ligá-lo a um projeto BlaBLaTeX.

Ir ao essencial

Encontrar a URL Git · Arranque rápido · Repositório local já existente · Workflow recomendado · Documentação

Voltar atrás

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

Comparar

Identifique as 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 BlaBLaTeX para revisão e trabalho em equipa.

Passo 1

Encontrar a URL Git do seu projeto BlaBLaTeX

Cada projeto BlaBLaTeX possui uma URL Git dedicada construída a partir do identificador presente na 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á sabe utilizar Git: retenha clone, pull e push.

Passo 2

Arranque rápido: clonar, modificar, enviar

Copie a 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) Modificar e enviar para o BlaBLaTeX
git add -A
git commit -m "Atualização do documento"
git push

Depois de git push, os ficheiros são atualizados automaticamente no seu workspace BlaBLaTeX.

Passo 3

Partir de um repositório Git local já existente

Se já tem um projeto versionado localmente, pode ligá-lo diretamente ao BlaBLaTeX. Comece por criar um projeto BlaBLaTeX, recupere o seu identificador e depois adicione o remote correspondente.

Se a sua branch local se chama main: 

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

Se a sua branch local se chama master: 

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

No primeiro envio, o projeto BlaBLaTeX é inicializado a partir do conteúdo do seu repositório local.

Boas práticas

Workflow recomendado (Git ↔ BlaBLaTeX)

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

# Antes de trabalhar
git pull

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

# Enviar para o BlaBLaTeX
git push

Se utiliza um remote chamado blablatex

Para recuperar explicitamente as alterações a partir do BlaBLaTeX: 

# Branch local main
git pull blablatex main

# Branch local master
git pull blablatex master

Utilize os comandos adaptados à branch que usa localmente.

O que pode fazer

Para que serve o Git para LaTeX no BlaBLaTeX?

Versionar um relatório, uma tese ou um artigo

Mantenha um histórico limpo de main.tex, dos capítulos, das imagens e da 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 referência.

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 graças ao git diff e ao histórico.