---
title: "Feidhmeanna ``django.urls ``le húsáid in URLConfs"
version: 6.0
locale: ga
source: https://docs.djangoproject.com/ga/6.0/ref/urls/
canonical: https://djangodocs.dev/ga/6.0/ref/urls/
---
# Feidhmeanna django.urls le húsáid in URLConfs

## cosán () \`\`

#### `path(route, view, kwargs=None, name=None)`

Tugann eilimint ar ais lena n-áireamh in `urlpatterns`. Mar shampla:

```
from django.urls import include, path

urlpatterns = [
    path("index/", views.index, name="main-view"),
    path("bio/<username>/", views.bio, name="bio"),
    path("articles/<slug:title>/", views.article, name="article-detail"),
    path("articles/<slug:title>/<int:section>/", views.section, name="article-section"),
    path("blog/", include("blog.urls")),
    ...,
]
```

### `beala`

The `route` argument should be a string or
[`gettext_lazy()`](/ga/6.0/ref/utils/#django.utils.translation.gettext_lazy) (see
[Patrúin URL a aistriú](/ga/6.0/topics/i18n/translation/#translating-urlpatterns)) that contains a URL pattern. The string
may contain angle brackets (like `<username>` above) to capture part of the
URL and send it as a keyword argument to the view. The angle brackets may
include a converter specification (like the `int` part of `<int:section>`)
which limits the characters matched and may also change the type of the
variable passed to the view. For example, `<int:section>` matches a string
of decimal digits and converts the value to an `int`.

Agus iarratas á phróiseáil, tosaíonn Django ag an gcéad phatrún in urlpatterns agus déanann sé a bhealach síos an liosta, ag comparáid idir an URL iarrtha i gcoinne gach patrún go dtí go bhfaigheann sé ceann a mheaitseálann. Féach: ref: how django-processes-a-request le haghaidh tuilleadh sonraí.

Ní mheaitseálann patrúin paraiméadair GET agus POST, nó an t-ainm fearainn. Mar shampla, in iarratas chuig `https://www.example.com/myapp/`, cuardóidh an URLConf `myapp/`. In iarratas chuig `https://www.example.com/myapp/?page=3`, cuardóidh an URLConf `myapp/` freisin.

### `` `amharc ``

Is feidhm amharc é an argóint `view` nó toradh de:meth: ~django.views.generic.base.view.as\_view le haghaidh tuairimí rang-bhunaithe. Is féidir é a bheith freisin a:func: django.urls.include.

Nuair a aimsíonn Django patrún meaitseála, glaonn sé an fheidhm amharc sonraithe le réad an:class: ~django.http.http.httpRequest mar an chéad argóint agus aon luachanna “gabháilte” ón mbealach mar argóintí eochairfhocal.

### `` `Kwargs ``

Ligeann an argóint kwargs duit argóintí breise a chur ar aghaidh chuig an bhfeidhm nó an modh amharc. Féach:ref: views-extra-options mar shampla.

### ainm \`

Ligeann ainmniú do URL duit tagairt a dhéanamh dó gan amhbhrí ó áiteanna eile i Django, go háirithe ó theimpléid laistigh de. Ligeann an ghné chumhachtach seo duit athruithe domhanda a dhéanamh ar phatrúin URL do thionscadail agus gan teagmháil le comhad amháin.

Féach:ref: Patrúin URL a ainmniúch \<naming-url-patterns\>\`maidir le cén fáth go bhfuil an argóint ainm úsáideach.

## re\_path () \`\`

#### `re_path(route, view, kwargs=None, name=None)`

Tugann eilimint ar ais lena n-áireamh in `urlpatterns`. Mar shampla:

```
from django.urls import include, re_path

urlpatterns = [
    re_path(r"^index/$", views.index, name="index"),
    re_path(r"^bio/(?P<username>\w+)/$", views.bio, name="bio"),
    re_path(r"^blog/", include("blog.urls")),
    ...,
]
```

The `route` argument should be a string or
[`gettext_lazy()`](/ga/6.0/ref/utils/#django.utils.translation.gettext_lazy) (see
[Patrúin URL a aistriú](/ga/6.0/topics/i18n/translation/#translating-urlpatterns)) that contains a regular expression compatible
with Python's [`re`](https://docs.python.org/3/library/re.html#module-re) module. Strings typically use raw string syntax
(`r''`) so that they can contain sequences like `\d` without the need to
escape the backslash with another backslash. When a match is made, captured
groups from the regular expression are passed to the view -- as named arguments
if the groups are named, and as positional arguments otherwise. The values are
passed as strings, without any type conversion.

When a `route` ends with `$` the whole requested URL, matching against
[`path_info`](/ga/6.0/ref/request-response/#django.http.HttpRequest.path_info), must match the regular expression
pattern ([`re.fullmatch()`](https://docs.python.org/3/library/re.html#re.fullmatch) is used).

The `view`, `kwargs` and `name` arguments are the same as for
[`path()`](#django.urls.path).

## san áireamh () \`

#### `include(module, namespace=None)`

#### `include(pattern_list)`

#### `include((pattern_list, app_namespace), namespace=None)`

Feidhm a thógann cosán iomlán allmhairithe Python chuig modúl URLConf eile ba chóir a bheith “san áireamh” san áit seo. Go roghnach, is féidir an:term: spás ainmneacha feidhmchláir agus:term: spás ainmneacha sampla ina gcuirfear na hiontrálacha san áireamh iontu a shonrú freisin.

De ghnáth, ba cheart an modúl san áireamh spás ainmneacha an fheidhmchláir a shonrú. Má shocraítear spás ainmneacha feidhmchláir, is féidir an argóint spás ainmneacha a úsáid chun spás ainmneacha sampla difriúil a shocrú.

Glacann include () mar argóint freisin le hathrinneach a thugann patrúin URL ar ais nó le 2-tuple ina bhfuil athraitheach den sórt sin móide ainmneacha spás ainmneacha an fheidhmchláir.

**Paraiméadair:** - `module` -- Modúl URLConf (nó ainm an mhodúil)
- `namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) -- Spás ainmneacha sampla do na hiontrálacha URL atá san áireamh
- `pattern_list` -- Inathraithe o:func: ~django.urls.path agus/nó :func: ~django.urls.re\_path cásanna.
- `app_namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) -- Spás ainmneacha feidhmchláir do na hiontrálacha URL atá san áireamh

Féach:ref: including-ear-urlconfs agus:ref: spaces-ainmnea-agus-include.

## tiontaire\_cláraigh () \`\`

#### `register_converter(converter, type_name)`

The function for registering a converter for use in [`path()`](#django.urls.path)
`route`s.

Is aicme tiontaire é an argóint `tiontaire`, agus is é type\_name\` an t-ainm tiontaire le húsáid i bpatrúin cosáin. Féach:ref: cláraithe saincheapach-path-tionters mar shampla.

# Feidhmeanna django.conf.urls le húsáid in URLConfs

## statach () \`\`

#### `static.static(prefix, view=django.views.static.serve, **kwargs)`

Feidhm chúntóra chun patrún URL a thabhairt ar ais chun comhaid a sheirbheáil i mód dífhabhtaithe:

```
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)
```

## `Handler400`

#### `handler400`

Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ba chóir a ghlaoch má sheol an cliant HTTP iarratas a d'fhág riocht earráide agus freagra le cód stádais 400.

De réir réamhshocraithe, is é seo: func: django.views.defaults.bad\_request. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseBadRequest.

## `Handler403`

#### `handler403`

Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch mura bhfuil na ceadanna a theastaíonn ag an úsáideoir chun rochtain a fháil ar acmhainn.

De réir réamhshocraithe, is é seo: func: django.views.defaults.permission\_denied. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseForbidden.

## Handler404 \`\`

#### `handler404`

Is féidir glaoch, nó sreang a léiríonn cosán iomlán iompórtála Python chuig an radharc ar chóir a ghlaoch mura n-oireann aon cheann de na patrúin URL.

De réir réamhshocraithe, is é seo: func: django.views.defaults.page\_not\_found. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí `request` agus `exception` agus tuairisceann sé an:class: ~django.http.httpResponseNotFound.

## `Handler500`

#### `handler500`

Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch i gcás earráidí freastalaí. Tarlaíonn earráidí freastalaí nuair a bhíonn earráidí rith agat i gcód amharc.

De réir réamhshocraithe, is é seo: func: django.views.defaults.server\_error. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le argóint `request` agus filleann sé an:class: ~django.http.httpResponseservererror.