---
title: "Cad atá le léamh ina dhiaidh sin"
version: 6.0
locale: ga
source: https://docs.djangoproject.com/ga/6.0/intro/whatsnext/
canonical: https://djangodocs.dev/ga/6.0/intro/whatsnext/
---
# Cad atá le léamh ina dhiaidh sin

Mar sin tá an [ábhar tosaigh](/ga/6.0/intro/) 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).

Mar sin, cad atá le teacht?

Well, we've always been big fans of learning by doing. At this point you should
know enough to start a project of your own and start fooling around. As you
need to learn new tricks, come back to the documentation. There's also a bigger
[Django ecosystem](https://www.djangoproject.com/community/ecosystem/) out there for you to explore that the community has
created.

Tá 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.

(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.)

## Doiciméadú a aimsiú

Tá *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 . Molaimid freisin an ghné cuardaigh insuite a úsáid.

Nó is féidir leat brabhsáil timpeall!

## Conas a eagraítear na doiciméid

Déantar príomhdhoiciméadú Django a bhriseadh suas ina "sciopaí" atá deartha chun riachtanais éagsúla a líonadh:

- Tá an [ábhar tosaigh](/ga/6.0/intro/) 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](/ga/6.0/faq/).

  Is 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.
- Is 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](/ga/6.0/howto/) 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.

  Is féidir freagraí ar cheisteanna fíor-choitianta a fháil freisin sa [FAQ](/ga/6.0/faq/).
- Ní 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](/ga/6.0/ref/). 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](/ga/6.0/releases/) 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](/ga/6.0/misc/).

## Conas a nuashonraítear doiciméadú

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:

- Chun 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  dár stór Git. Is téacschomhad ar leith é gach doiciméad ar líne sa stór.

## Cá háit le fáil

Is féidir leat doiciméadú Django a léamh ar bhealaí éagsúla. Tá siad, in ord tosaíochta:

### Ar an ngréasán

Tá 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  thíos.)

Molaimid duit cabhrú leis na doiciméid a fheabhsú trí athruithe, ceartúcháin agus moltaí a chur isteach sa [córas ticéid](https://code.djangoproject.com/). 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.

Note, however, that tickets should explicitly relate to the documentation,
rather than asking broad tech-support questions. If you need help with your
particular Django setup, try the [Django Forum](https://forum.djangoproject.com/) or the
[Django Discord server](https://chat.djangoproject.com) instead.

### I ngnáth-théacs

Chun 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.

Má 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:

```console
$ grep -r max_length /path/to/django/docs/
```

*Windows*

```doscon
...\> grep -r max_length \path\to\django\docs\
```

### Mar HTML, go háitiúil

Is féidir leat cóip áitiúil den doiciméadú HTML a fháil tar éis roinnt céimeanna:

- Úsáideann doiciméadú Django córas ar a dtugtar [Sphinx](https://www.sphinx-doc.org/) 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\`\`:

  ```console
  $ python -m pip install Sphinx
  ```

  *Windows*

  ```doscon
  ...\> py -m pip install Sphinx
  ```
- Ansin, bain úsáid as an `Makefile` san áireamh chun an doiciméadú a thiontú go HTML:

  ```console
  $ cd path/to/django/docs
  $ make html
  ```

  Beidh [GNU Make](https://www.gnu.org/software/make/) suiteáilte uait le haghaidh seo.

  Má tá tú ar Windows is féidir leat an baiscchomhad a úsáid mar rogha eile:

  ```bat
  cd path\to\django\docs
  make.bat html
  ```
- Cuirfear na doiciméid HTML i `docs/_build/html`.

## Difríochtaí idir leaganacha

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.

Leanaimid an polasaí seo:

- Tagann 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](/ga/6.0/internals/release-process/#supported-versions-policy), bhuaigh an leagan sin de na doiciméid Ní bhfaighidh tú aon nuashonruithe breise.
- Cuimsíonn an [príomhleathanach gréasáin doiciméadaithe](https://docs.djangoproject.com/en/dev/) 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!