LuaBill · Documentazione LuaBill

Installare e aggiornare LuaBill

L’editor e gli strumenti di generazione svolgono compiti diversi. Il pacchetto LuaBill resta compatto e la procedura guidata prepara i componenti esterni.

Windows: un installatore con Python e Qt

Esegui LuaBill-Setup-0.1.31-win64.exe su Windows 10 versione 1809 o successiva, oppure Windows 11, x64. L’installazione riguarda il tuo account utente e include Python, PySide6/Qt e Mustang.

Scegli se creare il collegamento sul desktop e associare i file .luabill. Al termine puoi aprire la procedura guidata per preparare i componenti di generazione; resta disponibile anche dal menu Aiuto.

Scarica l’installatore Windows →

Linux e macOS: installazione dai sorgenti

Prepara Python 3.10–3.15 con venv e pip. Estrai l’intero archivio ed esegui il comando per il tuo sistema. L’installazione richiede Internet per scaricare PySide6/Qt 6.12.0 nell’ambiente privato di LuaBill.

Il pacchetto Linux richiede un desktop glibc: x86-64 con glibc 2.34+ oppure ARM64 con glibc 2.39+. Il pacchetto macOS richiede macOS 14.4 o successivo su Intel o Apple Silicon. Il lancio nativo su entrambi i sistemi resta da verificare in un ambiente dedicato.

Linux: l’installazione registra una voce nel menu delle applicazioni e l’apertura dei file .luabill.
macOS: viene creato il programma di avvio locale ~/Applications/LuaBill.app; i file si trovano in ~/Library/Application Support/LuaBill.
Il Python di sistema resta invariato. L’avvio normale del programma non scarica Qt.

sh install.sh --setup-components --language it

sh Install_LuaBill.command --setup-components --language it

Prepara gli strumenti necessari ai tuoi documenti

Per il PDF servono LuaLaTeX, texlua, i pacchetti del modello e font adatti. XML e XRechnung richiedono anche Java 17 o successivo per Mustang. ZUGFeRD usa inoltre Ghostscript per preparare il PDF/A-3.

La procedura guidata mostra il piano prima delle operazioni. In Linux/macOS, le azioni del gestore dei pacchetti possono aprire un Terminale. LuaBill non impone una distribuzione TeX completa e non installa Homebrew automaticamente.

Dopo una modifica del PATH, riavvia LuaBill.
Trovare un eseguibile non garantisce che pacchetti TeX e font siano pronti: termina con una vera generazione di prova.
I collegamenti ufficiali e il rapporto degli strumenti sono in Aiuto → Componenti e installazione.

Risolvi un problema dei componenti →

Aggiornare un’installazione esistente

Chiudi LuaBill e installa la nuova versione nella stessa cartella. Di norma non occorre disinstallare prima. Se usi una posizione Linux/macOS personalizzata, riutilizza lo stesso --prefix.

Progetti, risultati e impostazioni nelle cartelle personali restano conservati. Salva a parte le modifiche manuali ai file del programma: un conflitto può interrompere l’aggiornamento. Consulta le note di versione e prova il formato che usi abitualmente.

Consulta le novità →

← Torna alla documentazione

Gli strumenti dietro i tuoi documenti

Scegli le funzionalità necessarie. Aiuto → Preparare la creazione dei documenti mostra un piano, prepara i componenti dopo il tuo clic e verifica realmente la generazione del profilo scelto.

LuaLaTeX + texlua

Necessari per generare i documenti

LuaLaTeX e texlua provengono da una distribuzione TeX. In Windows, la procedura può preparare Basic MiKTeX e i 19 pacchetti diretti del modello, le loro dipendenze e i dati EN/DE/FR/IT/RU. Un’installazione compatibile già presente viene riutilizzata. Il messaggio di versione LuaHBTeX è normale: usa sempre il comando lualatex.

MiKTeX ↗TeX Live ↗MacTeX ↗

Ghostscript

Necessario per ZUGFeRD; facoltativo per il PDF ordinario

Ghostscript prepara il PDF/A-3 di ZUGFeRD e può comprimere i PDF ordinari. La procedura lo prepara solo per un profilo che ne ha bisogno, usando l’installatore ufficiale Windows o il gestore di pacchetti supportato.

Download ufficiali ↗

Java 17+

Necessario per XML, XRechnung e ZUGFeRD

Java 17+ esegue Mustang per la validazione XML e ZUGFeRD. In Windows viene proposta una JRE Temurin 21; su macOS il pacchetto Homebrew temurin@21 contiene un JDK. Una versione compatibile già presente viene riutilizzata. Mustang è incluso; il PDF ordinario non richiede Java.

Eclipse Temurin ↗

Python + PySide6/Qt

Inclusi su Windows; da predisporre su Linux/macOS

Python esegue l'applicazione e PySide6/Qt fornisce finestre e menu. Gli installatori Linux/macOS creano un ambiente isolato usando un Python compatibile già installato e scaricano PySide6 durante l'installazione.

Scarica Python ↗

Noto Sans + Noto Sans Mono

Font privati per tutte le lingue

La procedura può scaricare un insieme fissato di font Noto con la relativa licenza e verificarne lo SHA-256. LuaBill li carica direttamente dai propri file privati, senza registrarli nel sistema operativo. Il test verifica caratteri latini e cirillici, simboli monetari e formule.

Font Noto ↗

Aprire la procedura avvia il rilevamento; download e installazioni iniziano con Prepara i componenti selezionati. Possono servire finestre di installazione o una password di amministratore. Verificare la creazione dei documenti compila un esempio senza installare pacchetti. Il primo download dei componenti si aggiunge al pacchetto compatto di LuaBill.

Prepara la creazione dei documenti con una procedura guidata

LuaBill 0.1.27 ti accompagna dalla scelta dei formati a un PDF di controllo. Il pacchetto resta compatto: i componenti esterni necessari vengono scaricati durante la preparazione.

Apri la procedura guidata
Lascia selezionata la sua apertura al termine dell’installazione Windows oppure scegli Aiuto → Preparare la creazione dei documenti. In Linux/macOS, --setup-components può aprirla dopo l’installazione.
Scegli i formati e controlla il piano
Seleziona PDF, PDF + XML/XRechnung o ZUGFeRD. Gli strumenti compatibili già presenti vengono riutilizzati; il piano mostra le operazioni proposte prima del loro avvio.
Prepara i componenti selezionati
Fai clic su Prepara i componenti selezionati. In Windows la procedura può scaricare Basic MiKTeX, la JRE Temurin 21 e Ghostscript, quindi preparare i pacchetti TeX e i font Noto privati. I download vengono verificati e il registro resta visibile.
Controlla il documento di prova
Il test compila due volte pacchetti, lingue e font, poi crea un documento fittizio con il profilo scelto. Apri il PDF o Dettagli e registro. L’annullamento conserva i download verificati; un’operazione di installazione già avviata deve prima terminare.

Prepara la creazione dei documenti con una procedura guidata — LuaBill 0.1.31 · Documento di esempio

PDF

LuaLaTeX, texlua, pacchetti del modello e font. Java non serve; Ghostscript resta facoltativo per la compressione.

PDF + XML / XRechnung

Gli stessi componenti, più Java 17+ per la validazione esterna Mustang. In Windows una nuova installazione utilizza una JRE Temurin 21.

ZUGFeRD

Gli stessi componenti elettronici, più Ghostscript per preparare il PDF/A-3 prima di incorporare l’XML e validare il contenitore.

Linux e macOS restano installazioni da sorgenti con un ambiente Python privato. Ubuntu/Debian usa apt; un’installazione TUG TeX Live separata usa il proprio tlmgr. Su macOS, Homebrew già installato può fornire BasicTeX e gli strumenti mancanti; Homebrew non viene installato automaticamente. I percorsi nativi Linux/macOS e l’installazione completa delle dipendenze su un PC pulito restano da verificare.

Scarica il test LuaLaTeX autonomo (ZIP) ↓

Il test si può inviare senza LuaBill: carica i 19 pacchetti diretti del modello e verifica le cinque lingue, caratteri, formule, tabelle e icone. L’archivio contiene istruzioni DE/EN/RU e un PDF di riferimento. MiKTeX può scaricare i pacchetti mancanti se la funzione è abilitata; i font di sistema non vengono installati automaticamente. Somme di controllo SHA-256

Aggiornare, verificare e disinstallare

LuaBill 0.1.31 aggiunge regole di verifica aggiornate, un riepilogo delle versioni e una ricerca facoltativa degli aggiornamenti. Installa la nuova versione nella stessa cartella e verifica il profilo che ti serve.

Installare la nuova versione

Chiudi LuaBill e installa la nuova versione sopra quella esistente. Non occorre disinstallare prima.

In Windows mantieni la cartella proposta per l’installazione esistente.
In Linux/macOS riutilizza lo stesso --prefix per una cartella personalizzata.
Progetti, risultati e impostazioni nelle cartelle personali restano conservati.
Dopo l’aggiornamento, apri Aiuto → Standard di fatturazione elettronica e aggiornamenti per vedere le regole attive e, se lo desideri, consultare le pubblicazioni ufficiali.

Linuxsh install.sh

macOSsh Install_LuaBill.command

Salva a parte le modifiche manuali ai file del programma. In Linux/macOS un conflitto interrompe l’aggiornamento. Evita di installare una versione precedente sopra una più recente.

Preparare e verificare i componenti

Il rapporto elenca gli strumenti trovati; Aiuto → Preparare la creazione dei documenti completa il rilevamento con preparazione guidata e una vera prova di generazione.

Scegli PDF, PDF + XML/XRechnung o ZUGFeRD; gli strumenti compatibili già installati vengono riutilizzati.
Fai clic su Prepara i componenti selezionati per i download, i pacchetti TeX e i font Noto privati.
Il test compila due volte il file LaTeX multilingue, poi crea un esempio fittizio con il percorso del profilo. PDF e registro restano disponibili.

Linuxsh install.sh --setup-components --language it

macOSsh Install_LuaBill.command --setup-components --language it

Gli strumenti mancanti non annullano l’installazione dell’editor. La generazione dei tre profili è stata verificata in Windows con i componenti presenti; installazioni native Linux/macOS e preparazione completa su un PC pulito restano da provare.

Rimuovere i file del programma

Il programma di disinstallazione di un nuovo archivio può rimuovere una vecchia installazione senza reinstallarla.

Chiudi LuaBill e indica lo stesso --prefix per un’installazione personalizzata.
Documenti, impostazioni e file modificati o sconosciuti vengono conservati.
Leggi gli avvisi e l’elenco dei file rimasti.

Linuxsh uninstall.sh

macOSsh Uninstall_LuaBill.command

Anche il piccolo archivio separato rimuove le installazioni esistenti. Restano gli strumenti di sistema TeX, Java e Ghostscript e la cartella scaricata.

Programma di disinstallazione separato per Linux/macOS ↓ ZIP · 23 KB

Somme di controllo SHA-256

Guida utente ↗