Git for LaTeX

BlaBLaTeX includes Git for LaTeX to manage history, versions and traceability for your projects. You can clone a project, work locally (editor, scripts), then push to see your changes automatically appear in the workspace.

Find the Git URL for your BlaBLaTeX project

Each BlaBLaTeX project has a dedicated Git URL built from the project ID found in the workspace URL:

• Workspace: https://workspace.blablatex.com/project/<PROJECT_ID>
• Git: https://git.blablatex.com/project/<PROJECT_ID>.git

Workspace: https://workspace.blablatex.com/project/6940036c696502c3fc2d49dc
Git      : https://git.blablatex.com/project/6940036c696502c3fc2d49dc.git

If you already know Git: remember clone, pull (ideally --rebase) and push.

Quick start: clone, edit, push

Copy the Git URL for your project (previous section), then:

# 1) Clone the project
git clone https://git.blablatex.com/project/<PROJECT_ID>.git
cd <project_folder>

# 2) Check status
git status
git log --oneline -n 10

# 3) Edit, then push to BlaBLaTeX
git add -A
git commit -m "Update document"
git push

After git push, files are automatically updated in your BlaBLaTeX workspace.

Recommended workflow (Git ↔ BlaBLaTeX)

If you sometimes edit the project in the BlaBLaTeX interface, pull changes first before pushing:

# Before you start working
git pull --rebase

# Local changes
git add -A
git commit -m "Clear description of changes"

# Push to BlaBLaTeX
git push

Why --rebase?

It often avoids an unnecessary merge commit and reduces “fetch first” errors when pushing.

What is Git for LaTeX on BlaBLaTeX useful for?