Rendi gestibile la distribuzione su Windows (tlmgr è un .bat)

[Francy2009]

Il problema

Su Windows la distribuzione veniva installata correttamente, ma restava inutilizzabile: la pagina Pacchetti diceva "questa distribuzione non è gestibile", htlatex risultava assente e il registro passava da "Distribuzione installata" a "Pronto" senza scaricare un solo pacchetto.

TeX Live su Windows installa tlmgr come tlmgr.bat, mentre il rilevamento cercava solo tlmgr.exe. Non trovandolo, rilevaTeX restituiva tlmgr: null, e in main.js l'installazione dei pacchetti di base sta dentro un if (tex.tlmgr): veniva saltata in silenzio. Da lì tutto il resto, htlatex compreso (arriva con tex4ht, uno dei pacchetti mai installati).

Le correzioni

Rilevamento ed esecuzione (desktop/latex.js)

• I comandi si cercano provando tutti i suffissi eseguibili (.exe, .bat, .cmd, nessuno) invece di assumere .exe.
• Trovarli non basta: spawn/execFile non sanno eseguire uno script .bat, quindi i comandi che lo sono passano per cmd.exe, con la riga citata a mano perché i percorsi possono contenere spazi (C:\Users\Nome Cognome\...).
• Fuori da Windows il comportamento è identico a prima: la lista dei suffissi è [''] e gli argomenti passano invariati.

Sicurezza

• Il passaggio per cmd.exe va fatto con attenzione: cmd non ha modo di rappresentare una virgoletta dentro una stringa citata — raddoppiarla non la rende letterale, chiude e riapre la citazione, e da lì &, | e > tornano metacaratteri attivi. Un argomento che contiene virgolette viene quindi rifiutato, invece di essere citato male.
• cercaPacchetto era l'unica funzione che passava a tlmgr una stringa dell'utente senza validarla (installaPacchetto e rimuoviPacchetto hanno già un'allowlist): ora il termine di ricerca è ripulito tenendo solo i caratteri che compaiono nei nomi dei pacchetti.

Conseguenze visibili

• Se dopo l'installazione tlmgr non c'è, il registro lo dice invece di chiudere con "Pronto" nascondendo una distribuzione a metà.
• La pagina Pacchetti non annuncia più "stai usando il LaTeX di sistema" a chi ha installato la copia gestita da texforge: il messaggio ora distingue le due origini.

Documentazione

• README e sito spiegano che il PDF si compila anche su Overleaf, senza installare niente: .tex + quizstruct.sty nella stessa cartella del progetto, compilatore pdfLaTeX. Il pacchetto usa solo dipendenze standard (amsmath, amssymb, xcolor, enumitem, pgffor), già presenti lì, e quiz.cfg/quiz.js/quiz.css non servono perché riguardano il solo HTML.
• Detto esplicitamente il confine fra i due output: l'HTML interattivo richiede htlatex e si ottiene solo con l'app.
• overleaf.com aggiunto all'allowlist del controllo CI sui domini esterni: senza, il link nuovo avrebbe fatto fallire la build.

Verifica

Fatto:

• costruzione della riga di comando provata simulando Windows e Linux: .bat citato correttamente anche con spazi nel percorso, .exe e piattaforme non-Windows lasciati intatti;
• rifiuto degli argomenti con virgolette e pulizia del termine di ricerca provati sui casi ostili;
• controllo sintattico dei file toccati, struttura HTML del sito validata, controllo CI sui domini eseguito localmente (verde).

Non fatto: nessuna esecuzione su Windows. È il sistema su cui il bug si manifesta e non era disponibile in questo ambiente; la CI del progetto gira solo su ubuntu-latest, quindi non copre questo caso. Prima di taggare una nuova versione conviene installare la build su Windows e controllare che il registro dica "Installo i pacchetti di base…" invece di saltare direttamente a "Pronto".

Suggerimento a margine, fuori dallo scopo di questa PR: un job di CI su windows-latest renderebbe visibile questa classe di problemi senza doverli scoprire dall'app.

---

Generated by Claude Code