Δημιουργία project¶

Αν αυτή είναι η πρώτη φορά που χρησιμοποιείτε το Django, θα χρειαστεί να ρυθμίσετε κάποια πράγματα στην αρχή. Θυμηθείτε ότι οι σωστές βάσεις δημιουργούν σταθερά σπίτια. Πιο συγκεκριμένα, θα χρειαστεί να τρέξετε μια Django εντολή η οποία θα δημιουργήσει αυτόματα ένα Djangoproject – το οποίο δεν είναι τίποτε άλλο παρά ένας φάκελος (μια συλλογή από ρυθμίσεις, αν θέλετε) που περιέχει διάφορα αρχεία, όπως ρυθμίσεις της βάσης δεδομένων, διάφορες επιλογές του Django και ρυθμίσεις που αφορούν το application σας. Αν μπερδευτήκατε, μην ανησυχείτε, θα διαλευκανθούν όλα καθώς προχωράμε στον οδηγό.

From the command line,cd into a directory where you’d like to store yourcode and create a new directory nameddjangotutorial. (This directory namedoesn’t matter to Django; you can rename it to anything you like.)

$mkdirdjangotutorial

...\>mkdir djangotutorial

Then, run the following command to bootstrap a new Django project:

$django-adminstartprojectmysitedjangotutorial

...\> django-admin startproject mysite djangotutorial

This will create a project calledmysite inside thedjangotutorialdirectory. If it didn’t work, seeΠροβλήματα στην εκτέλεση της εντολής django-admin.

Let’s look at whatstartproject created:

djangotutorial/    manage.py    mysite/        __init__.py        settings.py        urls.py        asgi.py        wsgi.py

Αυτά τα αρχεία είναι:

• manage.py: Αυτό το αρχείο αποτελεί εντολή (κονσόλας) την οποία μπορείτε να χρησιμοποιήσετε (και θα το κάνετε) για να αλληλεπιδράτε με το project σας για διάφορους λόγους (π.χ δημιουργία πινάκων στη database, εκκίνηση του προ-εγκατεστημένου server κλπ). Μπορείτε να διαβάσετε όλες τις λεπτομέρειες σχετικά με το αρχείοmanage.py στοdjango-admin and manage.py.

• mysite/: A directory that is the actual Python package for yourproject. Its name is the Python package name you’ll need to use to importanything inside it (e.g.mysite.urls).

• mysite/__init__.py: Ένα κενό αρχείο που λέει στην Python ότι αυτός ο φάκελος θα πρέπει να θεωρηθεί ως Python package. Αν είστε καινούργιος στην Python, διαβάστεπερισσότερα σχετικά με τα packages στην επίσημη ιστοσελίδα της Python.

• mysite/settings.py: Ένα αρχείο που κρατά όλες τις ρυθμίσεις/παραμέτρους για αυτό το Django project (είναι η καρδιά ενός project). Το άρθροDjango settings θα σας εξηγήσει όλα όσα χρειάζεστε σχετικά με το πως δουλεύουν οι ρυθμίσεις αυτές.

• mysite/urls.py: Το αρχείο αυτό κρατά τους ορισμούς των URLs για αυτό το project. Με άλλα λόγια είναι ένας «πίνακας περιεχομένων» του Django site σας. Μπορείτε να διαβάστε περισσότερα για τα URLs στο άρθροURL dispatcher.

• mysite/asgi.py: An entry-point for ASGI-compatible web servers toserve your project. SeeHow to deploy with ASGI for more details.

• mysite/wsgi.py: Αυτό το αρχείο αποτελεί ένα σημείο εισόδου για τους Web servers οι οποίοι είναι συμβατοί με το WSGI specification. Δείτε περισσότερα στο άρθροπως να δουλέψω με το WSGI για περισσότερες λεπτομέρειες.

Ο development server¶

Let’s verify your Django project works. Change into thedjangotutorialdirectory, if you haven’t already, and run the following commands:

$pythonmanage.pyrunserver

...\> py manage.py runserver

Θα δείτε την ακόλουθη έξοδο, στη κονσόλα:

Performing system checks...System check identified no issues (0 silenced).You have unapplied migrations; your app may not work properly until they are applied.Run 'python manage.py migrate' to apply them.Ιουλίου 17, 2025 - 15:50:53Django version 5.2, using settings 'mysite.settings'Starting development server athttp://127.0.0.1:8000/Quit the server with CONTROL-C.WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.For more information on production servers see:https://docs.djangoproject.com/en/5.2/howto/deployment/

Now that the server’s running, visithttp://127.0.0.1:8000/ with your webbrowser. You’ll see a «Congratulations!» page, with a rocket taking off.It worked!

You’ve started the Django development server, a lightweight web server writtenpurely in Python. We’ve included this with Django so you can develop thingsrapidly, without having to deal with configuring a production server – such asApache – until you’re ready for production.

Now’s a good time to note:don’t use this server in anything resembling aproduction environment. It’s intended only for use while developing. (We’re inthe business of making web frameworks, not web servers.)

(To serve the site on a different port, see therunserver reference.)

Δημιουργώντας το app ψηφοφορίας¶

Τώρα που το περιβάλλον εργασίας σας – το «project» – είναι έτοιμο, μπορείτε να ξεκινήσετε να δημιουργείτε.

Κάθε application που γράφετε στο Django αποτελείται από ένα Python package (ένας φάκελος που περιέχει το αρχείο__init__.py) το οποίο πρέπει να ακολουθεί ορισμένους κανόνες. Για άλλη μια φορά, το Django σας παρέχει την ανάλογη εντολή για να δημιουργήσετε αυτόματα τη δομή αυτού του φακέλου (Python package) ούτως ώστε να επικεντρωθείτε στο να γράψετε κώδικα παρά στο να δημιουργείτε φακέλους και υποφακέλους.

Your apps can live anywhere in yourPython path. Inthis tutorial, we’ll create our poll app inside thedjangotutorial folder.

Για να δημιουργήσετε το app, σιγουρευτείτε ότι βρίσκεστε στο ίδιο επίπεδο με το αρχείοmanage.py και πληκτρολογήστε την εντολή:

$pythonmanage.pystartapppolls

...\> py manage.py startapp polls

That’ll create a directorypolls, which is laid out like this:

polls/    __init__.py    admin.py    apps.py    migrations/        __init__.py    models.py    tests.py    views.py

Αυτή η δομή θα εσωκλείει ολόκληρη την εφαρμογή μας.

Γράφοντας το πρώτο σας view¶

Ας γράψουμε το πρώτο μας view. Ανοίξτε το αρχείοpolls/views.py και γράψτε τον ακόλουθο Python κώδικα:

fromdjango.httpimportHttpResponsedefindex(request):returnHttpResponse("Hello, world. You're at the polls index.")

This is the most basic view possible in Django. To access it in a browser, weneed to map it to a URL - and for this we need to define a URL configuration,or «URLconf» for short. These URL configurations are defined inside eachDjango app, and they are Python files namedurls.py.

To define a URLconf for thepolls app, create a filepolls/urls.pywith the following content:

fromdjango.urlsimportpathfrom.importviewsurlpatterns=[path("",views.index,name="index"),]

Your app directory should now look like:

polls/    __init__.py    admin.py    apps.py    migrations/        __init__.py    models.py    tests.py    urls.py    views.py

The next step is to configure the root URLconf in themysite project toinclude the URLconf defined inpolls.urls. To do this, add an import fordjango.urls.include inmysite/urls.py and insert aninclude() in theurlpatterns list, so you have:

fromdjango.contribimportadminfromdjango.urlsimportinclude,pathurlpatterns=[path("polls/",include("polls.urls")),path("admin/",admin.site.urls),]

Thepath() function expects at least two arguments:route andview.Theinclude() function allows referencing other URLconfs.Whenever Django encountersinclude(), it chops off whateverpart of the URL matched up to that point and sends the remaining string to theincluded URLconf for further processing.

The idea behindinclude() is to make it easy toplug-and-play URLs. Since polls are in their own URLconf(polls/urls.py), they can be placed under «/polls/», or under«/fun_polls/», or under «/content/polls/», or any other path root, and theapp will still work.

You have now wired anindex view into the URLconf. Verify it’s working withthe following command:

$pythonmanage.pyrunserver

...\> py manage.py runserver

Επισκεφτείτε την σελίδαhttp://localhost:8000/polls/ με τον browser σας και θα πρέπει να δείτε το κείμενο «Hello, world. You’re at the polls index.», το οποίο γράψαμε στηνindex view.

Όταν αισθανθείτε άνετα με αυτό τον οδηγό και με τη λειτουργία της Web request-Web response διαδικασίας μπορείτε να συνεχίσετε στοδεύτερο μέρος αυτού του οδηγού για να εργαστείτε με τη βάση δεδομένων.