Se stai seguendo il tutorial a casa

Se stai seguendo il tutorial a casa, e non durante uno degli eventi Django Girls, puoi saltare completamente questo capitolo e andare direttamente al capitolo Come funziona Internet.

Questo perché nel tutorial spieghiamo come installare i programmi passo passo -- questa è una pagina aggiuntiva che raccoglie tutte le istruzioni di installazione (e che può tornare utile in alcuni workshop). Se vuoi puoi decidere di installare subito il materiale che trovi in questa pagina. Ma se vuoi imparare alcune nozioni prima di installare queste cose sul tuo computer, salta questo capitolo e ti spiegheremo come fare le installazioni più tardi, quando sarà necessario.

Buona fortuna!

Se stai partecipando a un workshop

Se stai partecipando a uno degli eventi Django Girls:

• Il tuo workshop potrebbe avere un "party di installazione" prima del workshop principale. Se sei in un party di installazione, questa pagina è per te! Segui le istruzioni qui per ottenere tutto quello che serve per il workshop installato, con l'aiuto degli autobus se necessario. Poi al workshop principale, sarai in grado di saltare le istruzioni di installazione che incontrerai nel tutorial principale quando li avrai ricevuti.
• Gli organizzatori del tuo workshop potrebbero aver chiesto di provare a casa per installare tutto sul tuo computer prima dell'inizio del workshop. Se ti è stato chiesto di farlo, questa pagina è per te! Segui le istruzioni qui, il meglio possibile. Poi al workshop principale, quando si arriva a un passo di installazione nel tutorial principale, se non si è riusciti a installare quel pezzo, si può ottenere aiuto dal tuo coach.
• Se il tuo workshop non ha un gruppo di installazione (o non hai potuto partecipare), e se gli organizzatori non ti hanno chiesto di provare a installare tutto prima di arrivare, salta questa pagina e vai direttamente al capitolo Come funziona Internet . Installerai tutto ciò di cui hai bisogno quando lavori il tutorial.

Installazione

In questo tutorial costruirai un blog. Per farlo, mentre vai nel tutorial, sarai informato su come installare vari software sul tuo computer e impostare alcuni account online come sono necessari. Questa pagina raccoglie tutte le istruzioni di installazione e iscrizione in un unico luogo (che è utile per alcuni formati di workshop).

Breve introduzione alla linea di comando

Molti dei passaggi qui sotto fanno riferimento alla "console", "terminal", "finestra di comando", o "linea di comando" - tutto questo significa la stessa cosa: una finestra sul tuo computer dove puoi inserire comandi. Quando arriverai al tutorial principale, imparerai di più sulla linea di comando. Per ora, la cosa principale che devi sapere è come aprire una finestra di comando e come sembra:

A seconda della versione di Windows utilizzata e della propria tastiera, una delle azioni seguenti dovrebbe aprire una finestra di comando (probabilmente sarà necessario fare più prove, ma non è necessario provare tutti i suggerimenti proposti):

• Andare al menù Start o alla schermata Start e digitare "Prompt dei comandi" nella barra di ricerca.
• Andare al menù Start-->Sistema Windows-->Prompt dei Comandi.
• Andare a menù Start-->Tutti i Programmi-->Accessori-->Prompt dei Comandi.
• Andare alla schermata Start, spostare il mouse nell'angolo in basso a sinistra dello schermo e cliccare sulla freccia in basso che comparirà (per i dispositivi touch screen, scorrere verso l'alto dal fondo dello schermo). La pagina App dovrebbe aprirsi. Cliccare su Prompt dei Comandi nella sezione Sistema Windows.
• Tenere premuto il tasto Windows e cliccare "X". Scegliere "Prompt dei Comandi" dal menù popup.
• Tenere premuto il tasto Windows e premere "R" per aprire la finestra "Esegui". Digitare "cmd" nella casella di testo e premere OK.

Più avanti in questo tutorial, dovrete avere due finestre di comando aperte contemporaneamente. In ogni caso, in alcune versioni di Windows, se già si ha una finestra di comando aperta e si cerca di aprirne un'altra con lo stesso metodo, vi mostrerà la finestra di comando già aperta. Provate adesso sul vostro computer e vedete cosa accade! Se si riesce ad aprire solo una finestra di comando, provare un altro dei metodi sopra indicati. Almeno uno permetterà l'apertura di una nuova finestra di comando.

Installa Python

Per le lettrici a casa: questo capitolo è trattato nel video Installazione di Python & Editor di codice.

Questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)

Django è scritto in Python. Python ci serve per fare qualunque cosa in Django. Iniziamo con l'installazione! Dovresti installare la versione più recente di Python 3, quindi se hai una versione precendente dovrai aggiornarla. Se hai già la versione 3.4 o una versione successiva non servono aggiornamenti.

Installa Python normale come segue, anche quando hai Anaconda installato sul tuo computer.

$ python3 --version
Python 3.6.1

$ grep '^NAME=' /etc/os-release

$ sudo apt install python3

$ sudo dnf install python3

$ sudo zypper install python3

Verifica che l'installazione si sia conclusa correttamente aprendo l'applicazione Terminal ed eseguendo il comando python3:

command-line

$ python3 --version
Python 3.6.1

La versione mostrata può essere diversa da 3.6.1 -- dovrebbe corrispondere alla versione installata.

NOTA: Se sei su Windows e ricevi un messaggio di errore che dice che python3 non è stato trovato, prova ad utilizzare python (senza 3), controlla sia la versione di Python 3.4.0 o superiore. Se anche questo non funziona, puoi aprire un nuovo prompt dei comandi e riprovare; questo accade se usi un prompt dei comandi aperto da prima dell'installazione di Python.

Se hai dubbi o se qualcosa è andato storto e non hai idea di cosa fare dopo - chiedi al tuo coach! A volte le cose non vanno come dovrebbero ed è meglio chiedere aiuto a qualcuno con più esperienza.

Installa un editor del codice

Ci sono moltissimi editor diversi e la scelta dipende in gran parte dalle proprie preferenze. La maggior parte dei programmatori Python usa IDE (in inglese Integrated Development Environments, ambienti di sviluppo integrati) complessi ma estremamente potenti, come PyCharm. Tuttavia questo non è l'editor più appropriato per una principiante; quelli che ti suggeriremo noi sono ugualmente potenti, ma molto più semplici.

Qui di seguito te ne consigliamo alcuni, ma puoi chiedere al tuo coach quali editor preferisce - in modo che possa aiutarti più facilmente.

Codice Studio Visual

Visual Studio Code è un editor di codice sorgente sviluppato da Microsoft per Windows, Linux e macOS. Include il supporto per il debug, il controllo Git incorporato, l'evidenziazione della sintassi, il completamento intelligente del codice, gli snippet e il refactoring del codice.

Scaricalo qui

Gedit

Gedit è un editor open-source e gratuito, disponibile per tutti i sistemi operativi.

Scaricalo qui

Sublime Text 3

Sublime Text è tra gli editor più utilizzati. Ha un periodo di prova gratuito ed è disponibile per tutti i sistemi operativi.

Scaricalo qui

Atom

Atom è un altro editor molto diffuso. È gratuito, open-source e disponibile per Windows, OS X e Linux. Atom è sviluppato da GitHub.

Scaricalo qui

Perché installare un editor di codice?

Forse ti stai chiedendo per quale motivo installiamo questo editor di codice, invece di usare un'applicazione come Word o Blocco Note.

La prima ragione è che il codice deve essere testo semplice, e programmi come Word e Textedit non producono questo tipo di testo, ma testo formattato (con font e formattazione), codificato in formati come l'RTF (Rich Text Format).

La seconda ragione è che gli editor sono specializzati nel modificare codice, e quindi mettono a disposizione utili funzionalità come l'evidenziazione della sintassi con colori legati al suo significato, o la chiusura automatica di parentesi e virgolette.

Vedremo tutto ciò più avanti. Presto, il tuo fidato editor di testo diventerà uno dei tuoi strumenti preferiti. :)

Imposta virtualenv e installa Django

Parte di questa sezione è basata sul tutorial delle Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Una parte di questo capitolo di basa sul django-marcador tutorial, con licenza Creative Commons Attribution-ShareAlike 4.0 International License. Il tutorial di django-marcador è protetto da copyright di Markus Zapke-Gründemann et al.

Ambiente virtuale

Prima di installare Django, ti vogliamo far installare uno strumento estremamente utile per tenere in ordine l'ambiente in cui programmerai sul tuo computer. Potresti saltare questo passaggio, ma è caldamente consigliato soffermarsi. Se inizi con la migliore configurazione possibile, ti risparmierai un sacco di problemi per il futuro!

Per cui, creiamo ora un ambiente virtuale (chiamato anche un virtualenv). Virtualenv isolerà la tua configurazione di Python/Django in base ai diversi progetti. Questo significa che qualunque modifica farai su un sito non avrà alcun effetto su tutti gli altri che stai sviluppando. Chiaro ora?

Tutto quello che devi fare è trovare una cartella in cui vuoi creare il virtualenv; la tua home directory, ad esempio. Su Windows potrebbe apparire come C:\Users\Name (dove Name è il nome del tuo login).

Nota: Su Windows, assicurati che la cartella non contenga caratteri accentati o speciali; se il tuo username contiene cartteri accentati, usa una cartella diversa, ad esempio C:\djangogirls.

Per questo tutorial useremo una nuova directory djangogirls dalla tua home directory:

command-line

$ mkdir djangogirls
$ cd djangogirls

Ora creeremo un virtualenv dal nome myvenv. Questo è il formato del comando generale:

command-line

$ python3 -m venv myvenv

C:\Users\Name\djangogirls> python -m venv myvenv

$ python3 -m venv myvenv

Lavorare con virtualenv

Il comando sopra specificato, creerà una cartella dal nome myenv (o col nome che hai scelto) che contiene il tuo virtual environment (ovvero un mucchio di files e cartelle).

C:\Users\Name\djangogirls> myvenv\Scripts\activate

$ source myvenv/bin/activate

Sarai certo di aver avviato il virtualenv quando vedrai che il prompt nella tua console inizia con (myvenv).

Quando si lavora all'interno di un ambiente virtuale, python farà automaticamente riferimento alla versione corretta da utilizzare. Per cui puoi digitare python invece che python3.

OK, abbiamo tutte le dipendenze importanti pronte. Finalmente possiamo installare Django!

Installare Django

Ora che hai avviato il tuo virtualenv, puoi installare Django.

Prima però dobbiamo assicurarci di avere la versione più recente di pip, il software che useremo per installare Django:

command-line

(myvenv) ~$ python -m pip install --upgrade pip

Installazione di pacchetti con requisiti

Un file di requisiti mantiene un elenco di dipendenze da installare utilizzando pip install:

Crea un file requirements.txt all'interno della cartella djangogirls/ utilizzando l'editor di codice che hai installato prima. Lo fai aprendo un nuovo file nell'editor di codice e quindi salvarlo come requirements.txt nella cartella djangogirls/ . La tua cartella assomiglierà a questo:

djangogirls
├── myvenv
│   └── ...
└───requirements.txt

Nel tuo file djangogirls/requirements.txt aggiungi il testo seguente:

djangogirls/requirements.txt

Django~=2.2.4

Ora, esegui pip install -r requirements.txt per installare Django.

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=2.2.4 (from -r requirements.txt (line 1))
  Downloading Django-2.2.4-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-2.2.4

Questo è tutto! Sei (finalmente) pronto/a a creare un'applicazione Django!

Installa Git

Git è un "sistema di controllo versione" utilizzato da molti programmatori. Questo software può tracciare le modifiche ai file nel corso del tempo, così da poter ripristinare successivamente una specifica versione. Un po' come la funzione "revisioni" nei programmi di elaborazione di testi (come Microsoft Word o LibreOffice), ma molto più potente.

Installare Git

$ sudo apt install git

$ sudo dnf install git

$ sudo zypper install git

Crea un profilo di GitHub

Vai su GitHub.com e crea un nuovo account gratuito. Assicurati di ricordare la tua password (aggiungila al tuo password manager, se ne usi uno).

Crea un profilo di PythonAnywhere

PythonAnywhere è un servizio che permette di eseguire il codice Python sui server "nel cloud". Lo useremo per ospitare il nostro sito, live e su Internet.

Caricheremo il blog che stiamo realizzando su PythonAnywhere. Crea un account "beginner" su PythonAnywhere (l'account gratuito va benissimo, non ti serve una carta di credito).

• www.pythonanywhere.com

Nota Quando scegli il tuo nome utente, tieni presente che l'URL del tuo blog assumerá la formatuonomeutente.pythonanywhere.com, quindi scegli il tuo soprannome o un nome che riguardi l'argomento del blog. Inoltre, assicurati di ricordare la tua password (aggiungilo al tuo password manager, se ne usi uno).

Creazione di un token API PythonAnywhere

Dovrai compiere questo passaggio solo una volta. Dopo aver creato un account su PythonAnywhere, verrai indirizzata alla tua dashboard. Trova il link in alto a destra nella pagina "Account":

quindi seleziona la scheda chiamata "API token", e premi il pulsante che dice "Crea nuovo token API".

Inizia la lettura

Congratulazioni, sei pronta a partire! Se hai del tempo prima del workshop sarebbe magnifico se leggessi qualche capitolo iniziale:

• Come funziona Internet

• Introduzione alla riga di comando

• Introduzione a Python

• Che cos'è Django?

Divertiti al workshop!

Quando inizierà il workshop, potrai andare direttamente a il tuo primo progetto Django! dato che hai già coperto il materiale dei capitoli precedenti.