# Dokumentasi Django 5.2.8

# Bagaimana memasang Django pada WIndows

This document will guide you through installing Python 3.14 and Django on Windows. It also provides instructions for setting up a virtual environment, which makes it easier to work on Python projects. This is meant as a beginner's guide for users working on Django projects and does not reflect how Django should be installed when developing changes for Django itself.

Langkah-langkah dalam panduan ini telah diuji dengan Windows 10. Di versi lainnya, langkah-langkah akan mirip. Anda harus terbiasa dengan dengan menggunakan perintah prompt Windows.

## Pasang Phyton

Django is a Python web framework, thus requiring Python to be installed on your machine. At the time of writing, Python 3.14 is the latest version.

Untuk memasang Python di mesin anda pergi ke https://www.python.org/downloads/. Situs tersebut kemudian akan menawarkan tombol unduh untuk versi Python terbaru. Unduh berkas pemasang dijalankan dan jalankan. Centang kotak "Install launcher for all users (recommended)" dan klik "Install Now".

Setelah pemasangan, buka command prompt dan periksa bahwa versi Python cocok dengan versi anda pasang dengan menjalankan:

    ...\> py --version

`py` tidak dikenali atau ditemukan

Bergantung pada bagaimana anda memasang Python (seperti melalui Microsoft Store), `py` mungkin tidak tersedia di prompt perintah.

Anda akan butuh menggunakan``python`` daripada `py` ketika memasukkan perintah.

Lihat juga

Untuk rincian lebih,lihat dokumentasi Using Python on Windows.

## Tentang `pip`

pip adalah pengelola paket untuk Python dan termasuk dalam awalan dengan pemasang Python. Itu membantu memasang dan melepas paket Python (seperti Django!). Untuk sisa dari pemasangan, kami akan menggunakan `pip` untuk memasang paket Python dari baris perintah.

## Menyetel lingkungan maya

Adalah praktik terbaik untuk menyediakan lingkungan berdedikasi untuk setiap proyek Django anda buat. Ada banyak pilihan untuk mengelola lingkungan dan paket dalam ekosistem Python, beberapa yang dianjurkan di Python documentation. Python itu sendiri datang dengan venv untuk mengelola lingkungan dimana penggunakan akan menggunakan panduan ini.

Untuk membuat lingkungan maya untuk proyek anda, buka prompt perintah baru, arahkan ke folder dimana anda ingin buat proyek anda dan masukkan berikut:

    ...\> py -m venv project-name

Ini akan membuat sebuah folder disebut 'project-name' jika belum ada dan menyetel lingkungan maya. Untuk mengaktifkan lingkungan, jalankan:

    ...\> project-name\Scripts\activate.bat

Lingkungan maya akan diaktifkan dan anda akan melihat "(project-name)" dekat dengan command prompt untuk menandai itu. Setiap waktu anda memulai command prompt baru, anda akan butuh mengaktifkan lingkungan kembali.

## Pasang Django

Django dapat dipasang dengan mudah menggunakan `pip` dalam lingkungan maya anda.

Dalam prompt perintah, pastikan anda memasukkan lingkungan maya aktif, dan menjalankan perintah berikut:

    ...\> py -m pip install Django

Ini akan mengunduh dan memasang terbitan Django terakhir.

Setelah pemasangan lengkap, anda dapat memeriksa pemasangan Django anda dengan menjalankan `django-admin --version` di command prompt.

Lihat Dapatkan basisdata anda berjalan untuk informasi pada pemasangan basisdata dengan Django.

## Keluaran terminal bewarna

Fitur kualitas-hidup menambahkan keluaran bewarna (daripada satu warna) ke terminal. Dalam terminal moderen ini juga bekerja untuk kedua CMD dan PowerShell. Jika beberapa alasan kebutuhan ini butuh ditiadakan, setel variabel lingkungan `DJANGO_COLORS` menjadi `nocolor`.

Pada versi Windows lama, atau warisan terminal, colorama 0.4.6+ harus dipasang untuk mengadakan pewarnaan sintaksis:

    ...\> py -m pip install "colorama >= 0.4.6"

Lihat Pewarnaan sintaksis untuk informasi lebih pada pengaturan warna.

## Kesalahan umum

- Jika `django-admin` hanya menampilkan teks bantuan tidak perduli argumen apa yang diberikan, ada kemungkinan masalah dengan berkas terkait di Windows. Periksa jika ada lagi dari satu kumpulan lingkungan variabel untuk menjalankan tulisan Python dalam `PATH`. Ini biasanya muncul ketika ada lebih dari satu versi Python terpasang.

- Jika Anda terhubung ke internet menggunakan proksi, mungkin akan muncul masalah ketika menjalankan `py -m pip install Django`. Atur variabel environment untuk konfigurasi proksi dalam terminal sebagai berikut:

      ...\> set http_proxy=http://username:password@proxyserver:proxyport
      ...\> set https_proxy=https://username:password@proxyserver:proxyport

- Secara umum, Django beranggapan bahwa penyandian `UTF-8` digunakan untuk I/O. Ini mungkin menyebabkan masalah jika sistem anda disetel menggunakan penyandian berbeda. Versi terbaru Python mengizinkan menyetel variabel lingkungan the `PYTHONUTF8` untuk memaksa penyandian `UTF-8`. Windows 10 juga menyediakan pengaturqan lebar-sistem dengen memilih `Use Unicode UTF-8 for worldwide language support` di Language ‣ Administrative Language Settings ‣ Change system locale dalam pengaturan sistem.