---
title: "Pembangkit dokumentasi admin Django"
version: 5.2
locale: id
source: https://docs.djangoproject.com/id/5.2/ref/contrib/admin/admindocs/
canonical: https://djangodocs.dev/id/5.2/ref/contrib/admin/admindocs/
---
# Pembangkit dokumentasi admin Django

Aplikasi [`admindocs`](#module-django.contrib.admindocs) Django menarik dokumentasi dari docstring dari model, tampilan etiket cetakan, dan penyaring cetakan untuk aplikasi apapun di [`INSTALLED_APPS`](/id/5.2/ref/settings/#std-setting-INSTALLED_APPS) dan membuat dokumentasi itu tersedia dari [`Django admin`](/id/5.2/ref/contrib/admin/#module-django.contrib.admin).

## Ikhtisar

Untuk mengaktifkan [`admindocs`](#module-django.contrib.admindocs), anda akan butuh melakukan berikut:

- Tambah [`django.contrib.admindocs`](#module-django.contrib.admindocs) ke [`INSTALLED_APPS`](/id/5.2/ref/settings/#std-setting-INSTALLED_APPS) anda.
- Tambah `path('admin/doc/', include('django.contrib.admindocs.urls'))` ke `urlpatterns` anda. Pastikan itu disertakan *sebelum* masukan `'admin/'`, sehingga permintaan ke `/admin/doc/` tidak ditangani oleh masukan terakhir.
- Install the [docutils](https://pypi.org/project/docutils/) 0.19+ package.
- **Pilihan:** Menggunakan Bookmark admindoc membutuhkan `django.contrib.admindocs.middleware.XViewMiddleware` untuk dipasang.

Sekali langkah-langkah tersebut lengkap, anda dapat mulai menjelajah dokumentasi dengan pergi ke antarmuka admin anda dan mengklik tautan "Documentation" di atas kanan halaman.

## Dokumentasi pembantu

Markah khusus beikur dapat digunakan di docstring anda untuk dengan mudah membuat hyperlink ke komponen lain:

| Komponen Django | Peran reStructuredText |
| --- | --- |
| Model | `` :model:`app_label.ModelName` `` |
| View | `` :view:`app_label.view_name` `` |
| Tag templat | `` :tag:`tagname` `` |
| Filter templat | `` :filter:`filtername` `` |
| Templat | `` :template:`path/to/template.html` `` |

Each of these support custom link text with the format
`` :role:`link text <link>` ``. For example, `` :tag:`block <built_in-block>` ``.

> **Changed in Django 5.2**
>
> Support for custom link text was added.

## Acuan model

The **models** section of the `admindocs` page describes each model that the
user has access to along with all the fields, properties, and methods available
on it. Relationships to other models appear as hyperlinks. Descriptions are
pulled from `help_text` attributes on fields or from docstrings on model
methods.

Sebuah model dengan dokumentasi berguna mungkin terlihat seperti ini:

```
class BlogEntry(models.Model):
    """
    Stores a single blog entry, related to :model:`blog.Blog` and
    :model:`auth.User`.
    """

    slug = models.SlugField(help_text="A short label, generally used in URLs.")
    author = models.ForeignKey(
        User,
        models.SET_NULL,
        blank=True,
        null=True,
    )
    blog = models.ForeignKey(Blog, models.CASCADE)
    ...

    def publish(self):
        """Makes the blog entry live on the site."""
        ...
```

> **Changed in Django 5.2**
>
> Access was restricted to only allow users with model view or change
> permissions.

## Lihat acuan

Setiap URL di situs anda mempunyai masukan terpisah di halaman `admindocs`, dan mengklik pada URL yang diberikan akan menunjukkan anda tampilan berhubungan. Hal-hal membantu anda dapat dokumentasikan di docstring fungsi tampilan anda termasuk:

- Sebuah gambaran singkat dari apa yang tampilan lakukan.
- **konteks**, atau daftar dari variabel tersedia di cetakan tampilan.
- Nama dari cetakan atau cetakan-cetakan yang digunakan untuk tampilan itu.

Sebagai contoh:

```
from django.shortcuts import render

from myapp.models import MyModel

def my_view(request, slug):
    """
    Display an individual :model:`myapp.MyModel`.

    **Context**

    ``mymodel``
        An instance of :model:`myapp.MyModel`.

    **Template:**

    :template:`myapp/my_template.html`
    """
    context = {"mymodel": MyModel.objects.get(slug=slug)}
    return render(request, "myapp/my_template.html", context)
```

## Etiket cetakan dan acuan saringan

Bagian `admindocs` **etiket** and **penyaring** menggambarkan semua etiket dan penyaring yang datang dengan Django (faktanya, dokumentasi [built-in tag reference](/id/5.2/ref/templates/builtins/#ref-templates-builtins-tags) dan [built-in filter reference](/id/5.2/ref/templates/builtins/#ref-templates-builtins-filters) datang langsung dari halaman-halaman tersebut). Etiket atau penyaring apapun yang anda buat atau ditambahkan oleh aplikasi pihak-ketiga akan tampil di bagian-bgian ini juga.

## Acuan cetakan

Selagi `admindocs` tidak menyertakan tempat untuk cetakan dokumen oleh mereka sendiri, jika anda menggunakan sintaksis `` :template:`path/to/template.html` `` di sebuah docstring halaman hasil akan memeriksa jalur dari cetakan itu dengan [template loaders](/id/5.2/ref/templates/api/#template-loaders) Django. Ini dapat menjadi cara mudah memeriksa jika cetakan ditentukan ada dan untuk menunjukkan dimana pada sistem berkas cetakan itu disimpan.

## Disertakan Bookmarklet

Satu bookmarklet tersedia dari halaman `admindocs`:

**Dokumentasi untuk laman ini**

  Buka dari laman apa saja ke laman dokumentasi untuk view yang menghasilkan laman tersebut.

Menggunakan bookmark ini mewajibkan bahwa `XViewMiddleware` dipasang dan bahwa anda masuk kedalam [`Django admin`](/id/5.2/ref/contrib/admin/#module-django.contrib.admin) sebagai sebuah [`User`](/id/5.2/ref/contrib/auth/#django.contrib.auth.models.User) dengan [`is_staff`](/id/5.2/ref/contrib/auth/#django.contrib.auth.models.User.is_staff) disetel menjadi `True`.