Mari kita belajar berdasarkan contoh.
\nMelalui tutorial ini, kami akan memandu anda melalui pembuatan aplikasi jejak pendapat dasar.
\nDia akan terdiri dari dua bagian:
\nSitus umum yang membiarkan orang melihat jejak pendapat dan memilih mereka.
Situs admin yang membiarkan anda menambah, merubah, dan menghapus jejak pendapat.
Kami akan beranggapan anda telah mempunyai Django installed. Anda dapat memberitahu Django terpasang dan versi mana dengan menjalankan perintah berikut dalam sebuah shell prompt (ditunjukkan oleh awalan $):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nJika Django telah terpasang, anda harus melihat versi dari pemasangan anda. Jika dia tidak, anda akan mendapatkan kesalahan mengatakan "Tidak ada modul bernama django".
\nThis tutorial is written for Django 5.1, which supports Python 3.10 and\nlater. If the Django version doesn't match, you can refer to the tutorial for\nyour version of Django by using the version switcher at the bottom right corner\nof this page, or update Django to the newest version. If you're using an older\nversion of Python, check Versi Phyton apa dapat Saya gunakan dengan Django? to find a compatible\nversion of Django.
\n\nJika ini adalah pertama kali anda menggunakan Django, anda harus berhati-hati dari beberapa pengaturan awal. Yaitu, anda butuh membangkitkan-otomatis beberapa kode yang membangun Django project -- kumpulan dari pengaturan untuk contoh DJango, termasuk konfigurasi basisdata, pilihan khusus-Django dan pengaturan khusus-aplikasi.
\nFrom the command line, cd into a directory where you'd like to store your\ncode and create a new directory named djangotutorial. (This directory name\ndoesn't matter to Django; you can rename it to anything you like.)
Linux / macOS
$ mkdir djangotutorial\nWindows
...\\> mkdir djangotutorial\nThen, run the following command to bootstrap a new Django project:
\nLinux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nThis will create a project called mysite inside the djangotutorial\ndirectory. If it didn't work, see Masalah menjalankan django-admin.
Let's look at what startproject created:
djangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nBerkas ini adalah:
\nmanage.py: Sebuah kegunaan baris-perintah yang membiarkan anda berinteraksi dengan proyek Django ono di beragam jalan. Anda dapat membaca semua rincian tentang manage.py di django-admin dan manage.py.
mysite/: A directory that is the actual Python package for your\nproject. Its name is the Python package name you'll need to use to import\nanything inside it (e.g. mysite.urls).
mysite/__init__.py: Sebuah berkas kosong yang memberitahu Python bahwa pelipat ini harus mempertimbangkan paket Python. Jika anda adalah pemula Python, baca more about packages di dokumen resmi Python.
mysite/settings.py: Pengaturan/konfigurasi untuk proyek Django ini. Pengaturan Django akan mengatakan anda semua tentang bagaimana pengaturan bekerja.
mysite/urls.py: Deklarasi URL untuk proyek Django ini; "tabel isi" dari situs Ditenagai-Django anda. Anda dapat membaca lebih tentang URL di Pengirim URL.
mysite/asgi.py: Sebuah titik-masukan untukpeladen jaringan cocok-ASGI untuk melayani proyek anda. Lihat Bagaimana mengembangkan dengan ASGI untuk rincian lebih.
mysite/wsgi.py: Sebuah titik-masukan untuk peladen jaringan sesuai-WSGI untuk meladeni proyek anda. Lihat Bagaimana menyebarkan dengan WSGI untuk lebih rinci.
Let's verify your Django project works. Change into the djangotutorial\ndirectory, if you haven't already, and run the following commands:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nAnda akan melihat keluaran berikut pada baris perintah:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n09 Agu, 2026 - 15:50:53\nDjango version 5.1, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
Sekarang peladen sedang berjalan, kunjungi http://127.0.0.1:8000/ dengan peramban jaringan anda. Anda akan melihat halaman "Congratulations!", dengan sebuah roket meluncur. Itu bekerja!
\nAnda telah memulai peladen pengembangan Django, peladen jaringan ringan ditulis dalam Python. Kami telah menyertakan ini dalam Django sehingga anda dapt mengembangkan hal-hal dengan cepat, tanpa harus berurusan dengan konfigurasi peladen produksi-- seperti Apache -- sampai anda siap untuk produksi.
\nSekarang adalah waktu bagus untuk dicatat: jangan gunakan peladen ini dalam dalam segala hal yang menyerupai lingkungan produksi. Itu hanya diperuntukkan untuk penggunaan selagi pengembangan. (Kami berada di bisnis dari membuat kerangka kerja jaringan, bukan peladen jaringan.)
\n(To serve the site on a different port, see the runserver reference.)
Sekarang bahwa lingkungan anda -- sebuah "proyek" -- sedang diatur, anda sudah untuk siap memulai pekerjaan.
\nSetiap aplikasi anda tulis dalam Django terdiri dari paket Phyton yang mengikuti ketentuan tertentu Django datang dengan kegunaan yang otomatis membangkitkan struktur direktori dasar dari sebuah aplikasi, sehingga anda dapat fokus pada menulis kode daripada membuat direktori.
\n\nYour apps can live anywhere in your Python path. In\nthis tutorial, we'll create our poll app inside the djangotutorial folder.
Untuk membuat aplikasi anda, pastikan anda berada di direktori sama sebagai manage.py dan ketik perintah ini:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nThat'll create a directory polls, which is laid out like this:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nStruktur direktori ini akan merumahkan aplikasi jejak pendapat.
\nMari kita menulis tampilan pertama. Buka berkas polls/views.py dan taruh kode Phyton berikut didalamnya:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nThis is the most basic view possible in Django. To access it in a browser, we\nneed to map it to a URL - and for this we need to define a URL configuration,\nor "URLconf" for short. These URL configurations are defined inside each\nDjango app, and they are Python files named urls.py.
To define a URLconf for the polls app, create a file polls/urls.py\nwith the following content:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nYour app directory should now look like:
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nThe next step is to configure the global URLconf in the mysite project to\ninclude the URLconf defined in polls.urls. To do this, add an import for\ndjango.urls.include in mysite/urls.py and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\nThe path() function expects at least two arguments:\nroute and view.\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded URLconf for further processing.
Ide dibelakan include() adalah membuat itu mudah pasang-dan-mainkan URL. Sejak jejak pendapat dalam URLconf mereka sendiri (polls/urls.py), mereka dapat dipasang dibawah "/polls/", atau dibawah "/fun_polls/", atau dibawah "/content/polls/", atau jalur akar lain apapun, dan aplikasi masih bisa bekerja.
Anda sekarang harus mengikat tampilan index kedalam URLconf. Periksa pekerjaannya dengan perintah berikut:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nPergi ke http://localhost:8000/polls/ di perambah anda, dan anda seharusnya melihat teks "Halo, dunia. Anda sedang berada di index jejak pendapat.", yang anda tentukan di tampilan index.
Ketika anda nyaman dengan permintaan dasar dan aliran tanggapan, baca bagian 2 dari tutorial ini utuk memulai bekerja dengan basisdata.
\n