LibreOffice (formati Office)¶
Il pipeline di traduzione Office sceglie il miglior backend disponibile in questo ordine:
- win32com (Windows + MS Office installato) — fedeltà massima
- LibreOffice UNO (multipiattaforma) — ripiego quando win32com non c'è
- python-docx / openpyxl / python-pptx (solo formati moderni) — ripiego pure-Python quando nessuno dei precedenti è disponibile
LibreOffice è l'unica via per .doc / .xls / .ppt legacy
su Linux e macOS, e la via consigliata su quelle piattaforme anche
per i formati Office moderni (migliore fedeltà del backend
pure-Python, specialmente per tabelle e oggetti incorporati).
Installare¶
O scarica da https://www.libreoffice.org/download/download/.
L'app desktop su Windows usa di solito win32com con MS Office installato — LibreOffice è il ripiego se MS Office manca. Installa da https://www.libreoffice.org/download/download/.
Verificare¶
Se ottieni "command not found" su macOS, il binario si trova in
/Applications/LibreOffice.app/Contents/MacOS/soffice. L'app lo
auto-rileva attraverso percorsi di installazione comuni, ma puoi
sovrascrivere in Impostazioni → Generale → Percorso LibreOffice
se necessario.
Cosa alimenta¶
Quando LibreOffice è il backend attivo:
| Caratteristica | Nota |
|---|---|
Office moderno (.docx, .xlsx, .pptx) |
Usato come ripiego quando win32com non è disponibile |
Office legacy (.doc, .xls, .ppt) |
Richiesto — Python puro non può leggerli |
ODF (.odt, .ods, .odp) |
Usato per la conversione round-trip quando Conversione automatica ODF è attiva |
| Conversione automatica legacy / ODF → OOXML | Richiesto |
Processo in background¶
La prima volta che è necessario LibreOffice, l'app lancia un processo
soffice in modalità headless e lo mantiene vivo attraverso le
traduzioni (office_lifecycle.py). Si spegne automaticamente
all'uscita dell'app.
Avvertenze¶
Tempo di avvio al primo lancio
La prima traduzione che tocca LibreOffice attende ~5-10 secondi
per l'avvio di soffice. Le traduzioni successive riusano lo
stesso processo e sono veloci.
Log di crash JVM
Il componente Java di LibreOffice produce occasionalmente file
hs_err_pid*.log quando va in segfault. L'app li indirizza in
una directory temporanea in modo che non inquinino la tua
cartella di progetto.
Conversione automatica legacy / ODF
Abilita Impostazioni → Traduzione → Conversione automatica
legacy se traduci regolarmente .doc / .xls / .ppt. Il
pipeline li converte prima in .docx / .xlsx / .pptx
(tramite convert_to_modern_format), traduce la copia moderna,
poi riconverte. La fedeltà è molto più alta che tradurre il
formato legacy direttamente.