{"title":"Menimpa cetakan","version":"3.2","locale":"id","docname":"howto/overriding-templates","url":"/id/3.2/howto/overriding-templates/","canonical":"https://djangodocs.dev/id/3.2/howto/overriding-templates/","summary":"Dalam proyek anda, anda mungkin ingin menimpa sebuah cetakan dalam aplikasi Django lain, apakai itu berupa aplikasi pihak-ketiga atau aplikasi bantuan…","html":"

Menimpa cetakanLink to this heading#

\n

Dalam proyek anda, anda mungkin ingin menimpa sebuah cetakan dalam aplikasi Django lain, apakai itu berupa aplikasi pihak-ketiga atau aplikasi bantuan seperti django.contrib.admin. Anda dapat antara menaruh cetakan menimpa dalam direktori cetakan proyek anda atau dalam sebuah direktori cetakan aplikasi.

\n

Jika anda mempunyai aplikasi dan direktori cetakan proyek yang kedua kandungan menimpa, pemuat cetakan Django awalan akan mencoba memuat cetakan dari direktori tingkat-proyek dahulu. Dengan kata lain, DIRS 1 dicari sebelum APP_DIRS 2.

\n\n
\n

Menimpa dari direktori cetakan proyekLink to this heading#

\n

Pertama, kami akan menjelajahi menimpa cetakan dengan membuat cetakan pengganti dalam direktori cetakan proyek anda.

\n

Mari kita katakan anda sedang mencoba menimpa cetakan untuk aplikasi pihak-ketiga disebut blog, yang menyediakan cetakan blog/post.html dan blog/list.html. Pengaturan terkait untuk proyek anda akan terlihat seperti:

\n
Code
from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nINSTALLED_APPS = [\n    ...,\n    'blog',\n    ...,\n]\n\nTEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [BASE_DIR / 'templates'],\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

Pengaturan TEMPLATES dan BASE_DIR akan sudah ada jika anda membuat proyek anda menggunakan cetakan proyek awalan. Pengaturan yang butuh dirubah adalah DIRS1.

\n

Pengaturan ini menganggap anda mempunyai sebuah direktori templates dalam akar dari proyek anda. Untuk menimpa cetakan untuk aplikasi blog, buat sebuah folder dalam direktori templates, dan tambah berkas-berkas cetakan ke folder itu.

\n
None
templates/\n    blog/\n        list.html\n        post.html\n
\n

Pemuat cetakan pertama mencari untuk cetakan dalam direktori DIRS. ketika tampilan dalam aplikasi blog untuk cetakan blog/post.html dan blog/list.html, pemuat akan mengembalikan berkas-berkas anda telah buat.

\n
\n
\n

Menimpa dari direktori cetakan aplikasiLink to this heading#

\n

Sejak anda sedang menimpa cetakan bertempat di luar dari satu dari aplikasi proyek anda, itu adalah lebih umum menggunakan metode pertama dan menaruh cetakan penimpaan dalam sebuah folder cetakan proyek. Jika anda memilih, bagaimanapun, itu juga memungkinkan menaruh penimpaan dalam sebuah direktori cetakan aplikasi.

\n

Pertama, pastikan pengaturan cetakan anda memeriksa didalam direktori aplikasi:

\n
Code
TEMPLATES = [\n    {\n        ...,\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

Jika anda ingin menaruh cetakan penimpaan dalam sebuah aplikasi disebut myapp dan cetakan untuk menima bernama blog/list.html dan blog/post.html, kemudian struktur direktori anda akan terlihat seperti:

\n
None
myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n
\n

Dengan APP_DIRS1 disetel menjadi True, pemuat cetakan akan terlihat dalam direktori cetakan aplikasi dan menemukan cetakan.

\n
\n
\n

Memperluas cetakan yang digantiLink to this heading#

\n

With your template loaders configured, you can extend a template using the\n{% extends %} template tag whilst at the same time overriding\nit. This can allow you to make small customizations without needing to\nreimplement the entire template.

\n

Sebagai contoh, anda dapat menggunakan teknik ini untuk menambahkan logo penyesuaian pada cetakan admin/base_site.html:

\n
\n
templates/admin/base_site.html
\n
Django template
 {% extends "admin/base_site.html" %}\n\n {% block branding %}\n     <img src="link/to/logo.png" alt="logo">\n     {{ block.super }}\n {% endblock %}\n
\n
\n

Titik kunci pada catatan:

\n\n

This technique works because the template loader does not consider the already\nloaded override template (at templates/admin/base_site.html) when\nresolving the extends tag. Combined with block.super it is a powerful\ntechnique to make small customizations.

\n
","rootId":"overriding-templates","toc":[{"title":"Menimpa dari direktori cetakan proyek","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"Menimpa dari direktori cetakan aplikasi","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"Memperluas cetakan yang diganti","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Panduan \"Bagaimana\"","url":"/id/3.2/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"Mengeluarkan PDF dengan Django","url":"/id/3.2/howto/outputting-pdf/"},"next":{"docname":"howto/static-files/index","title":"Mengelola berkas statis (sebagai contoh gambar, JavaScript, CSS)","url":"/id/3.2/howto/static-files/"},"formats":{"html":"/id/3.2/howto/overriding-templates/","markdown":"/id/3.2/howto/overriding-templates.md","json":"/id/3.2/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/id/3.2/howto/overriding-templates/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}