---
title: "Conas Django a shuiteáil ar Windows"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/howto/windows/
canonical: https://djangodocs.dev/ga/5.2/howto/windows/
---
# Conas Django a shuiteáil ar Windows

This document will guide you through installing Python 3.14 and Django on
Windows. It also provides instructions for setting up a virtual environment,
which makes it easier to work on Python projects. This is meant as a beginner's
guide for users working on Django projects and does not reflect how Django
should be installed when developing changes for Django itself.

Rinneadh tástáil ar na céimeanna sa treoir seo le Windows 10. I leaganacha eile, bheadh na céimeanna cosúil leis. Caithfidh tú a bheith eolach ar an ordú Windows a úsáid a bhaint as pras.

## Suiteáil Python

Django is a Python web framework, thus requiring Python to be installed on your
machine. At the time of writing, Python 3.14 is the latest version.

Chun Python a shuiteáil ar do mheaisín téigh chuig <https://www.python.org/downloads/>. Ba chóir go dtabharfadh an suíomh Gréasáin cnaipe íoslódála duit don leagan Python is déanaí. Íoslódáil an suiteálaí inúsáidte agus rith é. Seiceáil na boscaí in aice le “Suiteáil lainseálaí do gach úsáideoir (moltar)” ansin cliceáil “Suiteáil Anois”.

Tar éis é a shuiteáil, oscail an ordú go pras agus seiceáil go bhfuil an leagan Python ag teacht leis an leagan a shuiteáil tú trí:

```doscon
...\> py --version
```

> **Ní aithnítear ná ní aimsítear py**
>
> Ag brath ar an gcaoi a bhfuil Python suiteáilte agat (mar shampla trí Microsoft Store), b'fhéidir nach mbeidh py\` ar fáil sa phras ordaithe.
>
> Ansin beidh ort `python` a úsáid in ionad `py` agus orduithe á iontráil agat.

> **See also**
>
> Le haghaidh tuilleadh sonraí, féach:doc: python:using/windows doiciméadú.

## Maidir le `pip`

[pip](https://pypi.org/project/pip/) is a package manager for Python and is included by default with the
Python installer. It helps to install and uninstall Python packages
(such as Django!). For the rest of the installation, we'll use `pip` to
install Python packages from the command line.

## Timpeallacht fhíorúil a bhunú

Is é an cleachtas is fearr timpeallacht thiomnaithe a sholáthar do gach tionscadal Django a chruthaíonn tú. Tá go leor roghanna ann chun timpeallachtaí agus pacáistí a bhainistiú laistigh den éiceachóras Python, moltar cuid acu sa doiciméadú Python'\_ \< <https://packaging.python.org/guides/tool-recommendations/>\>. Tagann Python féin le:doc: venv chun timpeallachtaí \<python:tutorial/venv\> a bhainistiú a úsáidfimid don treoir seo.

Chun timpeallacht fhíorúil a chruthú do do thionscadal, oscail ordú nua leid, déan nascleanúint chuig an bhfillteán inar mian leat do thionscadal a chruthú agus ansin cuir isteach iad seo a leanas:

```doscon
...\> py -m venv project-name
```

Cruthóidh sé seo fillteán ar a dtugtar 'ainm tionscadail' mura bhfuil sé ann cheana féin agus bunóidh sé an timpeallacht fhíorúil ar bun. Chun an timpeallacht a ghníomhachtú, rith:

```doscon
...\> project-name\Scripts\activate.bat
```

Cuirfear an timpeallacht fhíorúil i ngníomh agus feicfidh tú “(ainm tionscadail)” in aice leis an ordú pras chun é sin a ainmniú. Gach uair a thosaíonn tú pras ordaithe nua, beidh ort an timpeallacht a ghníomhachtú arís.

## Suiteáil Django

Is féidir Django a shuiteáil go héasca ag baint úsáide as `pip` laistigh de do thimpeallacht fhíorúil.

Sa ordú leid, cinntigh go bhfuil do thimpeallacht fhíorúil gníomhach, agus déan an t-ordú seo a leanas:

```doscon
...\> py -m pip install Django
```

Íoslódóidh agus suiteálfaidh sé seo an eisiúint Django is déanaí.

Tar éis don tsuiteáil a bheith críochnaithe, is féidir leat do shuiteáil Django a fhíorú trí django-admin --version a fhorghníomhú sa phras ordaithe.

Féach: ref: suiteáil bunachar sonraí le haghaidh faisnéise maidir le suiteáil bunachar sonraí le Django.

## Aschur críochfoirt daite

Cuireann gné cáilíochta beatha aschur daite (seachas monacrómach) leis an gcríochfort. I gcríochfoirt nua-aimseartha ba chóir go n-oibreodh sé seo do CMD agus PowerShell araon. Más gá é seo a dhíchumasú ar chúis éigin, socraigh an t-athróg comhshaoil: envvar: DJANGO\_COLORS go nocolor\`.

Ar leaganacha Windows níos sine, nó críochfoirt oidhreachta, caithfear :pypi: colorama 0.4.6+ a shuiteáil chun dathú comhréireachta a chumasú:

```doscon
...\> py -m pip install "colorama >= 0.4.6"
```

Féach: ref: syntax-coloring le haghaidh tuilleadh faisnéise faoi shocruithe dathanna.

## Gaillteanna coitianta

- Mura dtaispeánann ```django-admin ``ach an téacs cabhrach is cuma cad iad na hargóintí a thugtar air, is dócha go bhfuil fadhb ann leis an gcomhlachas comhaid i Windows. Seiceáil an bhfuil níos mó ná athróg comhshaoil amháin atá leagtha síos chun scripteanna Python a reáchtáil i `PATH```. Tarlaíonn sé seo de ghnáth nuair a bhíonn níos mó ná leagan Python amháin suiteáilte.
- Má tá tú ag nascadh leis an idirlíon taobh thiar de seachfhreastalaí, d'fhéadfadh fadhbanna a bheith ann leis an ordú \`\` py -m pip install Django\`\` a rith. Socraigh na hathróga timpeallachta le haghaidh cumraíochta seachfhreastalaí sa leid ordaithe mar seo a leanas:

  ```doscon
  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  ```
- Go ginearálta, glacann Django leis go n-úsáidtear ionchódú UTF-8 le haghaidh I/O. D'fhéadfadh fadhbanna a bheith ina chúis leis seo má tá do chóras socraithe chun ionchódú difriúil a úsáid. Ligeann leaganacha le déanaí de Python an athróg comhshaoil: envvar: PYTHONUTF8 a shocrú d'fhonn ionchódú `UTF-8` a chur i bhfeidhm. Soláthraíonn Windows 10 socrú ar fud an chórais freisin trí sheiceáil `Úsáid Unicode UTF-8 le haghaidh tacaíochta teanga ar fud an domhain` in:menuselection: Teanga -\> Socruithe Teanga Riaracháin -\> Athraigh an chórais áitiúil' i socruithe an chórais.