Git for LaTeX

BlaBLaTeX integrates Git for LaTeX to manage the history, versions and traceability of your projects. You can clone a project, work locally (editor, scripts), then push to automatically get your changes back into the workspace. You can also start from an existing local Git repository and connect it to a BlaBLaTeX project.

Find your BlaBLaTeX project Git URL

Each BlaBLaTeX project has a dedicated Git URL built from the identifier 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, just remember clone, pull and push.

Quick start: clone, edit, push

Copy your project Git URL (see above), 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 and push to BlaBLaTeX
git add -A
git commit -m "Document update"
git push

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

Start from an existing local Git repository

If your project is already versioned locally, you can connect it directly to BlaBLaTeX. First create a BlaBLaTeX project, get its identifier, then add the corresponding remote.

If your local branch is named main:

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

If your local branch is named master:

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

On the first push, the BlaBLaTeX project is initialized from the content of your existing local repository.

Recommended workflow (Git ↔ BlaBLaTeX)

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

# Before working
git pull

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

# Send to BlaBLaTeX
git push

If you use a remote named blablatex

To explicitly pull changes from BlaBLaTeX:

# Local main branch
git pull blablatex main

# Local master branch
git pull blablatex master

Use the commands that match the branch you use locally.

What is Git for LaTeX on BlaBLaTeX useful for?