Mar sin tá an ábhar tosaigh léite agat agus tá cinneadh déanta agat gur mhaith leat leanúint ar aghaidh ag úsáid Django. Níl ach an dromchla díreach scríobtha againn leis an réamhrá seo (go deimhin, má tá gach focal amháin léite agat, tá thart ar 5% den cháipéisíocht iomlán léite agat).
\nMar sin, cad atá le teacht?
\nWell, we've always been big fans of learning by doing. At this point you should\nknow enough to start a project of your own and start fooling around. As you need\nto learn new tricks, come back to the documentation. There's also a bigger\nDjango ecosystem out there for you to explore that the community has\ncreated.
\nTá an-iarracht déanta againn doiciméadú Django a dhéanamh úsáideach, soiléir agus chomh iomlán agus is féidir. Míníonn an chuid eile den doiciméad seo níos mó faoi conas a oibríonn an doiciméadú ionas gur féidir leat an leas is mó a bhaint as.
\n(Is ea, is doiciméadú é seo faoi dhoiciméid. Bígí cinnte nach bhfuil aon phlean againn doiciméad a scríobh faoi conas an doiciméad a léamh faoi dhoiciméid.)
\nTá go leor doiciméadaithe faighte ag Django -- beagnach 450,000 focal agus comhaireamh -- mar sin is deacair uaireanta a bheith ag lorg cad atá uait. Áit mhaith le tosú is ea an :tag:`genindex`. Molaimid freisin an ghné cuardaigh insuite a úsáid.
\nNó is féidir leat brabhsáil timpeall!
\nDéantar príomhdhoiciméadú Django a bhriseadh suas ina "sciopaí" atá deartha chun riachtanais éagsúla a líonadh:
\nTá an ábhar tosaigh deartha do dhaoine nach bhfuil nua do Django -- nó d'fhorbairt gréasáin go ginearálta. Ní chlúdaíonn sé aon rud domhain, ach ina ionad sin tugann sé forbhreathnú ardleibhéil ar conas a mhothaíonn forbairt i Django.
Is féidir freagraí ar cheisteanna fíor-choitianta a fháil freisin sa FAQ.
\nIs dócha gurb é seo an áit a mbeidh tú ag iarraidh an chuid is mó de do chuid ama a chaitheamh; má oibríonn tú do bhealach a dhéanamh tríd na treoracha seo ba chóir duit teacht amach agus fios agat beagnach gach rud atá ar eolas faoi Django.
\nIs minic a bhíonn forbairt gréasáin leathan, ní domhain – baineann fadhbanna le go leor réimsí. Táimid tar éis sraith de treoraithe conas a dhéanamh a fhreagraíonn coitianta "Conas a ...?" ceisteanna. Gheobhaidh tú faisnéis anseo faoi :doc: PDF a ghiniúint le Django </howto/outputting-pdf>, :doc:` ag scríobh clibeanna saincheaptha teimpléid </howto/custom-template-tags>`, agus tuilleadh.
\nIs féidir freagraí ar cheisteanna fíor-choitianta a fháil freisin sa FAQ.
\nNí chlúdaíonn na treoracha agus na bealaí le gach rang, feidhm agus modh atá ar fáil in Django -- a bheadh thar a bheith tábhachtach agus tú ag iarraidh foghlaim. Ina áit sin, coimeádtar sonraí faoi ranganna aonair, feidhmeanna, modhanna agus modúil sa reference. Seo an áit a rachaidh tú chun sonraí feidhm áirithe nó cibé rud a theastaíonn uait a fháil.
Má tá suim agat tionscadal a imscaradh le haghaidh úsáid phoiblí, tá :doc: roinnt threoracha </howto/ imscaradh/index> ag ár ndoiciméid le haghaidh socruithe éagsúla imlonnaithe chomh maith le seicliosta imlonnaithe le haghaidh roinnt rudaí a chaithfidh tú smaoineamh orthu.
Ar deireadh, tá roinnt doiciméad "speisialaithe" ann nach mbaineann le formhór na bhforbróirí de ghnáth. Áiríonn sé seo na nótaí scaoilte agus :doc: doiciméadúchán inmheánach </ intéirnigh/innéacs> dóibh siúd ar mian leo cód a chur le Django féin, agus beagán rudaí eile nach n-oireann in aon áit eile.
Díreach mar a fhorbraítear agus a fheabhsaítear bonn cód Django ar bhonn laethúil, tá feabhas leanúnach ar ár ndoiciméadú. Cuirimid feabhas ar an doiciméadú ar roinnt cúiseanna:
\nChun réitigh inneachair a dhéanamh, mar cheartúcháin ghramadaí/clóscríobh.
Eolas agus/nó samplaí a chur le rannáin atá ann cheana ar gá iad a leathnú.
Chun gnéithe Django nach bhfuil doiciméadaithe fós a dhoiciméadú. (Tá liosta na ngnéithe sin ag dul i laghad ach tá sé ann mar sin féin.)
Chun doiciméadú a chur leis le haghaidh gnéithe nua de réir mar a chuirtear gnéithe nua leis, nó de réir mar a athraíonn APInna Django nó iompraíochtaí.
Coimeádtar doiciméadú Django sa chóras rialaithe foinse céanna lena chód. Tá sé ina chónaí san eolaire :foinse:`docs` dár stór Git. Is téacschomhad ar leith é gach doiciméad ar líne sa stór.
\nIs féidir leat doiciméadú Django a léamh ar bhealaí éagsúla. Tá siad, in ord tosaíochta:
\nTá an leagan is déanaí den doiciméadú Django ina chónaí ag https://docs.djangoproject.com/en/dev/. Gintear na leathanaigh HTML seo go huathoibríoch ó na comhaid téacs atá i gceannas foinse. Ciallaíonn sé sin go léiríonn siad an "is déanaí agus is mó" i Django - áirítear iontu na ceartúcháin agus na breisithe is déanaí, agus pléann siad na gnéithe Django is déanaí, a d'fhéadfadh a bheith ar fáil d'úsáideoirí leagan forbartha Django amháin. (Féach :tag:`differences-interween-doc-versions` thíos.)
\nMolaimid duit cabhrú leis na doiciméid a fheabhsú trí athruithe, ceartúcháin agus moltaí a chur isteach sa córas ticéid. Déanann forbróirí Django monatóireacht ghníomhach ar chóras na dticéad agus úsáideann siad d'aiseolas chun an doiciméadú a fheabhsú do gach duine.
\nNote, however, that tickets should explicitly relate to the documentation,\nrather than asking broad tech-support questions. If you need help with your\nparticular Django setup, try the Django Forum or the\nDjango Discord server instead.
\nChun léamh as líne, nó ar mhaithe le caoithiúlacht amháin, is féidir leat doiciméadú Django a léamh i ngnáth-théacs.
\nMá tá scaoileadh oifigiúil de Django á úsáid agat, tá eolaire docs/ i bpacáiste zipped (tarball) an chóid, ina bhfuil na doiciméid go léir don eisiúint sin.
Má tá tú ag baint úsáide as an leagan forbartha de Django (aka an príomh-bhrainse), tá na doiciméid go léir san eolaire docs/. Is féidir leat do sheic amach Git a nuashonrú chun na hathruithe is déanaí a fháil.
Bealach amháin ísealteicneolaíochta chun leas a bhaint as doiciméadú an téacs ná úsáid a bhaint as áis Unix grep chun frása a chuardach sa doiciméadú go léir. Mar shampla, taispeánfaidh sé seo gach tagairt duit den abairt "max_length" in aon doiciméad Django:
Linux / macOS
$ grep -r max_length /path/to/django/docs/\nWindows
...\\> grep -r max_length \\path\\to\\django\\docs\\\nIs féidir leat cóip áitiúil den doiciméadú HTML a fháil tar éis roinnt céimeanna:
\nÚsáideann doiciméadú Django córas ar a dtugtar Sphinx chun aistriú ó ghnáth-théacs go HTML. Beidh ort Sphinx a shuiteáil tríd an bpacáiste a íoslódáil agus a shuiteáil ó shuíomh Gréasáin Sphinx, nó le `` pip``:
\nLinux / macOS
$ python -m pip install Sphinx\nWindows
...\\> py -m pip install Sphinx\nAnsin, bain úsáid as an Makefile san áireamh chun an doiciméadú a thiontú go HTML:
$ cd path/to/django/docs\n$ make html\nBeidh GNU Make suiteáilte uait le haghaidh seo.
\nMá tá tú ar Windows is féidir leat an baiscchomhad a úsáid mar rogha eile:
\ncd path\\to\\django\\docs\nmake.bat html\nCuirfear na doiciméid HTML i docs/_build/html.
Tá na hathruithe agus na breisithe “is déanaí agus is mó” sa doiciméadú téacs i bpríomhbhrainse stór Git. Áirítear leis na hathruithe seo doiciméadú ar ghnéithe nua atá dírithe ar an gcéad :téarma eile de chuid Django:eisiúint gné <Eisiúint Gné>. Ar an ábhar sin, is fiú ár mbeartas a chur in iúl chun aird a tharraingt ar athruithe agus ar bhreisithe le déanaí ar Django.
\nLeanaimid an polasaí seo:
\nTagann an doiciméadú forbartha ag https://docs.djangoproject.com/en/dev/ ón bpríomhbhrainse. Freagraíonn na doiciméid seo don eisiúint gné is déanaí, chomh maith le cibé gnéithe a cuireadh leis / a athraíodh sa chreat ó shin i leith.
De réir mar a chuirimid gnéithe le leagan forbartha Django, déanaimid na doiciméid a nuashonrú san idirbheart gealltanas Git céanna.
Chun idirdhealú a dhéanamh idir athruithe/breisithe gné sna doiciméid, úsáidimid an frása: "Leagan Nua i bhForbairt Django" don leagan de Django nár eisíodh fós, nó "Nua i leagan X.Y" do leaganacha eisithe.
Is féidir socruithe agus feabhsúcháin doiciméad a aisiompú go dtí an brainse eisithe is déanaí, de rogha an chumaisc, áfach, a luaithe is a bhíonn leagan de Django gan tacaíocht a thuilleadh, bhuaigh an leagan sin de na doiciméid Ní bhfaighidh tú aon nuashonruithe breise.
Cuimsíonn an príomhleathanach gréasáin doiciméadaithe naisc chuig doiciméadú le haghaidh leaganacha roimhe seo. Bí cinnte go bhfuil tú ag baint úsáide as an leagan de na doiciméid a fhreagraíonn don leagan de Django atá in úsáid agat!