{"title":"Conas comhaid statacha a bhainistiú (m.sh. íomhánna, JavaScript, CSS)","version":"6.0","locale":"ga","docname":"howto/static-files/index","url":"/ga/6.0/howto/static-files/","canonical":"https://djangodocs.dev/ga/6.0/howto/static-files/","summary":"Websites generally need to serve additional files such as images, JavaScript, or CSS. In Django, we refer to these files as \"static files\". Django provides…","html":"<h1>Conas comhaid statacha a bhainistiú (m.sh. íomhánna, JavaScript, CSS)<a class=\"heading-anchor\" href=\"#how-to-manage-static-files-e-g-images-javascript-css\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Websites generally need to serve additional files such as images, JavaScript,\nor CSS. In Django, we refer to these files as &quot;static files&quot;. Django provides\n<a class=\"reference internal\" href=\"/ga/6.0/ref/contrib/staticfiles/#module-django.contrib.staticfiles\" title=\"django.contrib.staticfiles: An app for handling static files.\"><code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">django.contrib.staticfiles</span></code></a> to help you manage them.</p>\n<p>Déanann an leathanach seo cur síos ar conas is féidir leat na comhaid statacha seo a sheirbheáil.</p>\n<section id=\"configuring-static-files\">\n<h2>Comhaid statacha a chumrú<a class=\"heading-anchor\" href=\"#configuring-static-files\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<ol class=\"arabic\">\n<li><p>Déan cinnte go bhfuil <code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.staticfiles</span></code> san áireamh i do: setting: INSTALLED_APPS.</p></li>\n<li><p>I do chomhad socruithe, sainmhínigh: setting: STATIC_URL, mar shampla:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"n\">STATIC_URL</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;static/&quot;</span>\n</code></pre></div>\n</li>\n<li><p>I do theimpléid, bain úsáid as an clib teimpléad:ttag: static chun an URL a thógáil don chonair choibhneasta tugtha ag baint úsáide as an ainm cumraithe <code class=\"docutils literal notranslate\"><span class=\"pre\">staticfiles</span></code>:setting: STORAGES.</p>\n<div class=\"code-block\" data-language=\"html+django\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Django template</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=\"Django template code\"><code><span class=\"cp\">{%</span> <span class=\"k\">load</span> <span class=\"nv\">static</span> <span class=\"cp\">%}</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">img</span> <span class=\"na\">src</span><span class=\"o\">=</span><span class=\"s\">&quot;</span><span class=\"cp\">{%</span> <span class=\"k\">static</span> <span class=\"s1\">&#39;my_app/example.jpg&#39;</span> <span class=\"cp\">%}</span><span class=\"s\">&quot;</span> <span class=\"na\">alt</span><span class=\"o\">=</span><span class=\"s\">&quot;My image&quot;</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n</li>\n<li><p>Stóráil do chuid comhad statacha i bhfillteán ar a dtugtar <code class=\"docutils literal notranslate\"><span class=\"pre\">static</span></code> i d'aip. Mar shampla <code class=\"docutils literal notranslate\"><span class=\"pre\">my_app/static/my_app/example.jpg</span></code>.</p></li>\n</ol>\n<aside class=\"admonition-serving-the-files admonition\">\n<p class=\"admonition-title\">Freastal ar na comhaid</p>\n<p>Chomh maith leis na céimeanna cumraíochta seo, beidh ort na comhaid statacha a sheirbheáil i ndáiríre.</p>\n<p>Le linn na forbartha, má úsáideann tú: mod: django.contrib.staticfiles, déanfaidh sé seo go huathoibríoch ar:djadmin: runserver nuair a shocraítear: DEBUG go True` (féach:func: django.contrib.staticfiles.views.serve).</p>\n<p>Tá an modh sean**an-neamhéifeachtúil** agus is dóchúil** neamhchinnteach**, mar sin níl sé**mí-oiriúnach le haghaidh táirgeachta**.</p>\n<p>Féach: doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>/cona/comhad statacha/imscaradh <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>le haghaidh straitéisí cearta chun comhaid statacha a sheirbheáil i dtimpeallachtaí táirgeachta.</p>\n</aside>\n<p>Is dócha go mbeidh sócmhainní statacha ag do thionscadal nach bhfuil ceangailte le aip áirithe. Chomh maith le eolaire static/` a úsáid taobh istigh de d'aipeanna, is féidir leat liosta eolairí a shainiú (:setting: STATICFILES_DIRS) i do chomhad socruithe áit a lorgfaidh Django comhaid statacha freisin. Mar shampla:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"n\">STATICFILES_DIRS</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"n\">BASE_DIR</span> <span class=\"o\">/</span> <span class=\"s2\">&quot;static&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;/var/www/static/&quot;</span><span class=\"p\">,</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Féach an doiciméadú le haghaidh socrú:setting: STATICFILES_FINDERS le haghaidh sonraí faoin gcaoi a aimsíonn <code class=\"docutils literal notranslate\"><span class=\"pre\">staticfiles</span></code> do chuid comhad.</p>\n<aside class=\"admonition-static-file-namespacing admonition\">\n<p class=\"admonition-title\">Spásáil ainmneacha comhad statach</p>\n<p>Anois is féidir linn * a bheith in ann dul amach lenár gcomhaid statacha a chur go díreach i <code class=\"docutils literal notranslate\"><span class=\"pre\">my_app/static/</span></code> (seachas fo-eolaire <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>my_app <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>eile a chruthú), ach is droch-smaoineamh a bheadh ann i ndáiríre. Úsáidfidh Django an chéad chomhad statach a aimsíonn sé a n-ainm a mheaitseálann, agus dá mbeadh comhad statach agat leis an ainm céanna in iarratas* difriol*, ní bheadh Django in ann idirdhealú a dhéanamh eatarthu. Ní mór dúinn a bheith in ann Django a chur in iúl ar an gceann ceart, agus is é an bealach is fearr chun é seo a chinntiú ná trí* spás ainmneacha iad. Is é sin, trí na comhaid statacha sin a chur taobh istigh d'eolaire eil* eile a ainmnítear don fheidhmchlár féin.</p>\n<p>&lt;staticfiles-dirs-prefixes&gt;Is féidir leat spás ainmneacha sócmhainní statacha in:setting: STATICFILES_DIRS trí:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>prefixes <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>a shonrú.</p>\n</aside>\n</section>\n<section id=\"serving-static-files-during-development\">\n<span id=\"serving-static-files-in-development\"></span><h2>Ag freastal ar chomhaid statacha le linn<a class=\"heading-anchor\" href=\"#serving-static-files-during-development\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Má úsáideann tú: mod: django.contrib.staticfiles mar a mhínítear thuas, déanfaidh: djadmin: runserver é seo go huathoibríoch nuair:setting: DEBUG socraithe go <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code>. Mura bhfuil <code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.staticfiles</span></code> agat in:setting: INSTALLED_APPS, is féidir leat comhaid statacha a sheirbheáil de láimh fós ag baint úsáide as an amharc:func: django.views.static.serve.</p>\n<p>Níl sé seo oiriúnach le húsáid táirgeachta! Maidir le roinnt straitéisí imscartha coitianta, féach:doc: /howto/static-files/deployment.</p>\n<p>Mar shampla, má shainmhínítear duit:setting: STATIC_URL mar <code class=\"docutils literal notranslate\"><span class=\"pre\">static/</span></code>, is féidir leat é seo a dhéanamh tríd an snippet seo a leanas a chur le do urls.py`:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.conf</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">settings</span>\n<span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.conf.urls.static</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">static</span>\n\n<span class=\"n\">urlpatterns</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"c1\"># ... the rest of your URLconf goes here ...</span>\n<span class=\"p\">]</span> <span class=\"o\">+</span> <span class=\"n\">static</span><span class=\"p\">(</span><span class=\"n\">settings</span><span class=\"o\">.</span><span class=\"n\">STATIC_URL</span><span class=\"p\">,</span> <span class=\"n\">document_root</span><span class=\"o\">=</span><span class=\"n\">settings</span><span class=\"o\">.</span><span class=\"n\">STATIC_ROOT</span><span class=\"p\">)</span>\n</code></pre></div>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>Ní oibríonn an fheidhm chúntóra seo ach i mód dífhabhtaithe agus ach amháin má tá an réimír a thugtar áitiúil (m.sh. static/`) agus ní URL (m.sh. <code class=\"docutils literal notranslate\"><span class=\"pre\">http://static.example.com/</span></code>).</p>\n<p>Chomh maith leis sin ní fhreastalaíonn an fheidhm chúntóra seo ach ar an bhfillteán fíor:setting: STATIC_ROOT; ní dhéanann sé fionnachtain comhaid statacha cosúil:mod: django.contrib.staticfiles.</p>\n<p>Faoi dheireadh, seirbheáltar comhaid statacha trí fhilleadh ag an gciseal feidhmchláir WSGI. Mar thoradh air sin, ní théann iarratais ar chomhaid statacha tríd an ngnáth:doc: &lt;/topics/http/middleware&gt; slabhra middleware.</p>\n</aside>\n</section>\n<section id=\"serving-files-uploaded-by-a-user-during-development\">\n<span id=\"serving-uploaded-files-in-development\"></span><h2>Freastal ar chomhaid a uaslódálann úsáideoir le linn na<a class=\"heading-anchor\" href=\"#serving-files-uploaded-by-a-user-during-development\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Le linn na forbartha, is féidir leat comhaid meán a uaslódáladh ón úsáideoir a sheirbheáil ó:setting: MEDIA_ROOT ag baint úsáide as an amharc: func: django.views.static.serve.</p>\n<p>Níl sé seo oiriúnach le húsáid táirgeachta! Maidir le roinnt straitéisí imscartha coitianta, féach:doc: /howto/static-files/deployment.</p>\n<p>Mar shampla, má shainmhínítear duit:setting: MEDIA_URL mar <code class=\"docutils literal notranslate\"><span class=\"pre\">media/</span></code>, is féidir leat é seo a dhéanamh tríd an snippet seo a leanas a chur le duit:setting: ROOT_URLCONF:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.conf</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">settings</span>\n<span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.conf.urls.static</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">static</span>\n\n<span class=\"n\">urlpatterns</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"c1\"># ... the rest of your URLconf goes here ...</span>\n<span class=\"p\">]</span> <span class=\"o\">+</span> <span class=\"n\">static</span><span class=\"p\">(</span><span class=\"n\">settings</span><span class=\"o\">.</span><span class=\"n\">MEDIA_URL</span><span class=\"p\">,</span> <span class=\"n\">document_root</span><span class=\"o\">=</span><span class=\"n\">settings</span><span class=\"o\">.</span><span class=\"n\">MEDIA_ROOT</span><span class=\"p\">)</span>\n</code></pre></div>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>Ní oibríonn an fheidhm chúntóra seo ach i mód dífhabhtaithe agus ach amháin má tá an réimír a thugtar áitiúil (m.sh. <code class=\"docutils literal notranslate\"><span class=\"pre\">media/</span></code>) agus ní URL (m.sh. <code class=\"docutils literal notranslate\"><span class=\"pre\">http://media.example.com/</span></code>).</p>\n</aside>\n</section>\n<section id=\"testing\">\n<span id=\"staticfiles-testing-support\"></span><h2>Tástáil<a class=\"heading-anchor\" href=\"#testing\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Agus tástálacha á &lt;django.test.LiveServerTestCase&gt;reáchtáil a úsáideann iarratais HTTP iarbhír in ionad an cliant tástála ionsuite (ie agus an t-ion:class: LiveServerTestCase 'á úsáid) ní mór na sócmhainní statacha a sheirbheáil feadh an chuid eile den ábhar ionas go atáirgeann an timpeallacht tástála fíor chomh dílis agus is féidir, ach níl ach feidhmiúlacht seirbhíse comhad statach an-bhunúsach aige: Níl a fhios aige faoi ghné aimsitheoirí an `````feidhmchlár staticfiles ``agus glacann sé go bhfuil an t-ábhar statach bailíodh cheana féin fao:setting: `STATIC_ROOT.</p>\n<p>Mar gheall air seo, seolann staticfiles` a chuid féin: class: django.contrib.staticFiles.Testing.staticLiveServerTestCase, fo-aicme den ceann ionsuite a bhfuil sé de chumas freastal ar na sócmhainní go trédhearcach le linn na dtástálacha seo a fhorghníomhú ar bhealach an-chosúil leis an méid a fhaighimid ag am forbartha le DEBUG = True`, ie gan gá a bhailiú iad ag baint úsáidea:djadmin: collectstatic ar dtús.</p>\n</section>\n<section id=\"deployment\">\n<h2>Imscaradh<a class=\"heading-anchor\" href=\"#deployment\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference internal\" href=\"/ga/6.0/ref/contrib/staticfiles/#module-django.contrib.staticfiles\" title=\"django.contrib.staticfiles: An app for handling static files.\"><code class=\"xref py py-mod docutils literal notranslate\"><span class=\"pre\">django.contrib.staticfiles</span></code></a> provides a convenience management command\nfor gathering static files in a single directory so you can serve them easily.</p>\n<ol class=\"arabic\">\n<li><p>Socraigh an socrú:setting: STATIC_ROOT chuig an eolaire uaidh ar mhaith leat na comhaid seo a sheirbheáil, mar shampla:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</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=\"Code code\"><code><span class=\"n\">STATIC_ROOT</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;/var/www/example.com/static/&quot;</span>\n</code></pre></div>\n</li>\n<li><p>Rith an t-ordú bainistíochta: djadmin: collectstatic:</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</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=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>manage.py<span class=\"w\"> </span>collectstatic\n</code></pre></div>\n<p>Déanfaidh sé seo gach comhad ó do fhillteáin statacha a chóipeáil isteach san eolair:setting: STATIC_ROOT.</p>\n</li>\n<li><p>Úsáid freastalaí gréasáin de do rogha chun na comhaid a sheirbheáil. :doc: /howto/static-files/deployment clúdaíonn roinnt straitéisí imscartha coitianta do chomhaid statacha.</p></li>\n</ol>\n</section>\n<section id=\"learn-more\">\n<h2>Tuilleadh eolais<a class=\"heading-anchor\" href=\"#learn-more\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Clúdaigh an doiciméad seo na buneilimintí agus roinnt patrúin úsáide coitianta Le haghaidh sonraí iomlána ar na socruithe go léir, orduithe, clibeanna teimpléad, agus píosaí eile atá san áireamh in:mod: django.contrib.staticfiles, féach: doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>the staticfiles tagair&lt;/ref/contrib/staticfiles&gt; '.</p>\n</section>","rootId":"how-to-manage-static-files-e-g-images-javascript-css","toc":[{"title":"Comhaid statacha a chumrú","anchor":"configuring-static-files","children":[]},{"title":"Ag freastal ar chomhaid statacha le linn","anchor":"serving-static-files-during-development","children":[]},{"title":"Freastal ar chomhaid a uaslódálann úsáideoir le linn na","anchor":"serving-files-uploaded-by-a-user-during-development","children":[]},{"title":"Tástáil","anchor":"testing","children":[]},{"title":"Imscaradh","anchor":"deployment","children":[]},{"title":"Tuilleadh eolais","anchor":"learn-more","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/custom-template-tags","title":"Conas clibeanna agus scagairí teimpléad saincheaptha a ch","url":"/ga/6.0/howto/custom-template-tags/"},"next":{"docname":"howto/logging","title":"Conas logáil a chumrú agus a úsáid","url":"/ga/6.0/howto/logging/"},"formats":{"html":"/ga/6.0/howto/static-files/","markdown":"/ga/6.0/howto/static-files.md","json":"/ga/6.0/howto/static-files.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/static-files/index.txt","official":"https://docs.djangoproject.com/ga/6.0/howto/static-files/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}