{"title":"Conas Django a shuiteáil ar Windows","version":"5.2","locale":"ga","docname":"howto/windows","url":"/ga/5.2/howto/windows/","canonical":"https://djangodocs.dev/ga/5.2/howto/windows/","summary":"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…","html":"<h1>Conas Django a shuiteáil ar Windows<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>This document will guide you through installing Python 3.14 and Django on\nWindows. It also provides instructions for setting up a virtual environment,\nwhich makes it easier to work on Python projects. This is meant as a beginner's\nguide for users working on Django projects and does not reflect how Django\nshould be installed when developing changes for Django itself.</p>\n<p>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.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><h2>Suiteáil Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django is a Python web framework, thus requiring Python to be installed on your\nmachine. At the time of writing, Python 3.14 is the latest version.</p>\n<p>Chun Python a shuiteáil ar do mheaisín téigh chuig <a class=\"reference external\" href=\"https://www.python.org/downloads/\">https://www.python.org/downloads/</a>. 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”.</p>\n<p>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í:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition-py-is-not-recognized-or-found admonition\">\n<p class=\"admonition-title\">Ní aithnítear ná ní aimsítear <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span></code></p>\n<p>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.</p>\n<p>Ansin beidh ort <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span></code> a úsáid in ionad <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span></code> agus orduithe á iontráil agat.</p>\n</aside>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">See also</p>\n<p>Le haghaidh tuilleadh sonraí, féach:doc: python:using/windows doiciméadú.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2>Maidir le <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code><a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"extlink-pypi reference external\" href=\"https://pypi.org/project/pip/\">pip</a> is a package manager for Python and is included by default with the\nPython installer. It helps to install and uninstall Python packages\n(such as Django!). For the rest of the installation, we'll use <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> to\ninstall Python packages from the command line.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>Timpeallacht fhíorúil a bhunú<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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'_ &lt; <a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">https://packaging.python.org/guides/tool-recommendations/</a>&gt;. Tagann Python féin le:doc: venv chun timpeallachtaí &lt;python:tutorial/venv&gt; a bhainistiú a úsáidfimid don treoir seo.</p>\n<p>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:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>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:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>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.</p>\n</section>\n<section id=\"install-django\">\n<h2>Suiteáil Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Is féidir Django a shuiteáil go héasca ag baint úsáide as <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> laistigh de do thimpeallacht fhíorúil.</p>\n<p>Sa ordú leid, cinntigh go bhfuil do thimpeallacht fhíorúil gníomhach, agus déan an t-ordú seo a leanas:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>Íoslódóidh agus suiteálfaidh sé seo an eisiúint Django is déanaí.</p>\n<p>Tar éis don tsuiteáil a bheith críochnaithe, is féidir leat do shuiteáil Django a fhíorú trí <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>django-admin --version <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>a fhorghníomhú sa phras ordaithe.</p>\n<p>Féach: ref: suiteáil bunachar sonraí le haghaidh faisnéise maidir le suiteáil bunachar sonraí le Django.</p>\n</section>\n<section id=\"colored-terminal-output\">\n<h2>Aschur críochfoirt daite<a class=\"heading-anchor\" href=\"#colored-terminal-output\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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`.</p>\n<p>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ú:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install <span class=\"s2\">&quot;colorama &gt;= 0.4.6&quot;</span>\n</code></pre></div>\n<p>Féach: ref: syntax-coloring le haghaidh tuilleadh faisnéise faoi shocruithe dathanna.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Gaillteanna coitianta<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>Mura dtaispeánann <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">``ach</span> <span class=\"pre\">an</span> <span class=\"pre\">téacs</span> <span class=\"pre\">cabhrach</span> <span class=\"pre\">is</span> <span class=\"pre\">cuma</span> <span class=\"pre\">cad</span> <span class=\"pre\">iad</span> <span class=\"pre\">na</span> <span class=\"pre\">hargóintí</span> <span class=\"pre\">a</span> <span class=\"pre\">thugtar</span> <span class=\"pre\">air,</span> <span class=\"pre\">is</span> <span class=\"pre\">dócha</span> <span class=\"pre\">go</span> <span class=\"pre\">bhfuil</span> <span class=\"pre\">fadhb</span> <span class=\"pre\">ann</span> <span class=\"pre\">leis</span> <span class=\"pre\">an</span> <span class=\"pre\">gcomhlachas</span> <span class=\"pre\">comhaid</span> <span class=\"pre\">i</span> <span class=\"pre\">Windows.</span> <span class=\"pre\">Seiceáil</span> <span class=\"pre\">an</span> <span class=\"pre\">bhfuil</span> <span class=\"pre\">níos</span> <span class=\"pre\">mó</span> <span class=\"pre\">ná</span> <span class=\"pre\">athróg</span> <span class=\"pre\">comhshaoil</span> <span class=\"pre\">amháin</span> <span class=\"pre\">atá</span> <span class=\"pre\">leagtha</span> <span class=\"pre\">síos</span> <span class=\"pre\">chun</span> <span class=\"pre\">scripteanna</span> <span class=\"pre\">Python</span> <span class=\"pre\">a</span> <span class=\"pre\">reáchtáil</span> <span class=\"pre\">i</span> <span class=\"pre\">`PATH</span></code>. Tarlaíonn sé seo de ghnáth nuair a bhíonn níos mó ná leagan Python amháin suiteáilte.</p></li>\n<li><p>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:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n<li><p>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ú <code class=\"docutils literal notranslate\"><span class=\"pre\">UTF-8</span></code> a chur i bhfeidhm. Soláthraíonn Windows 10 socrú ar fud an chórais freisin trí sheiceáil <code class=\"docutils literal notranslate\"><span class=\"pre\">Úsáid</span> <span class=\"pre\">Unicode</span> <span class=\"pre\">UTF-8</span> <span class=\"pre\">le</span> <span class=\"pre\">haghaidh</span> <span class=\"pre\">tacaíochta</span> <span class=\"pre\">teanga</span> <span class=\"pre\">ar</span> <span class=\"pre\">fud</span> <span class=\"pre\">an</span> <span class=\"pre\">domhain</span></code> in:menuselection: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>Teanga -&gt; Socruithe Teanga Riaracháin -&gt; Athraigh an chórais áitiúil' i socruithe an chórais.</p></li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"Suiteáil Python","anchor":"install-python","children":[]},{"title":"Maidir le pip","anchor":"about-pip","children":[]},{"title":"Timpeallacht fhíorúil a bhunú","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"Suiteáil Django","anchor":"install-django","children":[]},{"title":"Aschur críochfoirt daite","anchor":"colored-terminal-output","children":[]},{"title":"Gaillteanna coitianta","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/5.2/howto/"}],"prev":{"docname":"howto/upgrade-version","title":"Conas Django a uasghrádú go leagan níos nuaí","url":"/ga/5.2/howto/upgrade-version/"},"next":{"docname":"howto/deployment/index","title":"Conas Django a imscaradh","url":"/ga/5.2/howto/deployment/"},"formats":{"html":"/ga/5.2/howto/windows/","markdown":"/ga/5.2/howto/windows.md","json":"/ga/5.2/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/ga/5.2/howto/windows/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}