Foghlaimímis trí shampla.
\nLe linn an teagaisc seo, beimid ag siúl leat trí bhunfheidhmchlár vótaíochta a chruthú.
\nBeidh dhá chuid ann:
\nSuíomh poiblí a ligeann do dhaoine féachaint ar na pobalbhreitheanna agus vótáil iontu.
Suíomh riaracháin a ligeann duit pobalbhreitheanna a chur leis, a athrú agus a scriosadh.
Glacfaimid leis go bhfuil :d oc: Django suiteáilte </intro/install> agat cheana féin. Is féidir leat a rá go bhfuil Django suiteáilte agus cén leagan tríd an ordú seo a leanas a rith i leid bhlaosc (arna léiriú ag an réimír $):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nMá tá Django suiteáilte, ba chóir duit an leagan de do shuiteáil a fheiceáil. Mura bhfuil, gheobhaidh tú earráid ag insint "Níl modúl darb ainm django".
\nScríobhtar an rang teagaisc seo do Django |leagan|, a thacaíonn le Python 3.10 agus níos déanaí. Mura bhfuil an leagan Django comhoiriúnach, is féidir leat tagairt a dhéanamh don rang teagaisc do do leagan de Django trí úsáid a bhaint as an switcher leagan ag bun an chúinne ar dheis den leathanach seo, nó Django a nuashonrú go dtí an leagan is nua. Má tá leagan níos sine de Python á úsáid agat, seiceáil :ref:'faq-python-version-support' chun leagan comhoiriúnach de Django a aimsiú.
\n\nMá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.
\nÓ 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.)
Linux / macOS
$ mkdir djangotutorial\nWindows
...\\> mkdir djangotutorial\nAnsin, rith an t-ordú seo a leanas chun tionscadal nua Django a thosú:
\nLinux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nCruthó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':
\ndjangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nIs iad seo a leanas na comhaid seo:
\nmanage.py: A command-line utility that lets you interact with this\nDjango project in various ways. You can read all the details about\nmanage.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\nproject. Django settings will tell you all about how settings\nwork.
mysite/urls.py: The URL declarations for this Django project; a\n"table of contents" of your Django-powered site. You can read more about\nURLs 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í.
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:
\nLinux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nFeicfidh tú an t-aschur seo a leanas ar an líne ordaithe:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\nDFómh 03, 2026 - 15:50:53\nDjango version 5.2, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\nWARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.\nFor more information on production servers see: https://docs.djangoproject.com/en/5.2/howto/deployment/\n\n
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é!
\nThosaigh 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.
\nIs 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.)
\n(Chun freastal ar an suíomh ar phort eile, féach an tagairt :d jadmin:runserver.)
\n\nAnois go bhfuil do thimpeallacht -- "tionscadal" -- ar bun, tá tú ar tí tosú ag déanamh oibre.
\nIs é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ú.
\n\nIs 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:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nCruthóidh sé sin eolaire polls, atá leagtha amach mar seo:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nBeidh an feidhmchlár vótaíochta sa struchtúr eolaire seo.
\nScríobhaimis an chéad amharc. Oscail an comhad polls/views.py agus cuir an cód Python seo a leanas ann:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nIs é 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:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nBa cheart go mbeadh cuma ar do eolaire feidhmchlár anois:
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nThe next step is to configure the root URLconf in the mysite project to\ninclude the URLconf defined in polls.urls. To do this, add an import for\ndjango.urls.include in mysite/urls.py and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\nThe path() function expects at least two arguments:\nroute and view.\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded 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:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nTé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í.
\n