📘 Setup LaTeX in VS Code + GitHub (Alternativa ad Overleaf)

Questo progetto mostra come scrivere, compilare e tracciare i propri documenti LaTeX usando strumenti open-source, senza dipendere da servizi cloud proprietari (es. Overleaf).

---

🔧 Requisiti

• VS Code 👉 Download
• MiKTeX (distribuzione LaTeX per Windows) 👉 Download
• Strawberry Perl (necessario per latexmk) 👉 Download
• Git 👉 Download
• Account GitHub 👉 Crea un account

---

⚙️ Setup LaTeX su VS Code

1. Installa MiKTeX → durante l’installazione lascia l’opzione Install missing packages on-the-fly.

2. Installa Strawberry Perl → serve a latexmk per funzionare su Windows.

3. Apri il menu Start e cerca MiKTeX Console → da qui puoi aggiornare MiKTeX e installare pacchetti mancanti.

4. Installa l’estensione LaTeX Workshop su VS Code:

   • Apri VS Code
   • Vai su Extensions (Ctrl+Shift+X)
   • Cerca “LaTeX Workshop” e installala

5. Apri un file main.tex e compila con Ctrl+Alt+B → il PDF viene generato nella cartella del progetto.

6. Apri l’anteprima PDF interna con Ctrl+Alt+V.

---

📂 Struttura tipica del progetto

📁 progetto-latex
 ├─ main.tex
 ├─ sections/
 │   ├─ intro.tex
 │   └─ results.tex
 ├─ images/
 │   └─ figure1.png
 ├─ references.bib
 └─ README.md

---

📝 Workflow con GitHub

1. Inizializza Git nel progetto

   git init
   git add .
   git commit -m "Primo commit: setup LaTeX"

2. Crea una nuova repo su GitHub Vai su GitHub → New Repository e segui le istruzioni.

3. Collega la repo locale a GitHub

   git remote add origin https://github.com/USERNAME/progetto-latex.git
   git branch -M main
   git push -u origin main

4. Ogni volta che modifichi i file .tex:

   git add .
   git commit -m "Aggiunta sezione metodologia"
   git push

---

🎯 Vantaggi rispetto a Overleaf

• ✅ Tutto offline → nessun vincolo di connessione o abbonamenti.
• ✅ Open-source: MiKTeX, VS Code e GitHub sono gratuiti.
• ✅ Versionamento: Git/GitHub ti permette di tornare indietro e collaborare come con Overleaf.
• ✅ Personalizzabile: estensioni, workflow e build recipe su misura.