Scríobh do chéad aip Django, cuid 1Link to this heading#

Tionscadal a chruthúLink to this heading#

Más é seo do chéad uair ag baint úsáide as Django, beidh ort aire a thabhairt do roinnt thus tosaigh. Eadhon, beidh ort roinnt cód a ghiniúint go huathoibríoch a bhunaíonn Django: téarma: 'tionscadal' - bailiúchán socruithe le haghaidh sampla de Django, lena n-áirítear cumraíocht bunachar sonraí, roghanna Django-sonrach agus socruithe a bhaineann go sonrach le feidhmchlár.

Ó líne na n-orduithe, cd isteach i gcomhadlann inar mhaith leat do chód a stóráil agus eolaire nua a chruthú darb ainm djangotutorial. (Ní bhaineann an t-ainm eolaire seo le Django; is féidir leat é a athainmniú chuig aon rud is mian leat.)

$ mkdir djangotutorial

...\> mkdir djangotutorial

Ansin, rith an t-ordú seo a leanas chun tionscadal nua Django a thosú:

$ django-admin startproject mysite djangotutorial

...\> django-admin startproject mysite djangotutorial

Cruthóidh sé seo tionscadal ar a dtugtar mysite taobh istigh den eolaire djangotutorial. Mura n-oibríonn sé, féach :ref:'troubleshooting-django-admin'.

Breathnaímis ar an méid a chruthaigh :d jadmin:'startproject':

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

Is iad seo a leanas na comhaid seo:

• manage.py: A command-line utility that lets you interact with this Django project in various ways. You can read all the details about manage.py in django-admin agus manage.py.

• :comhad:`mysite/`: Eolaire arb é an pacáiste Python iarbhír do do thionscadal. Is é an t-ainm an t-ainm pacáiste Python a chaithfidh tú a úsáid chun aon rud a allmhairiú laistigh de (m.sh. mysite.urls).

• mysite/__init__.py: Comhad folamh a insíonn do Python gur chóir an t-eolaire seo a mheas mar phacáiste Python. Más tosaitheoir Python tú, léigh :ref:'more about packages<tut-packages>' sna docs oifigiúla Python.

• mysite/settings.py: Settings/configuration for this Django project. Django settings will tell you all about how settings work.

• mysite/urls.py: The URL declarations for this Django project; a "table of contents" of your Django-powered site. You can read more about URLs in URL dispatcher.

• mysite/asgi.py: Pointe iontrála do fhreastalaithe gréasáin atá comhoiriúnach le ASGI chun freastal ar do thionscadal. Féach :d oc:/howto/deployment/asgi/index le haghaidh tuilleadh sonraí.

• mysite/wsgi.py: : Pointe iontrála le haghaidh freastalaithe gréasáin atá comhoiriúnach le WSGI chun freastal ar do thionscadal. Féach Conas a imscaradh le WSGI le haghaidh tuilleadh sonraí.

An freastalaí forbarthaLink to this heading#

A ligean ar fhíorú do oibreacha tionscadal Django. Athraigh isteach sa chomhad:djangotutorial eolaire, mura bhfuil tú cheana féin, agus rith na horduithe seo a leanas:

$ python manage.py runserver

...\> py manage.py runserver

Feicfidh tú an t-aschur seo a leanas ar an líne ordaithe:

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.

Lún 09, 2026 - 15:50:53
Django version 5.2, using settings 'mysite.settings'
Starting development server at http://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/

Anois go bhfuil an freastalaí ag rith, tabhair cuairt http://127.0.0.1:8000/ le do bhrabhsálaí gréasáin. Feicfidh tú "Comhghairdeas!" leathanach, le roicéad ag éirí as. D'oibrigh sé!

Thosaigh tú an freastalaí forbartha Django, freastalaí gréasáin éadrom scríofa i Python amháin. Táimid tar éis é seo a chur san áireamh le Django ionas gur féidir leat rudaí a fhorbairt go tapa, gan déileáil le freastalaí táirgeachta a chumrú - mar shampla Apache - go dtí go mbeidh tú réidh le táirgeadh.

Is dea-am é anois le tabhairt faoi deara: ná úsáid an freastalaí seo in aon rud atá cosúil le timpeallacht táirgthe. Níl sé beartaithe ach le húsáid agus é ag forbairt. (Táimid i mbun creataí gréasáin a dhéanamh, ní freastalaithe gréasáin.)

(Chun freastal ar an suíomh ar phort eile, féach an tagairt :d jadmin:runserver.)

Cruthú an aip vótaíochtaLink to this heading#

Anois go bhfuil do thimpeallacht -- "tionscadal" -- ar bun, tá tú ar tí tosú ag déanamh oibre.

Is éard atá i ngach feidhmchlár a scríobhann tú i Django pacáiste Python a leanann coinbhinsiún áirithe. Tagann Django le fóntais a ghineann struchtúr bunúsach eolaire app go huathoibríoch, ionas gur féidir leat díriú ar chód scríbhneoireachta seachas eolairí a chruthú.

Is féidir le d’aipeanna maireachtáil áit ar bith i do Python path. Sa rang teagaisc seo, cruthóimid ár n-aip vótaíochta laistigh den fhillteán djangotutorial.

Chun d'aip a chruthú, cinntigh go bhfuil tú san eolaire céanna le manage.py agus clóscríobh an t-ordú seo:

$ python manage.py startapp polls

...\> py manage.py startapp polls

Cruthóidh sé sin eolaire polls, atá leagtha amach mar seo:

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

Beidh an feidhmchlár vótaíochta sa struchtúr eolaire seo.

Scríobh do chéad amharcLink to this heading#

Scríobhaimis an chéad amharc. Oscail an comhad polls/views.py agus cuir an cód Python seo a leanas ann:

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

Is é seo an dearcadh is bunúsaí is féidir i Django. Chun rochtain a fháil air i mbrabhsálaí, ní mór dúinn é a mhapáil chuig URL - agus chuige seo ní mór dúinn cumraíocht URL, nó "URLconf" a shainiú go gairid. Sainmhínítear na cumraíochtaí URL seo taobh istigh de gach feidhmchlár Django, agus is comhaid Python iad darb ainm urls.py.

Chun URLconf a shainmhíniú don aip polls, cruthaigh comhad polls/urls.py leis an ábhar seo a leanas:

from django.urls import path

from . import views

urlpatterns = [
    path("", views.index, name="index"),
]

Ba cheart go mbeadh cuma ar do eolaire feidhmchlár anois:

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 the mysite project to include the URLconf defined in polls.urls. To do this, add an import for django.urls.include in mysite/urls.py and insert an include() in the urlpatterns list, so you have:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("polls/", include("polls.urls")),
    path("admin/", admin.site.urls),
]

The path() function expects at least two arguments: route and view. The include() function allows referencing other URLconfs. Whenever Django encounters include(), it chops off whatever part of the URL matched up to that point and sends the remaining string to the included URLconf for further processing.

Is é an smaoineamh taobh thiar de include() é a dhéanamh éasca URLanna plug-and-play. Ós rud é go bhfuil pobalbhreith ina URLconf féin (`` pobalbhreith/urls.py``), is féidir iad a chur faoi "/polls/", nó faoi "/fun_polls/", nó faoi "/content/polls/", nó aon fréimhe cosán eile, agus beidh an app fós ag obair.

Tá amharc index sreangaithe agat anois sa URLconf. Fíoraigh go bhfuil sé ag obair leis an ordú seo a leanas:

$ python manage.py runserver

...\> py manage.py runserver

Téigh go http://localhost:8000/polls/ i do bhrabhsálaí, agus ba cheart duit an téacs "Dia duit, world. Tá tú ag an innéacs pobalbhreithe." a fheiceáil, a shainigh tú sa radharc innéacs .

Nuair atá tú compordach leis an mbunsreabhadh iarratais agus freagartha, léigh cuid 2 den rang teagaisc seo chun tosú ag obair leis an mbunachar sonraí.