Tosaíonn an rang teagaisc seo nuair a d'fhág Tutorial 2 as. Táimid ag leanúint leis an bhfeidhmchlár vótaíochta gréasáin agus díreoimid ar chomhéadan poiblí a chruthú -- "tuairimí."
\n\nIs éard is dearcadh ann ná "cineál" de leathanach gréasáin i d'iarratas Django a fhreastalaíonn go ginearálta ar fheidhm shonrach agus a bhfuil teimpléad ar leith aige. Mar shampla, in iarratas blag, b’fhéidir go mbeadh na tuairimí seo a leanas agat:
\nLeathanach baile blag -- taispeánann sé na hiontrálacha is déanaí.
Iontráil "mionsonraí" leathanach -- leathanach permalink le haghaidh iontráil amháin.
Leathanach cartlainne bunaithe ar bhliain -- taispeánann sé gach mí le hiontrálacha sa bhliain ar leith.
Leathanach cartlainne bunaithe ar mhí -- taispeánann sé gach lá le hiontrálacha sa mhí ar leith.
Leathanach cartlainne bunaithe ar an lá -- taispeánann sé gach iontráil sa lá ar leith.
Gníomh tráchta -- Láimhseálann postáil tuairimí chuig iontráil tugtha.
In ár n-iarratas vótaíochta, beidh na ceithre radharc seo a leanas againn:
\nCeist "innéacs" leathanach - taispeánann sé na ceisteanna is déanaí.
Leathanach "mionsonraí" Ceist -- taispeánann sé téacs ceiste, gan torthaí ach le foirm vótála.
Ceist "torthaí" leathanach -- taispeánann torthaí do cheist ar leith.
Vóta caingean - láimhseálann vótáil do rogha ar leith i gceist ar leith.
In Django, déantar leathanaigh ghréasáin agus ábhar eile a sheachadadh trí radharcanna. Léirítear gach radharc le feidhm Python (nó modh, i gcás radhairc rangbhunaithe). Roghnóidh Django radharc tríd an URL a iarrtar a scrúdú (le bheith beacht, an chuid den URL tar éis an ainm fearainn).
\nAnois agus tú i do chuid ama ar an ngréasán b'fhéidir gur tháinig tú trasna ar áilleachta mar ME2/Sites/dirmod.htm?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B. Beidh tú sásta a fhios go gceadaíonn Django patrúin * URL * i bhfad níos galánta dúinn ná sin.
Foirm ghinearálta URL is ea patrún URL - mar shampla: /newsarchive/<year>/<month>/.
Chun dul ó URL go radharc, úsáideann Django rud ar a dtugtar 'URLconfs'. Léarscáilíonn URLconf patrúin URL chun amharc orthu.
\nSoláthraíonn an rang teagaisc seo treoir bhunúsach maidir le húsáid URLconfs, agus is féidir leat tagairt a dhéanamh do URL dispatcher le haghaidh tuilleadh eolais.
\nAnois cuirimis cúpla radharc eile le vótaíocht/views.py. Tá na tuairimí seo beagán difriúil, toisc go nglacann siad argóint:
polls/views.pydef detail(request, question_id):\n return HttpResponse("You're looking at question %s." % question_id)\n\n\ndef results(request, question_id):\n response = "You're looking at the results of question %s."\n return HttpResponse(response % question_id)\n\n\ndef vote(request, question_id):\n return HttpResponse("You're voting on question %s." % question_id)\nSreangaigh na radharcanna nua seo isteach sa mhodúl polls.urls tríd an méid seo a leanas a chur leis :func: glaonna ~ django.urls.path:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n # ex: /polls/\n path("", views.index, name="index"),\n # ex: /polls/5/\n path("<int:question_id>/", views.detail, name="detail"),\n # ex: /polls/5/results/\n path("<int:question_id>/results/", views.results, name="results"),\n # ex: /polls/5/vote/\n path("<int:question_id>/vote/", views.vote, name="vote"),\n]\nFéach i do bhrabhsálaí, ag "/polls/34/". Rithfidh sé an fheidhm detail() agus taispeánfaidh sé cibé aitheantas a sholáthraíonn tú san URL. Bain triail as "/polls/34/results/" agus "/polls/34/vote/" freisin -- taispeánfaidh siad seo torthaí an tsealbhóra ionad agus na leathanaigh vótála.
Nuair a iarrann duine éigin leathanach ó do shuíomh Gréasáin -- abair, "/polls/34/", lódálfaidh Django an modúl Python mysite.urls toisc go bhfuil sé dírithe ag an socrú ROOT_URLCONF. Faigheann sé an athróg darb ainm urlpatterns agus trasnaíonn sé na patrúin in ord. Tar éis dó an meaits a aimsiú ag ` pobalbhreith/', scriosann sé an téacs meaitseála (" pobalbhreith / ") agus seolann sé an téacs atá fágtha -- `` "34/"`` -- chuig an ' URLconf polls.urls le haghaidh tuilleadh próiseála. Is amhlaidh a mheaitseálann sé ' <int:question_id>/', agus glao ar an radharc detail() mar seo a leanas:
detail(request=<HttpRequest object>, question_id=34)\nTagann an chuid question_id=34 ó `` <int:question_id>``. Ag baint úsáide as lúibíní uillinn "gabhálann" cuid den URL agus seolann sé mar argóint eochairfhocal chuig an bhfeidhm radhairc. Sainmhíníonn an chuid question_id den teaghrán an t-ainm a úsáidfear chun an patrún comhoiriúnaithe a shainaithint, agus is tiontaire é an chuid int a shocraíonn cé na patrúin ba cheart a bheith ag teacht leis an gcuid seo den chonair URL. Scarann an colon (:) an t-ainm tiontaire agus patrún.
Tá gach amharc freagrach as ceann amháin de dhá rud a dhéanamh: réad HttpResponse a thabhairt ar ais ina bhfuil an t-ábhar don leathanach iarrtha, nó eisceacht a ardú mar Http404 . Tá an chuid eile suas duit.
Is féidir le do radharc taifid ó bhunachar sonraí a léamh, nó ní féidir. Is féidir leis córas teimpléid a úsáid mar Django's -- nó córas teimpléid Python tríú páirtí -- nó nach bhfuil. Is féidir leis comhad PDF a ghiniúint, XML a aschur, comhad ZIP a chruthú ar an eitilt, rud ar bith is mian leat, ag baint úsáide as cibé leabharlanna Python is mian leat.
\nNíl uait ach Django ná :rang:`~django.http.HttpResponse`. Nó eisceacht.
\nToisc go bhfuil sé áisiúil, bainimis úsáid as API bunachar sonraí Django féin, a chlúdaigh muid i Teagasc 2. Seo stab amháin ag radharc nua innéacs(), a thaispeánann na 5 cheist vótaíochta is déanaí sa chóras, scartha le camóga, de réir dáta foilsithe:
polls/views.pyfrom django.http import HttpResponse\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n output = ", ".join([q.question_text for q in latest_question_list])\n return HttpResponse(output)\n\n\n# Leave the rest of the views (detail, results, vote) unchanged\nThere's a problem here, though: the page's design is hardcoded in the view. If\nyou want to change the way the page looks, you'll have to edit this Python\ncode. So let's use Django's template system to separate the design from Python\nby creating a template that the view can use.
\nAr dtús, cruthaigh eolaire darb ainm templates i do eolaire `` pobalbhreith ``. Féachfaidh Django le haghaidh teimpléid ann.
Déanann socrú :suíomh:`TEMPLATES` do thionscadal cur síos ar an gcaoi a ndéanfaidh Django teimpléid a luchtú agus a rindreáil. Cumraíonn an comhad socruithe réamhshocraithe inneall DjangoTemplates a bhfuil a rogha APP_DIRS socraithe go True. De réir an ghnáis lorgaíonn DjangoTemplates fochomhadlann "teimpléid" i ngach ceann de na :suíomh:`INSTALLED_APPS`.
Laistigh den eolaire templates atá díreach cruthaithe agat, cruthaigh eolaire eile ar a dtugtar `` pobalbhreith``, agus laistigh de sin cruthaigh comhad ar a dtugtar `` index.html``. Is é sin le rá, ba cheart go mbeadh do theimpléad ag vótaíocht/templates/polls/index.html. Mar gheall ar an gcaoi a n-oibríonn an lódóir teimpléid `` app_directories`` mar a thuairiscítear thuas, is féidir leat tagairt a dhéanamh don teimpléad seo laistigh de Django mar `` pobalbhreith / index.html ``.
Cuir an cód seo a leanas sa teimpléad sin:
\npolls/templates/polls/index.html{% if latest_question_list %}\n <ul>\n {% for question in latest_question_list %}\n <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\n {% endfor %}\n </ul>\n{% else %}\n <p>No polls are available.</p>\n{% endif %}\nAnois déanaimis ár n-amharc innéacs a nuashonrú i vótaíocht/views.py chun an teimpléad a úsáid:
polls/views.pyfrom django.http import HttpResponse\nfrom django.template import loader\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n template = loader.get_template("polls/index.html")\n context = {"latest_question_list": latest_question_list}\n return HttpResponse(template.render(context, request))\nLuchtaíonn an cód sin an teimpléad ar a dtugtar vótaíocht/index.html agus cuireann sé comhthéacs air. Is é an comhthéacs ná teimpléad ag mapáil foclóra ainmneacha athróg ar oibiachtaí Python.
Lódáil an leathanach trí do bhrabhsálaí a dhíriú ar "/polls/", agus ba cheart duit liosta le hurchair a fheiceáil ina bhfuil an cheist "Cad atá ar bun" ó Teagasc 2. Léiríonn an nasc leathanach sonraí na ceiste.
\nrender()Link to this heading#Is idiom an-choitianta é teimpléad a lódáil, comhthéacs a líonadh agus réad HttpResponse a sheoladh ar ais le toradh an teimpléid rindreáilte. Soláthraíonn Django aicearra. Seo an radharc iomlán `` index()``, athscríofa:
polls/views.pyfrom django.shortcuts import render\n\nfrom .models import Question\n\n\ndef index(request):\n latest_question_list = Question.objects.order_by("-pub_date")[:5]\n context = {"latest_question_list": latest_question_list}\n return render(request, "polls/index.html", context)\nTabhair faoi deara nuair a bheidh sé seo déanta againn go léir, ní gá dúinn loader agus HttpResponse a allmhairiú a thuilleadh (beidh tú ag iarraidh `` a choinneáil HttpResponse` má tá na modhanna stub fós agat maidir le sonraí, torthaí, agus vóta).
The render() function takes the request object as its\nfirst argument, a template name as its second argument and a dictionary as its\noptional third argument. It returns an HttpResponse\nobject of the given template rendered with the given context.
Anois, déanaimis dul i ngleic le mionsonraí na ceiste - an leathanach a thaispeánann téacs na ceiste do vótaíocht ar leith. Seo an radharc:
\npolls/views.pyfrom django.http import Http404\nfrom django.shortcuts import render\n\nfrom .models import Question\n\n\n# ...\ndef detail(request, question_id):\n try:\n question = Question.objects.get(pk=question_id)\n except Question.DoesNotExist:\n raise Http404("Question does not exist")\n return render(request, "polls/detail.html", {"question": question})\nAn coincheap nua anseo: Ardaíonn an dearcadh an eisceacht Http404 mura bhfuil ceist leis an ID iarrtha ann.
Déanfaimid plé ar cad a d'fhéadfá a chur isteach sa teimpléad polls/detail.html sin beagán níos déanaí, ach más mian leat an sampla thuas a oibriú go tapa, comhad ina bhfuil:
polls/templates/polls/detail.html{{ question }}\ncuirfidh sé tús leat faoi láthair.
\nIs idiom an-choitianta é get() a úsáid agus ardaigh Http404 mura bhfuil an réad ann. Soláthraíonn Django aicearra. Seo an radharc detail(), athscríofa:
polls/views.pyfrom django.shortcuts import get_object_or_404, render\n\nfrom .models import Question\n\n\n# ...\ndef detail(request, question_id):\n question = get_object_or_404(Question, pk=question_id)\n return render(request, "polls/detail.html", {"question": question})\nGlacann an fheidhm get_object_or_404() múnla Django mar a chéad argóint agus líon treallach argóintí eochairfhocail, a théann sé chuig an Http404() mura bhfuil an réad ann.
Tá feidhm get_list_or_404() ann freisin, a oibríonn díreach mar get_object_or_404() -- ach amháin ag baint úsáide as scagaire() in ionad get(). Ardaíonn sé Http404 má tá an liosta folamh.
Ar ais go dtí an radharc detail() dár n-iarratas vótaíochta. Ag cur san áireamh an athróg comhthéacs ceist, seo an chuma a d'fhéadfadh a bheith ar an teimpléad vótaíocht/detail.html:
polls/templates/polls/detail.html<h1>{{ question.question_text }}</h1>\n<ul>\n{% for choice in question.choice_set.all %}\n <li>{{ choice.choice_text }}</li>\n{% endfor %}\n</ul>\nÚsáideann an córas teimpléad comhréir ponc-lookup chun rochtain a fháil ar airíonna athraitheacha. Sa sampla de {{ question.question_text }}, ar dtús déanann Django cuardach foclóir ar an oibiacht ceist. Dá éagmais sin, déanann sé cuardach ar tréith -- a oibríonn, sa chás seo. Dá mba theip ar chuardach aitreabúide, bhainfeadh sé triail as cuardach liosta-innéacs.
Tarlaíonn modh-ghlao sa {% le haghaidh %} lúb: léirmhínítear question.choice_set.all mar chód Python question.choice_set.all(), a fhilleann iterable de Choice réada agus atá oiriúnach le húsáid sa chlib {% le haghaidh %}.
Féach an treoir teimpléid le haghaidh tuilleadh faisnéise faoi theimpléid.
\nCuimhnigh, nuair a scríobhamar an nasc chuig ceist sa teimpléad polls/index.html, bhí cuid de chóid chrua ar an nasc mar seo:
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>\nIs í an fhadhb atá leis an gcur chuige crua-chódáilte seo atá nasctha go docht ná go n-éiríonn sé dúshlánach URLanna a athrú ar thionscadail le go leor teimpléid. Mar sin féin, ós rud é gur shainigh tú an argóint name i bhfeidhmeanna path() sa mhodúl polls.urls, is féidir leat brath ar chonairí URL ar leith atá sainithe i do url a bhaint cumraíochtaí trí úsáid a bhaint as an gclib teimpléad { %url %}:
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nIs é an chaoi a n-oibríonn sé seo ná breathnú ar an sainmhíniú URL mar atá sonraithe sa mhodúl polls.urls. Is féidir leat a fheiceáil go díreach cá bhfuil an t-ainm URL 'mionsonraí' sainmhínithe thíos:
...\n# the 'name' value as called by the {% url %} template tag\npath("<int:question_id>/", views.detail, name="detail"),\n...\nMás mian leat URL mionamharc na vótaíochta a athrú go rud éigin eile, b'fhéidir go rud éigin ar nós vótaíocht/sonraí/12/ seachas é a dhéanamh sa teimpléad (nó teimpléid) d'athródh tú é i `` pobalbhreith / urls.py``:
...\n# added the word 'specifics'\npath("specifics/<int:question_id>/", views.detail, name="detail"),\n...\nNíl ach aip amháin ag an tionscadal teagaisc, `` pobalbhreith``. I dtionscadail fíor Django, d'fhéadfadh go mbeadh cúig, deich, fiche apps nó níos mó. Conas a dhéanann Django idirdhealú a dhéanamh idir na hainmneacha URL eatarthu? Mar shampla, tá radharc mionsonraí ag an aip vótaíochta, agus mar sin d'fhéadfadh aip ar an tionscadal céanna atá le haghaidh blag. Cén chaoi a mbeidh a fhios ag Django cén t-aip atá le cruthú le haghaidh url agus an chlib teimpléid ``{ % url %}` in úsáid agat?
Is é an freagra ná spásanna ainm a chur le do URLconf. Sa chomhad vótaíocht/urls.py, téigh ar aghaidh agus cuir ainm_app leis chun ainmspás an fheidhmchláir a shocrú:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\napp_name = "polls"\nurlpatterns = [\n path("", views.index, name="index"),\n path("<int:question_id>/", views.detail, name="detail"),\n path("<int:question_id>/results/", views.results, name="results"),\n path("<int:question_id>/vote/", views.vote, name="vote"),\n]\nAnois athraigh do theimpléad vótaíocht/index.html ó:
polls/templates/polls/index.html<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>\nchun pointe a chur ar an radharc ainmspásáilte:
\npolls/templates/polls/index.html<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>\nAgus tú ar do chompord ag scríobh tuairimí, léigh cuid 4 den rang teagaisc seo chun na bunghnéithe a fhoghlaim maidir le próiseáil foirmeacha agus tuairimí cineálacha.
\n