KAP — Italiano per il lavoro

Guida al deployment

Come organizzare e distribuire i file del corso KAP: offline su cartella locale, online su server o servizi gratuiti, e su Google Drive.

💾 Offline: cartella + browser ☁️ Online: GitHub Pages, Netlify 📁 Google Drive: condivisione

Indice

Struttura e inventario dei file
Uso offline (cartella locale)
Uso online — opzioni a confronto
GitHub Pages (gratuito, raccomandato)
Netlify Drop (più semplice)
Google Drive (condivisione file)
Server web locale (LAN scolastica)
Compatibilità browser e dispositivi
Problemi comuni e soluzioni

📂

1. Struttura e inventario dei file

Il corso KAP è composto interamente da file HTML autonomi. Non richiede un database, un server applicativo o una connessione a internet (salvo per i font Google Fonts, caricabili anche in locale).

📁 KAP-Italiano/ ← cartella principale │ ├── index.html ← pagina di avvio ├── kap_home.html ← home/indice del corso ├── kap_test_ingresso.html ← test di livello │ ├── kap_modulo_1.html ← M1: Mi presento ├── kap_modulo_2.html ← M2: Cercare lavoro e CV ├── kap_modulo_3.html ← M3: Il colloquio ├── kap_modulo_4.html ← M4: Vita in azienda ├── kap_modulo_5.html ← M5: La salute ├── kap_modulo_6.html ← M6: Casa e affitto ├── kap_modulo_7.html ← M7: Autorità e permesso ├── kap_modulo_8.html ← M8: Fare acquisti ├── kap_modulo_9.html ← M9: Trasporti ├── kap_modulo_10.html ← M10: Scuola e formazione ├── kap_modulo_11.html ← M11: Tempo libero ├── kap_modulo_12.html ← M12: Diritti e doveri │ ├── Modulo_B1_1_Attivita_interattive.html ← Avanzato B1.1 ├── Modulo_B1_2_Attivita_interattive.html ← Avanzato B1.2 ├── Modulo_B2_1_Attivita_interattive.html ← Avanzato B2.1 ├── Modulo_B2_2_Attivita_interattive.html ← Avanzato B2.2 ├── kap_sicurezza.html ← Modulo sicurezza D.Lgs 81/08 │ ├── kap_prova_a1.html ← Prova d'esame A1 ├── kap_prova_a2.html ← Prova d'esame A2 ├── kap_prova_b1.html ← Prova d'esame B1 ├── kap_prova_b2.html ← Prova d'esame B2 │ ├── kap_guida_docenti.html ← questa guida ├── kap_guida_deployment.html ← guida deployment │ ├── kap_staff.html ← hub area staff ├── kap_certificato.html ← generatore certificati ├── kap_registro_presenze.html ← registro presenze ├── kap_schema_certificati.html ← schema/dossier AKPA │ └── KAP_Specifica_Esame.docx ← specifica d'esame

Regola fondamentale: tutti i file HTML devono trovarsi nella stessa cartella. I link tra i file (es. "← Torna all'indice") usano percorsi relativi senza sottocartelle.

Dimensioni indicative

File HTML moduli: ~60–70 KB ciascuno (tutto in-file, nessuna risorsa esterna)
File HTML prove: ~43 KB ciascuno
Totale cartella: ~1 MB (senza font Google)
Con font locali (opzionale): +500 KB

💾

2. Uso offline (cartella locale)

La modalità più semplice: scaricare tutti i file in una cartella sul computer o su una chiavetta USB e aprirli direttamente nel browser.

Scarica i file: salva tutti i file .html e il .docx nella stessa cartella. Esempio: C:\KAP-Italiano\ su Windows o /Documenti/KAP-Italiano/ su Mac.

Apri la home: doppio clic su kap_home.html per aprire il file nel browser predefinito. Oppure trascinare il file sul browser.

Naviga: dalla home si accede a tutti i moduli, prove e test tramite i link. Il browser gestisce la navigazione tra file nella stessa cartella.

TTS offline: il Text-to-Speech funziona senza connessione se le voci italiane sono installate nel sistema operativo. Su Windows: Impostazioni → Accessibilità → Sintesi vocale → Aggiungi voci → Italiano. Su Mac: Preferenze di Sistema → Accessibilità → Parlato vocale → aggiungere voce italiana.

Attenzione — Chrome offline: Chrome può bloccare alcune funzionalità JavaScript quando i file sono aperti con file://. Se si notano problemi, usare Firefox che ha meno restrizioni per i file locali. In alternativa, usare un server locale (vedi Sezione 7).

Chiavetta USB (per classi senza internet)

Copiare l'intera cartella su una chiavetta USB. Ogni studente inserisce la propria chiavetta e apre kap_home.html. Il progresso viene salvato in localStorage del browser del computer usato, non nella chiavetta.

Font offline: i file KAP usano Verdana come font di sistema — nessun download necessario, funziona completamente offline su tutti i dispositivi Windows, Mac, iOS e Android.

☁️

3. Uso online — opzioni a confronto

🐙

GitHub Pages

Hosting gratuito e permanente da un repository GitHub. URL tipo utente.github.io/kap.

Gratuito

Richiede GitHub

⬆️

Netlify Drop

Trascina la cartella sul sito Netlify → URL pubblico in 10 secondi. Nessun account necessario.

Gratuito

Semplicissimo

📁

Google Drive

Carica la cartella e condividi i link. Non è un hosting vero, ma i file HTML si aprono nel browser.

Gratuito

Funzioni limitate

🖥️

Server LAN locale

Python o Node.js sulla LAN della scuola. Tutti i PC della rete accedono senza internet.

Gratuito

Richiede PC server

🐙

4. GitHub Pages (raccomandato)

GitHub Pages è la soluzione più robusta per un hosting gratuito e permanente. Una volta configurato, l'URL non cambia mai.

Crea account GitHub: andare su github.com e creare un account gratuito (es. username: kap-formazione).

Crea repository: cliccare su "New repository". Nome suggerito: kap-italiano. Spuntare "Public". Cliccare "Create repository".

Carica i file: nella pagina del repository cliccare "uploading an existing file". Trascinare tutti i file HTML e il docx. Cliccare "Commit changes".

Attiva Pages: andare su Settings → Pages. In "Source" selezionare main branch, cartella / (root). Cliccare "Save".

URL del corso: dopo ~2 minuti il corso sarà accessibile a: https://kap-formazione.github.io/kap-italiano/kap_home.html

# Aggiornare i file in futuro: # 1. Vai sul repository su github.com # 2. Clicca sul file da aggiornare # 3. Clicca sull'icona matita (edit) # 4. Incolla il nuovo contenuto # 5. Clicca "Commit changes" # In alternativa, usare GitHub Desktop (app grafica)

Vantaggi GitHub Pages: HTTPS automatico, CDN globale, nessuna scadenza, URL stabile. Ideale da comunicare agli studenti via WhatsApp o email.

⬆️

5. Netlify Drop (il più veloce)

Il modo più rapido per pubblicare online: nessun account necessario, bastano 10 secondi.

Vai su: app.netlify.com/drop

Trascina la cartella KAP-Italiano nella zona di drop della pagina web.

Ottieni l'URL in pochi secondi, tipo: https://amazing-rabbit-123456.netlify.app/kap_home.html

URL personalizzato (opzionale): creare un account gratuito Netlify per avere un URL personalizzato tipo kap-italiano.netlify.app.

Limite senza account: il sito Netlify Drop senza account scade dopo un giorno. Creare un account gratuito per rendere il sito permanente.

📁

6. Google Drive (condivisione file)

Google Drive non è un hosting web, ma permette di condividere i file HTML come link. I file si aprono nel browser tramite Google Drive Viewer.

Crea una cartella "KAP-Italiano" su Google Drive.

Carica tutti i file HTML (e il docx) nella cartella.

Condividi la cartella: tasto destro → Condividi → "Chiunque abbia il link può visualizzare".

Apri ogni file HTML: doppio clic sul file → si apre Google Drive Viewer → cliccare "Apri con Google Chrome" o "Scarica" per aprirlo nel browser.

Soluzione migliore con Drive: usare Google Sites (gratuito) come "portale" che linka i file Drive. Creare una pagina Sites con il titolo del corso e aggiungere link ai singoli file HTML su Drive.

Limitazione importante: su Google Drive i file HTML non vengono eseguiti come pagine web complete — il JavaScript potrebbe non funzionare. Per questa ragione, GitHub Pages o Netlify sono preferibili per l'uso online. Drive è ottimo solo per distribuire i file da scaricare.

🖥️

7. Server web locale (LAN scolastica)

Soluzione ideale per laboratori scolastici o centri di formazione con LAN interna: un solo PC fa da server, tutti gli altri accedono tramite browser senza internet.

Opzione A — Python (2 comandi)

# Sul PC server (con Python 3 installato): cd C:\KAP-Italiano # vai nella cartella python -m http.server 8080 # avvia il server # Sul PC server, aprire nel browser: # http://localhost:8080/kap_home.html # Dagli altri PC della LAN: # http://192.168.1.X:8080/kap_home.html # (sostituire X con l'IP del PC server)

Opzione B — Node.js (serve-static)

# Installa una volta sola: npm install -g serve # Avvia il server: serve C:\KAP-Italiano -p 8080

Come trovare l'indirizzo IP del server

# Windows: ipconfig # cercare "Indirizzo IPv4" # Mac/Linux: ifconfig # cercare "inet 192.168.X.X"

Vantaggio: con un server locale tutti i PC della classe accedono alla stessa versione del corso contemporaneamente. Il TTS funziona con le voci installate su ciascun PC client.

🧪

8. Compatibilità browser e dispositivi

Browser	TTS Audio	Layout	Offline	Note
Chrome 90+	✓ Ottimo	✓	⚠ file://	Raccomandato. Voci italiane sempre disponibili.
Firefox 88+	⚠ Variabile	✓	✓ Offline	Migliore per file locali. TTS dipende dal sistema.
Edge 90+	✓ Ottimo	✓	⚠ file://	Come Chrome. Voci Microsoft incluse.
Safari macOS	✓ Buono	✓	✓	Voce italiana di sistema ottima.
Safari iOS	⚠ Richiede tap	✓	✓	TTS si attiva dopo il primo gesto utente.
Chrome Android	✓ Buono	✓	⚠ file://	Ottimo. Installare voce italiana TTS (Impostazioni → Lingua → TTS).
IE / Edge Legacy	✗	⚠	✗	Non supportato. Aggiornare il browser.

Dispositivi consigliati

Computer/laptop: esperienza ottimale, schermo grande, tastiera fisica
Tablet (iPad, Android): molto buono per autoapprendimento, touch-friendly
Smartphone: funziona ma schermo piccolo. Layout responsive gestisce correttamente il mobile.

🔧

9. Problemi comuni e soluzioni

Il link "Torna all'indice" non funziona

Causa: il file kap_home.html non si trova nella stessa cartella del modulo.
Soluzione: verificare che tutti i file HTML siano nella stessa directory senza sottocartelle.

L'audio TTS non parte

Causa 1: browser non supporta Web Speech API o voce italiana non installata.
Soluzione: usare Chrome. Verificare che la voce italiana sia installata: Windows → Impostazioni → Ora e lingua → Lingua → aggiungere Italiano (Italia) → scarica pacchetto vocale.
Causa 2: su alcuni browser, l'audio non parte senza interazione utente precedente (politica autoplay).
Soluzione: cliccare prima su qualsiasi altro elemento della pagina, poi sul pulsante audio.

Il progresso si azzera tra sessioni diverse

Causa: il localStorage è specifico per browser, dispositivo e origine (URL). Se si apre il file da percorso diverso (es. da chiavetta diversa), il localStorage è diverso.
Soluzione: usare sempre lo stesso browser sullo stesso dispositivo, o usare la modalità online (URL fisso).

I moduli M8–M12 non appaiono attivi nella home

Causa: la home mostra i moduli come "live" solo se il file corrispondente è presente nella stessa cartella.
Soluzione: verificare che tutti i file kap_modulo_X.html siano nella cartella. Aprire la home in Chrome e controllare la console (F12) per eventuali errori.

Gli esercizi non si sbloccano dopo "Controlla"

Causa: JavaScript bloccato (raro in Chrome online, più comune con file://).
Soluzione: aprire Chrome con la flag --allow-file-access-from-files oppure usare un server locale.

I font non si caricano offline

Causa: alcuni browser mostrano i font in modo diverso. Tutti i file KAP usano Verdana (font di sistema) e non richiedono connessione per i font.
Soluzione: i file funzionano ugualmente con i font di sistema (Georgia + sans-serif). Per avere i font offline, scaricarli da fonts.google.com e sostituire il tag <link> con un @font-face locale.

Su tablet la prova d'esame è difficile da navigare

Causa: la barra di navigazione ha molte sezioni su schermi stretti.
Soluzione: su mobile la barra scorre orizzontalmente (scrollbar nascosta). Fare swipe orizzontale sulla barra per vedere tutte le sezioni. L'orientamento landscape (orizzontale) migliora l'esperienza.

Come verificare che tutti i file siano presenti e integri

# Su Windows PowerShell nella cartella KAP: Get-ChildItem *.html | Select-Object Name, Length # Su Mac/Linux Terminal: ls -lh *.html # Dovrebbero comparire 30 file HTML (31 nella Cartella Segreteria, con APRI_QUI.html): # index + kap_home + kap_test + 12 moduli base + 4 avanzati (B1.1/B1.2/B2.1/B2.2) + sicurezza + 4 prove (A1/A2/B1/B2) + 6 file staff (hub, certificato, registro, schema, 2 guide) # + guida_docenti + guida_deployment