Paithon Book: Intelligenza Artificiale, Machine Learning e Deep Learning in Python

Benvenuti nella pagina di "Paithon Book"!

Come costruire e visualizzare il libro

Questa guida ti aiuterà a generare il libro sul tuo computer e a visualizzarlo nel browser. Non preoccuparti se non sei un esperto tecnico: segui semplicemente i passaggi qui sotto!

Prerequisiti

Prima di iniziare, assicurati di avere Python installato sul tuo computer. Se non ce l'hai, puoi scaricarlo da python.org.

Installazione delle dipendenze

Prima di costruire il libro, devi installare le librerie necessarie. Apri il terminale (o Prompt dei comandi su Windows) nella cartella del progetto e digita:

pip install -r requirements.txt

Questo comando installerà automaticamente tutte le librerie richieste per costruire il libro.

Costruire il libro

Una volta installate le dipendenze, puoi generare il libro in formato HTML. Nel terminale, digita:

jb build book

Questo comando:

• Legge tutti i file del libro dalla cartella book/
• Esegue i notebook Jupyter
• Genera le pagine HTML nella cartella book/_build/html/

Nota: La prima volta potrebbe richiedere qualche minuto, soprattutto se ci sono molti notebook da eseguire.

Visualizzare il libro nel browser

Dopo aver costruito il libro, puoi visualizzarlo localmente nel tuo browser. Nel terminale, digita:

python -m http.server 8080

Questo comando avvia un server web locale sulla porta 8080. Vedrai un messaggio simile a:

Serving HTTP on 0.0.0.0 port 8080 (http://0.0.0.0:8080/) ...

Ora apri il tuo browser preferito (Chrome, Firefox, Safari, ecc.) e vai all'indirizzo:

http://localhost:8080/book/_build/html/

Dovresti vedere il libro completo e navigabile! Puoi esplorare tutti i capitoli e testare il codice interattivo.

Aggiornare il libro

Se modifichi i contenuti del libro e vuoi vedere le modifiche:

1. Ferma il server web: Nel terminale dove hai avviato il server, premi Ctrl+C
2. Ricostruisci il libro: Esegui di nuovo jb build book
3. Riavvia il server: Esegui di nuovo python -m http.server 8080
4. Aggiorna il browser: Ricarica la pagina nel browser (solitamente con F5 o Ctrl+R)

Risoluzione problemi comuni

• Errore "jb: command not found": Assicurati di aver installato correttamente le dipendenze con pip install -r requirements.txt
• Errore "porta già in uso": Se la porta 8080 è già occupata, puoi usare un'altra porta, ad esempio: python -m http.server 8000 e poi andare su http://localhost:8000/book/_build/html/
• Il libro non si aggiorna: Prova a pulire i file generati prima di ricostruire:

  jb clean book
  jb build book