Giter Club home page Giter Club logo

djangogirls-tutorial's Introduction

Il tutorial di Django Girls

Questo lavoro è sotto la licenza internazionale di Creative Commons Attribution-ShareAlike 4.0. Per vedere una copia di questa licenza, visita https://creativecommons.org/licenses/by-sa/4.0/

Benvenuta {#welcome}

Benvenuta al tutorial di Django Girls! Siamo felici di vederti :)

In questo tutorial ti faremo vedere cosa succede sotto il cofano di un sito web, mostrandoti tutti i pezzi che compongono il web per come lo conosciamo.

Ci saranno un sacco di cose che non hai mai visto e sarà come vivere un'avventura, ma non preoccuparti, se hai preso la decisione di provarci hai tutto quello che serve per arrivare in fondo :)

Introduzione

Hai mai sentito che il mondo sta diventando sempre più tecnologico e sei in qualche modo rimasta indietro? Ti sei mai chiesta come creare un sito web ma non hai mai avuto abbastanza motivazione per iniziare? Hai mai pensato che il mondo del software è troppo complicato per te persino per provare a fare qualcosa per conto tuo?

Beh, abbiamo buone notizie per te! La programmazione non è così complicata come sembra e vogliamo dimostrati quanto può essere divertente.

Il tutorial non ti trasformerà magicamente in una programmatrice. Se vuoi diventare brava, ci vorranno mesi o addirittura anni di apprendimento e pratica. Ma ti vogliamo dimostrare che la programmazione o creare siti web non è complicato come sembra. Proveremo a spiegarti diversi argomenti come meglio possiamo, in modo che non ti senta più intimidita dalla tecnologia.

Speriamo di essere in grado di farti amare la tecnologia come noi!

Cosa imparerai durante questo tutorial?

Una volta che avrai terminato il tutorial, avrai a disposizione una semplice applicazione web: il tuo blog personale. Ti mostreremo come metterlo online, in modo che gli altri possano vedere il tuo lavoro!

Assomiglierà (più o meno) a questo:

Il tuo blog

Se lavori da sola al tutorial e non hai un coach che ti possa aiutare nel caso avessi qualche problema, abbiamo una chat per te: DjangoGirls It. Abbiamo chiesto ai nostri coach e alle partecipanti precedenti di esserci di volta in volta, ed aiutare gli altri con il tutorial! Non aver paura di fare domande!

OK, cominciamo dall'inizio...

Informazioni e contribuzioni

Questo tutorial è mantenuto da DjangoGirls. Se trovi errori o se vuoi aggiornare questo tutorial, segui le linee guida per i collaboratori.

djangogirls-tutorial's People

Contributors

acegentile avatar alessiamarcolini avatar dennybiasiolli avatar dependabot[bot] avatar gitbook-bot avatar lillopaco avatar patrick91 avatar scontini76 avatar simobasso avatar valentinogagliardi avatar webs86 avatar xrmx avatar yakky avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

djangogirls-tutorial's Issues

Introduzione alla terminologia dev - prod

Descrizione

Non è chiara la differenza tra ambiente locale e ambiente di "produzione" Heroku. In particolare molte si aspettano di trovare anche su Heroku i blog post creati in locale ed hanno difficoltà a capire perché si usano due ambienti separati.

Potrebbe essere utile una sezione introduttiva che spiega la differenza tra ambiente di sviluppo e ambiente Heroku.

binaries / script installed by `pip install --user` are not in windows path by default

Descrizione

pip install --user installa script e binari (es: django-admin.py) in una cartella utente (es %APPDATA%\Python\Python36\Scripts in windows, ma in MacOS / Linux non cambia) che di default non è nel path. E' quindi necessario documentare come aggiungere quel percorso al path in modo "stabile".

PATH del file

incolla qui il path del file incriminato (es. djangogirls_revamped/installation/README.md)

Versione di Python

3.6.x (ma in realtà tutte)

Sistema Operativo

Tutti

Django tutorial: aggiornare riferimenti alla documentazione

Descrizione

Ci sono riferimenti alla documentazione di Django 1.11 o precedenti quando il tutorial è stato portato alla 2.1

PATH del file

whats_next/README.md
django_forms/README.md
django_urls/README.md
django_views/README.md

se va bene ci penso io appena sono meno assonnato!

Typo su django_start_project/README.md

Descrizione

Errore di traduzione: (su Windows, è probabile che tu deva premere Ctrl+Break)

debba invece di "deva"

PATH del file

/django_start_project/README.md

Link TElegram errato

Il link Telegram sul README è errato: cliccandoci sopra Telegram informa che l'utente non esiste.

Chiarire Ctrl+Break su Windows

Descrizione

Non è chiaro a tutti a quale tasto corrisponda "Break" su Windows. Specificare che su alcune tastiere equivale al tasto "Pausa - Interr"

PATH del file

django_start_project/README.md

Sistema Operativo

Windows

Errori protocollo SSL su mac

Descrizione

Nell'esecuzione di alcuni comandi che richiedono risorse su HTTPS vengono resituiti errori di compatibilità con TLS1

Comandi interessati:

  • pip: su almeno un mac High Sierra qualunque comando che usi la rete ritorna questo errore. È stato risolto installando 3.6.5 e chiamando esplicitamente pip3 / python3
  • python -m django startproject: successo su 2 mac su due: errore SSL nell'accesso al repository github. È stato risolto scaricando a mano il file master.zip e usandolo da locale

PATH del file

  • installation/README.md
  • django_start_project/README.md

Versione di Python

3.6.x

Sistema Operativo

mac OS High Sierra

Come segnalato da simone, probabilmente legato a heroku/heroku-django-template#79

OperationalError Exception Value: no such table: blog_post

Descrizione

Amministrazione Django, dopo aver abilitato l'amministrazione con modifiche al file admin.py e creato il superuser per l'amministrazione, viene chiesto di loggarsi ed inserire qualche post di prova.
In caso di questo tipo di errore
errore_db

basta stoppare il webserver (CTRL +C) ridare il migrate del db

python manage.py migrate

e startare nuovamente il webserver

PATH del file

https://djangogirls-italia.netlify.com/django_admin/#django-admin

Sistema Operativo

Windows 10

intermezzo: installazione di ponysay

Per puro gaudio e divertimento propongo l'aggiunta, come intermezzo per relax mentale, l'installazione di ponysay: https://github.com/erkin/ponysay

Sebbene tragga origine da tutt'altro (la serie animata My Little Pony: Friendship is Magic) penso sia un carino riferimento alla mascot (ufficiosa) di Django, come pure un ottimo esempio di applicazione scritta in python, divertente tra l'altro per far vedere le pipe in azione... fortune | ponysay.

Se l'idea piace ci penso io a fare la PR.

installazione python via homebrew?

Sotto macOS trovo molto pratico usare brew per installare le applicazioni, compreso l'interprete python. Pensate sia il caso di proporlo nel tutorial come metodo alternativo di installazione di python? Magari è già usato da qualche partecipante dal workshop e magari in futuro può rilevarsi utile alle partecipanti anche in un secondo momento. Cosa ne dite?

check heroku-toolbelt

Descrizione

Nell'ultima versione di heroku-toolbelt, per verificare che sia andato tutto bene, su Windows 10 PRO, una volta aperto il terminale e scritto "heroku login" anzichè le credenziali sul terminale si apre una finestra nel browser che "aggancia" la consolle con le credenziali

ps. Se è una cosa troppo superflua chiudere tranquillamente la issue :)

PATH del file

https://djangogirls-italia.netlify.com/installation/#

Sistema Operativo

Windows 10 PRO

ma perché c'è un pony/pegaso sulla maglietta?

Forse i giovani non lo sanno, penso che pochissime ragazze lo sappiano o si siano poste la domanda, come pure mi pare che una risposta buona non mi pare nemmeno troppo facile da trovare in rete (ad oggi). Se non sbaglio dal sito ufficiale è stato rimosso da tempo immemore qualsiasi riferimento al pony di django. Penso possa essere carino aggiungere nel tutorial un paragrafetto con l'accenno alla storia e un paio di link di riferimento:

http://avalonstar.com/journal/2008/the-web-framework-for-ponies/
http://www.djangopony.com

Se pensate che sia una cosa carina per rilassare la mente durante la lettura ditemelo, faccio io la PR.

(vedi anche issue #49)

Usare path per Django invece di url

Descrizione

L'attuale versione del tutorial usa ancora il "vecchio stile" per dichiarare gli url:

url(r'^admin/', admin.site.urls),`

Il nuovo formato prevede l'uso di path:

path('admin/', admin.site.urls),

Sarebbe opportuno aggiornare tutto, a partire dal template del progetto

Se interessa posso preparare un PR per entrambi.

PATH del file

djangogirls-tutorial/master/django_urls/README.md

Chiarire comandi ed output

Descrizione

Molte persone confondono l'output dei comandi con i comandi stessi. Esempio:

git add --all .
git commit -m "La mia app Django Girls, primo commit"
 [...]
 13 files changed, 200 insertions(+)
 create mode 100644 .gitignore
 [...]
 create mode 100644 mysite/wsgi.py

La domanda più frequente è "devo copiare anche 13 files changed ... ?". Suggerirei di sistemare questo aspetto separando i comandi dai relativi output.

Assegnami pure.

PATH del file

Un esempio è su djangogirls-tutorial/master/deploy/README.md

Nome comandi python

Descrizione

Bisogna chiarire di più (all'inizio e almeno nei primi passaggi), che i comandi python / pip potrebbe essere necessario scriverli come python3 / pip3 (questo è soprattutto un appunto per noi coach)

La cosa ideale sarebbe riuscire ad avere una casistica che ci permetta fin dall'inizio di sapere qual è la situazione della partecipante.

Fosse anche solo un griglia per il coach che si segna le cose in fase di installazione

Può anche valere la pena ripetere spesso l'avviso messo nella pagina di installazione.

Forse sostituire tutti i comandi python, pip con i rispettivi 3 potrebbe essere utile: dovrebbe essere più compatibile e soprattuto è un segnale utile anche ai coach per sapere di dover eventualmente far provare l'altra variante

PATH del file

  • installation/README.md (e altrove)

aggiornare creazione progetto windows - riferimento a tutorial vecchio!!!

Descrizione

Creare un Progetto: Windows

il comando punta al vecchio tuttorial ,

python -m django startproject --template=https://github.com/simobasso/startproject/archive/master.zip --name=Procfile mysite .

anzichè =https://github.com/DjangoGirlsItalia/startproject/archive/master.zip

PATH del file

https://djangogirls-italia.netlify.com/django_start_project/#creare-un-progetto-windows

Versione di Python

3.7

Sistema Operativo

windows

Introduzione alla command line prima della sezione di installazione?

Nella sezione di installazione si fa usare la riga di comando dicendo che verrà spiegata poi, ma secondo me la fase di installazione potrebbe risultare più gradevole e comprensibile da fare se la command line venisse introdotta fin da subito, magari anche in forma leggermente semplificata.

Mi viene naturale leggere la guida con queste sezioni scambiate, anche se probabilmente questo è stato fatto per fare in modo che le ragazze abbiano il software installato prima del workshop. Vale la pena secondo voi provare a invertirle comunque e chiedere che prima del workshop le ragazze facciano la sezione di command line e di installazione?

Lo scenario che mi aspetto da questa variazione sarebbe:

  • le ragazze prima di installare qualsiasi cosa si divertirebbero a dare comandi sul terminale, che secondo me è una soddisfazione
  • arriverebbero alla sezione di installazione un po' più sicure delle loro capacità, comprenderebbero meglio quello che fanno e quindi penso sarebbe meno frastornante
  • in caso di difficoltà il dialogo con il coach potrebbe partire da i concetti base già spiegati nella sezione sulla CLI, permettendo ai due di parlare semplicemente dei comandi dell'installazione senza dover fare salti in avanti per capire e spiegare cosa non sta andando
  • forse porterebbe ad un minore assenteismo nell'incontro online pre-workshop
  • il workshop potrebbe iniziare con un ripasso sul terminale in cui ci si assicura su che livello ciascuna ha raggiunto in autonomia, si livella la conoscenza ed eventualmente si può parlare con un po' più di serenità di altri aspetti della riga di comando senza che venga affrontato tutto nello stesso giorno mettendo un sacco di carne al fuoco

E' solo il mio punto di vista chiaramente, capisco che il tutorial è nato con un'idea ben precisa in testa e quindi probabilmente l'approccio attuale è ben studiato. Mi sto mettendo solo nei panni di chi come me ha un po' di difficoltà di seguire le istruzioni un po' alla cieca senza avere almeno il minimo di nozioni per compierle.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.