---
title: "Conas comhaid statacha a bhainistiú (m.sh. íomhánna, JavaScript, CSS)"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/howto/static-files/
canonical: https://djangodocs.dev/ga/5.2/howto/static-files/
---
# Conas comhaid statacha a bhainistiú (m.sh. íomhánna, JavaScript, CSS)

De ghnáth ní mór do láithreáin ghréasáin comhaid bhreise a sheirbheáil mar íomhánna, JavaScript, nó CSS. I Django, tagraímid do na comhaid seo mar “comhaid statacha”. Soláthraíonn Django: mod: django.contrib.staticfiles chun cabhrú leat iad a bhainistiú.

Déanann an leathanach seo cur síos ar conas is féidir leat na comhaid statacha seo a sheirbheáil.

## Comhaid statacha a chumrú

1. Déan cinnte go bhfuil `django.contrib.staticfiles` san áireamh i do: setting: INSTALLED\_APPS.
2. I do chomhad socruithe, sainmhínigh: setting: STATIC\_URL, mar shampla:

   ```
   STATIC_URL = "static/"
   ```
3. 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 `staticfiles`:setting: STORAGES.

   ```html+django
   {% load static %}
   <img src="{% static 'my_app/example.jpg' %}" alt="My image">
   ```
4. Stóráil do chuid comhad statacha i bhfillteán ar a dtugtar `static` i d'aip. Mar shampla `my_app/static/my_app/example.jpg`.

> **Freastal ar na comhaid**
>
> Chomh maith leis na céimeanna cumraíochta seo, beidh ort na comhaid statacha a sheirbheáil i ndáiríre.
>
> 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).
>
> 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\*\*.
>
> Féach: doc: /cona/comhad statacha/imscaradh le haghaidh straitéisí cearta chun comhaid statacha a sheirbheáil i dtimpeallachtaí táirgeachta.

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:

```
STATICFILES_DIRS = [
    BASE_DIR / "static",
    "/var/www/static/",
]
```

Féach an doiciméadú le haghaidh socrú:setting: STATICFILES\_FINDERS le haghaidh sonraí faoin gcaoi a aimsíonn `staticfiles` do chuid comhad.

> **Spásáil ainmneacha comhad statach**
>
> Anois is féidir linn \* a bheith in ann dul amach lenár gcomhaid statacha a chur go díreach i `my_app/static/` (seachas fo-eolaire my\_app 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.
>
> \<staticfiles-dirs-prefixes\>Is féidir leat spás ainmneacha sócmhainní statacha in:setting: STATICFILES\_DIRS trí:ref: prefixes a shonrú.

## Ag freastal ar chomhaid statacha le linn

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 `True`. Mura bhfuil `django.contrib.staticfiles` 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.

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.

Mar shampla, má shainmhínítear duit:setting: STATIC\_URL mar `static/`, is féidir leat é seo a dhéanamh tríd an snippet seo a leanas a chur le do urls.py\`:

```
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
```

> **Note**
>
> 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. `http://static.example.com/`).
>
> 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.
>
> 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: \</topics/http/middleware\> slabhra middleware.

## Freastal ar chomhaid a uaslódálann úsáideoir le linn na

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.

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.

Mar shampla, má shainmhínítear duit:setting: MEDIA\_URL mar `media/`, is féidir leat é seo a dhéanamh tríd an snippet seo a leanas a chur le duit:setting: ROOT\_URLCONF:

```
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
```

> **Note**
>
> 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. `media/`) agus ní URL (m.sh. `http://media.example.com/`).

## Tástáil

Agus tástálacha á \<django.test.LiveServerTestCase\>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.

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.

## Imscaradh

[`django.contrib.staticfiles`](/ga/5.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) provides a convenience management command
for gathering static files in a single directory so you can serve them easily.

1. Socraigh an socrú:setting: STATIC\_ROOT chuig an eolaire uaidh ar mhaith leat na comhaid seo a sheirbheáil, mar shampla:

   ```
   STATIC_ROOT = "/var/www/example.com/static/"
   ```
2. Rith an t-ordú bainistíochta: djadmin: collectstatic:

   ```shell
   $ python manage.py collectstatic
   ```

   Déanfaidh sé seo gach comhad ó do fhillteáin statacha a chóipeáil isteach san eolair:setting: STATIC\_ROOT.
3. Ú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.

## Tuilleadh eolais

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: the staticfiles tagair\</ref/contrib/staticfiles\> '.