SXXXXXXX_BackupTools/doc/Italian-manual.md
2025-05-07 14:39:49 +02:00

109 lines
7.3 KiB
Markdown

# Backup Manager Pro - Manuale Italiano
## 1. Introduzione
Benvenuto in Backup Manager Pro! Questa applicazione ti aiuta a creare archivi di backup compressi (file ZIP) delle tue cartelle importanti, con opzioni flessibili per escludere file e gestire diversi profili di backup.
## 2. Panoramica dell'Interfaccia Principale
La finestra principale di Backup Manager Pro è suddivisa in diverse sezioni:
* **Gestione Profili:** Carica, salva ed elimina profili di backup. Un profilo memorizza una configurazione specifica (sorgente, destinazione, esclusioni, descrizione).
* **Cartella Sorgente:** La cartella di cui vuoi effettuare il backup.
* **Cartella Destinazione:** La cartella in cui verrà salvato il file ZIP di backup.
* **Esclusioni File:** Un elenco di pattern separati da virgola per escludere file dal backup.
* **Descrizione Backup:** Una descrizione opzionale che verrà salvata all'interno dell'archivio di backup.
* **Pulsante Azione:** "Analizza e Crea Backup" avvia il processo.
* **Barra di Progresso e Stato:** Mostra l'avanzamento delle operazioni di scansione e backup.
## 3. Iniziare: Il Tuo Primo Backup
1. **Avvia Backup Manager Pro.**
2. **Seleziona Cartella Sorgente:**
* Clicca il pulsante "Sfoglia..." accanto a "Cartella Sorgente".
* Naviga e seleziona la cartella di cui desideri eseguire il backup.
* Esempio: `C:\Utenti\TuoNome\Documenti\Progetti`
3. **Seleziona Cartella Destinazione:**
* Clicca il pulsante "Sfoglia..." accanto a "Cartella Destinazione".
* Scegli una cartella in cui verrà creato il file ZIP di backup.
* Esempio: `D:\Backup`
4. **Configura Esclusioni File (Opzionale):**
* Nell'area di testo "Esclusioni File", inserisci i pattern per i file o i tipi di file che vuoi escludere, separati da virgole.
* Il testo andrà a capo automaticamente se è lungo.
* Esempi:
* Per escludere tutti i file di log e i file temporanei: `.log, .tmp, *.bak`
* Per escludere una cartella specifica chiamata `build` all'interno della sorgente: `build/` (usa barre oblique per i percorsi)
* Per escludere tutti i file che iniziano con `temp_`: `temp_*`
* Dopo aver digitato le tue esclusioni, clicca il pulsante **"Aggiorna Lista Esclusioni"** per elaborarle e applicarle. Questo riformatterà anche la visualizzazione nell'area di testo.
5. **Aggiungi una Descrizione del Backup (Opzionale):**
* Digita una breve descrizione nell'area di testo "Descrizione Backup" (es., "Backup settimanale dei file ProgettoMio"). Questo aiuta a identificare il backup in seguito.
6. **Avvia il Processo di Backup:**
* Clicca il pulsante **"Analizza e Crea Backup"**.
* L'applicazione eseguirà prima una scansione della cartella sorgente per determinare quali file includere ed escludere. L'avanzamento sarà visualizzato.
7. **Conferma Backup:**
* Apparirà una finestra di conferma che mostra il numero di file e la dimensione totale del backup.
* Puoi cliccare su:
* **"Dettagli Lista File"**: Per vedere un elenco dettagliato di tutti i file inclusi ed esclusi.
* **"Stat. Est. Incluse"**: Per vedere statistiche (conteggio e dimensione) dei file inclusi, raggruppati per estensione.
* **"Stat. Est. Escluse"**: Per vedere statistiche dei file esclusi, raggruppati per estensione.
* **"Procedi con Backup"**: Per iniziare a creare l'archivio ZIP.
* **"Annulla"**: Per interrompere il backup.
8. **Creazione del Backup:**
* Se procedi, l'applicazione creerà il file ZIP nella cartella di destinazione. La barra di progresso mostrerà il processo di compressione.
* Il file ZIP sarà nominato con una marca temporale e il nome della cartella sorgente (es., `20240507_153000_Progetti.zip`).
9. **Completamento:**
* Un messaggio ti informerà se il backup è stato completato con successo o se si sono verificati errori.
## 4. Utilizzo dei Profili
I profili ti consentono di salvare e ricaricare rapidamente diverse configurazioni di backup.
### 4.1. Salvare un Profilo
1. Configura la Cartella Sorgente, la Cartella Destinazione, le Esclusioni e la Descrizione come desiderato.
2. Assicurati che le tue esclusioni siano aggiornate cliccando "Aggiorna Lista Esclusioni" se hai apportato modifiche nell'area di testo.
3. Clicca il pulsante **"Salva Corrente come Profilo"**.
4. Una finestra di dialogo chiederà un nome per il profilo.
* Se hai un profilo già selezionato nel menu a tendina "Profilo Attivo", il suo nome verrà suggerito. Puoi usarlo per aggiornare il profilo esistente o digitare un nuovo nome.
* Inserisci un nome univoco (es., "Backup_Documenti_Lavoro").
5. Clicca "OK".
* Se il nome esiste già (ed è diverso da un profilo attualmente selezionato che stai aggiornando), ti verrà chiesto di confermare la sovrascrittura.
* Il profilo verrà salvato e diventerà il profilo attivo nel menu a tendina.
### 4.2. Caricare un Profilo
1. Clicca il menu a tendina "Profilo Attivo".
2. Seleziona il nome del profilo desiderato dalla lista.
3. I campi Sorgente, Destinazione, Esclusioni e Descrizione si popoleranno automaticamente con le impostazioni del profilo selezionato.
### 4.3. Eliminare un Profilo
1. Seleziona il profilo che desideri eliminare dal menu a tendina "Profilo Attivo".
2. Clicca il pulsante **"Elimina Profilo Selezionato"**.
3. Conferma l'eliminazione quando richiesto.
* Il profilo verrà rimosso dalla lista. I campi dell'interfaccia utente verranno tipicamente reimpostati ai valori predefiniti globali o svuotati.
## 5. Gestione delle Esclusioni File
* **Formato Input:** Inserisci i pattern di esclusione nell'area di testo, separati da virgole (es., `.obj, *.tmp, node_modules/`).
* **Aggiornamento della Lista:** Dopo aver digitato o modificato i pattern nell'area di testo, **devi** cliccare il pulsante **"Aggiorna Lista Esclusioni"**. Questa azione:
1. Analizza il tuo input.
2. Rimuove eventuali pattern vuoti derivanti da virgole o spazi extra.
3. Rimuove i pattern duplicati.
4. Ordina i pattern alfabeticamente.
5. Aggiorna la lista interna delle esclusioni che verrà utilizzata per il backup.
6. Ricarica l'area di testo per mostrare la lista pulita e formattata (usando ", " come separatore).
* **Esempi di Pattern:**
* `.exe`: Esclude tutti i file con estensione `.exe`.
* `*.log`: Esclude tutti i file che terminano con `.log`.
* `temp/`: Esclude qualsiasi cartella chiamata `temp` e il suo contenuto a qualsiasi livello all'interno della sorgente. (Nota: assicurati che la logica di scansione gestisca correttamente i pattern di directory).
* `output_*.dat`: Esclude file come `output_01.dat`, `output_final.dat`.
## 6. Note
* La configurazione dell'applicazione, inclusi i profili e le ultime impostazioni utilizzate, viene salvata in un file `backup_config.json` situato nella stessa directory dell'eseguibile dell'applicazione (o nella directory principale dello script se eseguito dal codice sorgente).
* Le operazioni lunghe come la scansione dei file e la compressione ZIP vengono eseguite in background per mantenere reattiva l'applicazione. Attendi il loro completamento.
* Se la cartella di destinazione per il backup non esiste, l'applicazione tenterà di crearla.
Grazie per aver utilizzato Backup Manager Pro!