Scríobh do chéad ranníocaíocht do DjangoLink to this heading#

RéamhráLink to this heading#

Interested in giving back to the community a little? Maybe you've found a bug in Django that you'd like to see fixed, or maybe there's a small feature you want added (but remember that proposals for new features should follow the process for suggesting new features).

Is é an bealach is fearr chun do chuid imní féin a fheiceáil ag cur ar ais chuig Django féin. D'fhéadfadh sé seo cosúil daunting ar dtús, ach tá sé ina cosán dea-thaistil le doiciméadú, tooling, agus pobal chun tacú leat. Siúlfaimid tú tríd an bpróiseas ar fad, ionas gur féidir leat foghlaim trí shampla.

Cód IompairLink to this heading#

Mar ranníocóir, is féidir leat cabhrú linn pobal Django a choinneáil oscailte agus cuimsitheach. Léigh agus lean ár Cód Iompair.

Git á shuiteáilLink to this heading#

Don rang teagaisc seo, beidh ort Git suiteáilte chun an leagan forbartha reatha de Django a íoslódáil agus brainse a ghiniúint do na hathruithe a dhéanann tú.

Chun seiceáil an bhfuil Git suiteáilte agat nó nach bhfuil, cuir git isteach i líne na n-orduithe. Má fhaigheann tú teachtaireachtaí ag rá nach bhféadfaí an t-ordú seo a aimsiú, beidh ort é a íoslódáil agus a shuiteáil, féach `Leathanach íoslódála Git`__.

Mura bhfuil tú chomh eolach sin ar Git, is féidir leat níos mó a fháil amach i gcónaí faoina orduithe (nuair atá sé suiteáilte) trí cabhair git a chlóscríobh isteach i líne na n-orduithe.

Cóip de leagan forbartha Django a fháilLink to this heading#

Is é an chéad chéim chun cur le Django ná cóip den bhunchód a fháil. Ar dtús, `forc Django ar GitHub < https://github.com/django/django/fork>`__. Ansin, ón líne ordaithe, bain úsáid as an ordú `` cd`` chun dul chuig an eolaire ina mbeidh tú ag iarraidh go mbeadh do chóip áitiúil de Django beo.

Íoslódáil stór cód foinse Django ag baint úsáide as an ordú seo a leanas:

$ git clone https://github.com/YourGitHubName/django.git

...\> git clone https://github.com/YourGitHubName/django.git

Anois go bhfuil cóip áitiúil de Django agat, is féidir leat é a shuiteáil díreach mar a dhéanfá aon phacáiste a shuiteáil ag baint úsáide as pip. Is é an bealach is áisiúla chun é sin a dhéanamh ná trí *virtual environment *a úsáid, ar gné é atá tógtha isteach i Python a ligeann duit eolaire ar leith de phacáistí suiteáilte a choinneáil do gach ceann de do thionscadail ionas nach gcuirfidh siad isteach ar a chéile.

Is smaoineamh maith é do thimpeallachtaí fíorúla go léir a choinneáil in aon áit amháin, mar shampla i .virtualenvs/ i d'eolaire baile.

Cruthaigh timpeallacht fhíorúil nua trí na nithe seo a leanas a rith:

$ python3 -m venv ~/.virtualenvs/djangodev

...\> py -m venv %HOMEPATH%\.virtualenvs\djangodev

Is é an cosán an áit a sábhálfar an timpeallacht nua ar do ríomhaire.

Is é an chéim dheiridh maidir le do thimpeallacht fhíorúil a bhunú ná é a ghníomhachtú:

$ source ~/.virtualenvs/djangodev/bin/activate

Mura bhfuil an t-ordú `` foinse`` ar fáil, is féidir leat triail a bhaint as ponc ina ionad sin:

$ . ~/.virtualenvs/djangodev/bin/activate

Caithfidh tú an timpeallacht fhíorúil a ghníomhachtú aon uair a osclaíonn tú fuinneog teirminéil nua.

Taispeántar ainm na timpeallachta fíorúla atá gníomhachtaithe faoi láthair ar líne na n-orduithe chun cabhrú leat súil a choinneáil ar an gceann atá in úsáid agat. Déanfar aon rud a shuiteálann tú trí pip agus an t-ainm seo ar taispeáint a shuiteáil sa timpeallacht fhíorúil sin, scoite amach ó thimpeallachtaí eile agus ó phacáistí ar fud an chórais.

Téigh ar aghaidh agus suiteáil an chóip chlónáilte de Django roimhe seo:

$ python -m pip install -e /path/to/your/local/clone/django/

...\> py -m pip install -e \path\to\your\local\clone\django\

The installed version of Django is now pointing at your local copy by installing in editable mode. You will immediately see any changes you make to it, which is of great help when testing your first contribution.

Seomra tástála Django a reáchtáil den chéad uairLink to this heading#

Agus tú ag cur le Django tá sé an-tábhachtach nach dtugann d'athruithe cód fabhtanna isteach i réimsí eile de Django. Bealach amháin chun a sheiceáil go n-oibríonn Django fós tar éis duit do chuid athruithe a dhéanamh ná trí shraith tástála Django a reáchtáil. Má éiríonn leis na tástálacha go léir fós, is féidir leat a bheith réasúnta cinnte go n-oibríonn do chuid athruithe agus nár bhris tú codanna eile de Django. Mura ritheann tú sraith tástála Django riamh roimhe seo, is smaoineamh maith é a reáchtáil uair amháin roimh ré chun dul i dtaithí ar a aschur.

Sula ritheann tú an tsraith tástála, iontráil an chomhadlann Django tests/ ag baint úsáide as an ordú cd tests, agus suiteáil spleáchais tástála trí rith:

$ python -m pip install -r requirements/py3.txt

...\> py -m pip install -r requirements\py3.txt

Má thagann tú ar earráid le linn na suiteála, d'fhéadfadh spleáchas a bheith in easnamh ar do chóras le haghaidh ceann amháin nó níos mó de na pacáistí Python. Téigh i gcomhairle le doiciméadú an phacáiste a bhfuil ag teip air nó cuardaigh an gréasán leis an teachtaireacht earráide a thagann ort.

Anois táimid réidh leis an tsraith tástála a rith:

$ ./runtests.py

...\> runtests.py 

Now sit back and relax. Django's entire test suite has thousands of tests, and it takes at least a few minutes to run, depending on the speed of your computer.

While Django's test suite is running, you'll see a stream of characters representing the status of each test as it completes. E indicates that an error was raised during a test, and F indicates that a test's assertions failed. Both of these are considered to be test failures. Meanwhile, x and s indicate expected failures and skipped tests, respectively. Dots indicate passing tests.

Go hiondúil is mar gheall ar leabharlanna seachtracha a bhíonn ag teastáil chun an tástáil a rith a bhíonn na trialacha scipeála in easnamh; féach Na tástálacha go léir á rith le haghaidh liosta spleáchais agus bí cinnte go suiteálann tú ceann ar bith do thástálacha a bhaineann leis na hathruithe atá á dhéanamh agat (ní bheidh aon ghá againn don rang teagaisc seo). Baineann roinnt tástálacha go sonrach le hinneal bunachair shonraí ar leith agus déanfar iad a scipeáil mura ndéantar iad a thástáil leis an inneall sin. Is é SQLite inneall an bhunachair shonraí do na socruithe réamhshocraithe. Chun na trialacha a rith ag baint úsáide as inneall difriúil, féach :tag:`running-unit-tests-settings`.

Nuair a bheidh na trialacha críochnaithe, ba chóir teachtaireacht a chur chugat ag cur in iúl duit cé acu ar éirigh nó nár éirigh leis an tsraith tástála. Ós rud é nach bhfuil aon athruithe déanta agat fós ar chód Django, ba chóir go mbeadh an tsraith tástála ar fad **ba chóir ** pas a fháil. Má fhaigheann tú teipeanna nó earráidí déan cinnte gur lean tú gach ceann de na céimeanna roimhe seo i gceart. Féach Tástálacha aonaid a rith le haghaidh tuilleadh eolais.

Tabhair faoi deara go mb'fhéidir nach mbeadh an brainse "príomh" Django is déanaí cobhsaí i gcónaí. Agus tú ag forbairt i gcoinne "príomh", is féidir leat Tógann comhtháthú leanúnach Django a sheiceáil __ chun a chinneadh an bhfuil na teipeanna sonrach do do mheaisín nó má tá siad i láthair freisin i dtógáil oifigiúil Django. Má chliceálann tú chun amharc ar thógáil ar leith, is féidir leat féachaint ar an "Maitrís Cumraíochta" a thaispeánann teipeanna briste síos de réir leagan Python agus inneall bunachar sonraí.

Working on an approved new featureLink to this heading#

For this tutorial, we'll work on a "fake accepted ticket" as a case study. Here are the imaginary details:

Cuirfimid an ghné seo agus na trialacha gaolmhara i bhfeidhm anois.

Brainse a chruthúLink to this heading#

Sula ndéanfaidh tú aon athruithe, cruthaigh brainse nua don ticéad:

$ git checkout -b ticket_99999

...\> git checkout -b ticket_99999

Is féidir leat aon ainm is mian leat a roghnú don bhrainse, is sampla é "ticket_99999". Beidh na hathruithe ar fad a dhéanfar sa bhrainse seo sonrach don ticéad agus ní bheidh tionchar acu ar an bpríomhchóip den chód a chlónáil muid níos luaithe.

Scríobh roinnt tástálacha do do thicéadLink to this heading#

In most cases, for a contribution to be accepted into Django it has to include tests. For bug fix contributions, this means writing a regression test to ensure that the bug is never reintroduced into Django later on. A regression test should be written in such a way that it will fail while the bug still exists and pass once the bug has been fixed. For contributions containing new features, you'll need to include tests which ensure that the new features are working correctly. They too should fail when the new feature is not present, and then pass once it has been implemented.

Bealach maith chun é seo a dhéanamh ná do thástálacha nua a scríobh ar dtús, sula ndéanann tú aon athruithe ar an gcód. Tugtar forbairt faoi thionchar tástála ar an stíl forbartha seo agus is féidir é a chur i bhfeidhm ar thionscadail iomlána agus ar athruithe aonair araon. Tar éis duit do chuid tástálacha a scríobh, ritheann tú leo ansin chun a chinntiú go dteipeann orthu go deimhin (ós rud é nach bhfuil an fabht sin socraithe agat nó gur chuir tú an ghné sin leis go fóill). Mura dteipeann ar do thástálacha nua, beidh ort iad a shocrú ionas go ndéanfaidh siad. Tar éis an tsaoil, níl tástáil aischéimnithí a théann beag beann ar cibé an bhfuil fabht i láthair an-chabhrach chun cosc a chur ar an fabht sin dul síos an bóthar.

Anois le haghaidh ár lámha-ar shampla.

from django.shortcuts import make_toast
from django.test import SimpleTestCase


class MakeToastTests(SimpleTestCase):
    def test_make_toast(self):
        self.assertEqual(make_toast(), "toast")

$ ./runtests.py shortcuts

...\> runtests.py shortcuts

ImportError: cannot import name 'make_toast' from 'django.shortcuts'

Scríobh an cód do do thicéadLink to this heading#

Ansin cuirfimid an fheidhm make_toast() leis.

Déan nascleanúint go dtí an fillteán django/ agus oscail an comhad aicearraí.py. Ag an mbun, cuir leis:

def make_toast():
    return "toast"

Anois ní mór dúinn a chinntiú go dtéann an tástáil a scríobh muid níos luaithe, ionas gur féidir linn a fheiceáil an bhfuil an cód a chuir muid leis ag obair i gceart. Arís, téigh chuig eolaire Django tests/ agus rith:

$ ./runtests.py shortcuts

...\> runtests.py shortcuts

Ba chóir go mbeadh gach rud pas a fháil. Mura bhfuil, cinntigh gur chuir tú an fheidhm leis an gcomhad ceart i gceart.

Seomra tástála Django a reáchtáil don dara huairLink to this heading#

Once you've verified that your changes and test are working correctly, it's a good idea to run the entire Django test suite to verify that your change hasn't introduced any bugs into other areas of Django. While successfully passing the entire test suite doesn't guarantee your code is bug free, it does help identify many bugs and regressions that might otherwise go unnoticed.

Chun an tsraith tástála Django ar fad a reáchtáil, cd isteach san eolaire Django tests/ agus rith:

$ ./runtests.py

...\> runtests.py 

Cáipéisíocht ScríbhneoireachtaLink to this heading#

Is gné nua é seo, mar sin ba chóir é a dhoiciméadú. Oscail an comhad docs/topics/http/shortcuts.txt agus cuir an méid seo a leanas ag deireadh an chomhaid:

``make_toast()``
================

.. function:: make_toast()

.. versionadded:: 6.2

Returns ``'toast'``.

Since this new feature will be in an upcoming release it is also added to the release notes for the next version of Django. Open the release notes for the latest version in docs/releases/, which at time of writing is 6.2.txt. Add a note under the "Minor Features" header:

:mod:`django.shortcuts`
~~~~~~~~~~~~~~~~~~~~~~~

* The new :func:`django.shortcuts.make_toast` function returns ``'toast'``.

Chun tuilleadh eolais a fháil ar cháipéisíocht scríbhneoireachta, lena n-áirítear míniú ar cad atá i gceist leis an ngiolc versionadded, féach :d oc:'/internals/contributing/writing-documentation'. Cuimsíonn an leathanach sin míniú freisin ar conas cóip de na doiciméid a thógáil go háitiúil, ionas gur féidir leat réamhamharc a dhéanamh ar an HTML a ghinfear.

Réamhamharc ar do chuid athruitheLink to this heading#

Anois tá sé in am athbhreithniú a dhéanamh ar na hathruithe atá déanta sa chraobh. Chun na hathruithe go léir a chur ar stáitse réidh le tiomantas, rith:

$ git add --all

...\> git add --all

Ansin taispeáin na difríochtaí idir do chóip reatha de Django (le do chuid athruithe) agus an t-athbhreithniú a sheiceáil tú ar dtús níos luaithe sa rang teagaisc le:

$ git diff --cached

...\> git diff --cached

Bain úsáid as na heochracha arrow chun bogadh suas agus síos.

diff --git a/django/shortcuts.py b/django/shortcuts.py
index 7ab1df0e9d..8dde9e28d9 100644
--- a/django/shortcuts.py
+++ b/django/shortcuts.py
@@ -156,3 +156,7 @@ def resolve_url(to, *args, **kwargs):

     # Finally, fall back and assume it's a URL
     return to
+
+
+def make_toast():
+    return 'toast'
diff --git a/docs/releases/6.2.txt b/docs/releases/6.2.txt
index 7d85d30c4a..81518187b3 100644
--- a/docs/releases/6.2.txt
+++ b/docs/releases/6.2.txt
@@ -34,6 +34,11 @@
 Minor features
 --------------

+:mod:`django.shortcuts`
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* The new :func:`django.shortcuts.make_toast` function returns ``'toast'``.
+
 :mod:`django.contrib.admin`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/docs/topics/http/shortcuts.txt b/docs/topics/http/shortcuts.txt
index 7b3a3a2c00..711bf6bb6d 100644
--- a/docs/topics/http/shortcuts.txt
+++ b/docs/topics/http/shortcuts.txt
@@ -271,3 +271,12 @@ This example is equivalent to::
         my_objects = list(MyModel.objects.filter(published=True))
         if not my_objects:
             raise Http404("No MyModel matches the given query.")
+
+``make_toast()``
+================
+
+.. function:: make_toast()
+
+.. versionadded:: 6.2
+
+Returns ``'toast'``.
diff --git a/tests/shortcuts/test_make_toast.py b/tests/shortcuts/test_make_toast.py
new file mode 100644
index 0000000000..6f4c627b6e
--- /dev/null
+++ b/tests/shortcuts/test_make_toast.py
@@ -0,0 +1,7 @@
+from django.shortcuts import make_toast
+from django.test import SimpleTestCase
+
+
+class MakeToastTests(SimpleTestCase):
+    def test_make_toast(self):
+        self.assertEqual(make_toast(), 'toast')

Nuair a bhíonn réamhamharc déanta agat ar na hathruithe, buail an eochair q chun filleadh ar líne na n-orduithe. Má d'fhéach an diff ceart go leor, tá sé in am na hathruithe a dhéanamh.

Na hathruithe a dhéanamhLink to this heading#

Chun na hathruithe a ghealladh:

$ git commit

...\> git commit

Osclaíonn sé seo eagarthóir téacs chun an teachtaireacht tiomantais a chlóscríobh. Lean an commit message guidelines agus scríobh teachtaireacht mar seo a leanas:

Fixed #99999 -- Added a shortcut function to make toast.

An tiomantas a bhrú agus iarratas tarraingthe a dhéanamhLink to this heading#

Tar éis duit na hathruithe a dhéanamh, seol chuig do forc é ar GitHub (cuir "ticket_99999" in ionad ainm do bhrainse má tá sé difriúil):

$ git push origin ticket_99999

...\> git push origin ticket_99999

Is féidir leat iarratas tarraingthe a chruthú trí chuairt a thabhairt ar an leathanach Django GitHub. Feicfidh tú do chraobh faoi "Do chraobhacha a bhrúitear le déanaí". Cliceáil "Déan comparáid idir & iarratas tarraingt" in aice leis.

Ná déan é don rang teagaisc seo le do thoil, ach ar an gcéad leathanach eile a thaispeánann réamhamharc ar na hathruithe, chliceáilfeá "Cruthaigh iarratas tarraingthe".

Na chéad chéimeanna eileLink to this heading#

Comhghairdeas, d'fhoghlaim tú conas iarratas tarraingthe a dhéanamh chuig Django! Tá sonraí faoi theicnící níos forbartha a d'fhéadfadh a bheith ag teastáil uait in :d oc:/internals/contributing/writing-code/working-with-git.

Anois is féidir leat na scileanna sin a úsáid go maith trí chabhrú le codebase Django a fheabhsú.