Belajar LaTeX - Version Control dengan Git & Kolaborasi

#Pendahuluan

Setelah di episode 16 kita membuat makro dinamis, pada episode ini kita membawa proyek LaTeX ke ranah kolaborasi dan pengelolaan versi dengan Git. Ini salah satu keunggulan terbesar LaTeX dibanding editor WYSIWYG: source-nya teks murni, sehingga version control berjalan mulus.

Mengapa penting? Skripsi/tesis/paper jarang dikerjakan sendirian, dan bahkan dokumen pribadi pun butuh riwayat revisi. Dengan Git, kalian bisa melacak setiap perubahan, membatalkan kesalahan, berkolaborasi via pull request, dan mengotomatiskan kompilasi di CI. Ini alur kerja profesional yang membedakan penulis LaTeX amatir dari yang pro.

#Kenapa Git untuk LaTeX

File .tex adalah teks biasa — persis yang paling disukai Git untuk menghasilkan diff yang bersih dan terbaca:

text

- Kata yang salah eja.
+ Kata yang benar eja.

Berbeda dari file .docx (binary) yang diff-nya tidak terbaca, perbedaan di .tex langsung terlihat baris per baris. Ini membuat review dan rollback akurat. Yang bisa di-versi-kan:

.tex, .bib, .cls, .sty — semua teks.
Folder figures/ — gambar (vektor/raster).
Konfigurasi dan script (episode 18).

Yang sebaiknya tidak di-versi-kan (artefak build):

.gitignore

*.aux
*.log
*.toc
*.out
*.bbl
*.blg
*.synctex.gz
*.pdf

File .pdf (hasil) umumnya di-.gitignore karena bisa di-generate ulang — menyimpannya hanya menambah beban repositori tanpa nilai (kecuali untuk rilis tertentu).

#Setup GitHub + GitHub Actions

Tempatkan proyek di GitHub untuk kolaborasi + CI otomatis. Alur dasarnya:

Init & push ke GitHub

git init
git add .
git commit -m "feat: kerangka tesis"
git remote add origin <url-repo>
git push -u origin main

Untuk kompilasi otomatis per commit/PR, gunakan GitHub Actions dengan action latex-action (mis. xu-cheng/latex-action):

.github/workflows/compile.yml

name: Compile LaTeX
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: xu-cheng/latex-action@v3
        with:
          root_file: main.tex
          compiler: lualatex
          args: -interaction=nonstopmode -file-line-error
      - uses: actions/upload-artifact@v4
        with:
          name: paper-pdf
          path: main.pdf

Setiap push/PR akan mengompilasi main.tex dengan lualatex dan meng-upload main.pdf sebagai artifact — bisa diunduh/inspect di tab Actions. Ini memastikan dokumen selalu ter-build dengan benar di lingkungan standar.

Tip

-interaction=nonstopmode membuat kompilasi tidak berhenti minta input saat error, dan -file-line-error menghasilkan format error file:line: yang mudah diurai CI. Kombinasi ini penting untuk kompilasi noninteractive di Actions.

#Overleaf Git Integration

Overleaf menyediakan integrasi Git — proyek bisa di-sync dengan repo lokal/GitHub (fitur di paket berbayar). Alur hibrida:

Buat proyek di Overleaf untuk kolaborasi realtime dengan tim non-teknis.
Sinkronkan repo git lokal ke Overleaf.
Editor teknis memakai lokal (VS Code/TeXstudio), editor lain memakai Overleaf.

Ini menggabungkan kecepatan kolaborasi Overleaf dengan kontrol Git/lokal. Detail Overleaf vs local dibahas lengkap di episode 25.

#Tips Repository

Beberapa praktik baik untuk repositori LaTeX:

Pesan commit jelas berbasis konvensional (mis. feat: tambahkan bab metode) — memudahkan navigasi riwayat.
Pisahkan per-bab dengan \input/\includeonly (episode 12) agar diff per-bab terisolasi dan review lebih fokus.
Jangan commit artefak (.aux, .log, .toc, .pdf) — pakai .gitignore.
Simpan gambar/aset di folder figures/ agar struktur bersih.
Komit sering — perubahan kecil yang rutin lebih mudah dikelola daripada perubahan raksasa.

#Branch Strategy

Untuk fokus review dan menghindari konflik pada dokumen bersama, gunakan branch:

main — dokumen siap submit (skripsi final, paper rilis).
wip/<bab> — cabang kerja per bab (mis. wip/bab3-metode).
Review lewat Pull Request — diskusi per baris, lalu merge ke main.

text

main ──────────────────── (siap submit)
        \ wip/bab3 ──

Dengan PR, kolaborator bisa memberi komentar pada baris tertentu (mis. "kutipan ini butuh referensi"), dan perubahan hanya masuk main setelah disetujui. Ini standar kerja tim modern.

Warning

Konflik merge mungkin terjadi saat beberapa orang mengedit baris yang sama (mis. preamble). Solusi: pisahkan baris per-tugas (bundling class/package per bagian), komit sering, dan jaga main selalu dalam keadaan compile-clean agar kembali dengannya tidak menyakitkan.

#Penutup

Pada episode 17 ini, kalian telah membawa LaTeX ke Git.

Inti yang harus dibawa pulang:

.tex teks = diff bersih, review & rollback akurat; .gitignore artefak (.aux/.log/.pdf).
GitHub + Actions (latex-action) mengompilasi per PR & upload PDF artifact.
Overleaf Git integration memungkinkan alur hibrida Overleaf ↔ lokal.
Tips: pesan commit jelas, pisah per-bab, hindari artefak besar.
Branch strategy: main siap submit + wip/<bab>, review via PR.

Di episode 18 selanjutnya, kita akan membahas otomatisasi compile: latexmk, Makefile & CI — latexmk sebagai standar build, lateksmkrc, Makefile untuk target draft/final, serta pipeline GitHub Actions dengan lint sebagai gate check. Sampai jumpa di episode 18!