Apa yang akan dibaca selanjutnya¶
Jadi anda telah membaca semua bahan perkenalan dan telah memutuskan anda akan tetap menggunakan Django. Kami hanya menggores permukaan dengan pengenalan ini (kenyataannya, jika anda telah membaca setiap kata tunggal, anda telah membaca tentang 5% dari dokumentasi keseluruhan).
Lalu apa selanjutnya?
Baiklah, kami selalu penggemar besar dari belajar berdasarkan melakukan. Pada titik ini anda harus cukup tahu untuk mulai proyek dari milik anda dan mulai bermain-main. Ketika anda butuh belajar trik baru, datang kembali ke dokumentasi.
Kami menaruh banyak usaha dalam membuat dokumentasi Django berguna, bersih dan selengkap mungkin. Sisa dari dokumen ini menjelaskan lebih tentang bagaimana dokumentasi bekerja sehingga anda bisa mendapatkan yang terbaik dari itu.
(Ya, dokumentasi ini tentang dokumentasi. Sisanya dijamin kami tidak punya rencana untuk menulis dokumen tentang bagaimana membaca dokumen tentang dokumentasi.)
Menemukan dokumentasi¶
Django mendapatkan banyak dokumentasi -- hampir 450,000 kata dan terus berhitung -- sehingga menemukan apa yang anda butuhkan terkadang sulit. Tempat bagus untuk memulai adalah Indeks. Kami juga menganjurkan menggunakan fitur pencarian siap pakai.
Atau anda hanya menjelajah sekitar!
Bagaimana dokumentasi diatur¶
Dokumentasi utama Django dipecah menjadi "potongan" rancangan untuk mengisi kebutuhan berbeda:
The introductory material dirancang untuk orang baru pada Django -- atau ke pengembangan jaringan secara umum. Dia tidak mencangkup apapun lebih dalam, tetapi daripada memberikan tinjauan tingkat-tinggi dari bagaimana mengembangkan dalam "feels" Django.
panduan topik, di tangan lain, gali lebih dalam ke bagian tersendiri dari Django. Terdapat panduan lengkap ke sistem model Django, mesin cetakan, kerangka bentuk, dan banyak lagi.
Ini mungkin dimana anda ingin menghabiskan banyak waktu anda; jika anda bekerja jalan anda melalui panduan ini anda harus keluar mengetahui hampir segala sesuatu yang ada untuk diketahui tentang Django.
Pengembangan jaringan sering melebar, tidak dalam -- masalah menjangkau banyak ranah. Kami telah menulis sekumpulan how-to guides yang menjawab umum pertanyaan "Bagaimana Saya ...?". Disini anda akan menemukan informasi tentang membangkitkan PDF dengan Django, menulis penyesuaian etiket cetakan, dan lagi.
Jawaban pertanyaan sangat umum dapat ditemukan di FAQ.
Panduan dan bagaimana-untuk tidak mencangkup setiap kelas tunggal, fungsi, dan cara tersedia di Django -- itu akan besar sekali ketika anda mencoba belajar. Sebagai gantinya, rincian tentang kelas, fungsi, cara dan modul tersendiri terjaga di reference. Ini adalah dimana anda akan merubah menemukan rincian dari fungsi tertentu atau apapun anda butuhkan.
Jika anda tertarik menyebarkan sebuah proyek untuk penggunaan umum, dokumen kami mempunyai beberapa panduan untuk beragam pengaturan pengembangan sama halnya daftar centang penyebaran untuk sesuatu anda akan butuh untuk dipikirkan.
Akhirnya, ada beberapa dokumentasi "specialized" tidak biasanya terkait pada kebanyakan pengembang. Ini menyertakan release notes dan internals documentation untuk mereka yang ingin menambahkan kode ke Django itu sendiri, dan few other things that don't fit elsewhere.
Bagaimana dokumentasi diperbaharui¶
Hanya sebagai basis kode Django dikembangkan dan diperbaiki pada permulaan harian, dokumentasi kami terus-menerus diperbaiki. Kami memperbaiki dokumentasi untuk beberapa alasan:
- Untuk membuat isi tetap, seperti pembetulan tata bahasa/kesalahan ketik.
- Untuk menambahkan informasi dan/atau contoh pada bagian yang ada yang butuh diperluas.
- Pada dokumen fitur Django yang belum didokumentasikan. (Daftar seperti fitur itu menyusut tapi tetap ada.)
- Untuk menambahkan dokumentasi untuk fitur baru sebagai fitur baru ditambahkan, atau API Django atau perubahan kebiasaan.
Dokumentasi Django dijaga dalam sistem kendali sumber yang sama seperti kodenya. Itu berada di direktori the docs dari gudang Git kami. Setiap dokumen daring adalah berkas teks terpisah dalam gudang.
Dimana mendapatkannya¶
Anda dapat membaca dokumentasi Django dalam beberapa cara. Mereka adalah, urutan pilihan:
Dalam jaringan¶
Versi paling saat ini dari dokumentasi Django berada pada https://docs.djangoproject.com/en/dev/. Halaman-halaman HTML ini dibangkitkan otomatis dari berkas-berkas teks dalam kendali sumber. Itu berarti mereka mencerminkan "terakhir dan terhebat" dalam Django -- mereka menyertakan perbaikan dan penambahan sangat terakhir, dan mereka mengobrolkan fitur-fitur Django terakhir, yang mungkin tersedia pada pengguna dari versi pengembangan Django (Lihat Perbedaan diantara versi dibawah.)
Kami mendorong anda untuk membantu perbaikan dokumen dengan mengajukan perubahan, pembenaran dan saran di sistem tiket. Pengembang Django secara aktif mengawasi sistem tiket dan menggunakan umpan balik anda untuk memperbaiki dokumentasi untuk semua orang.
Catat, bagaimanapun, tiket itu harus secara eksplisit berhubungan ke dokumentasi, dari pada menanyakan pertanyaan dukunan-teknis luas. Jika anda butuh bantuan dengan pengaturan Django khususnya, coba django-users daftar penyuratan atau #django IRC channel.
Dalam teks polos¶
Untuk membaca tanpa jaringan, atau hanya untuk kenyamanan, anda dapat membaca dokumentasi Django di teks polos.
Jika anda sedang menggunakan terbitan resmi dari Django, paket terkompresi (tarball) dari kode menyertakan direktori docs/, yang mengandung semua dokumentasi untuk terbitan itu.
Jika anda sedang menggunakan versi pengembangan dari Django (alias cabang utama), direktori docs/ mengandung semua dokumentasi. Anda dapat memperbaharui pemeriksaan Git untuk mendapatkan perubahan terakhir.
Hanya jalan teknik-rendah dari mengambil keuntungan dari teks dokumentasi dengan menggunakan kegunaan grep Unix untuk mencari frase di semua dokumentasi. Sebagai contoh, ini akan menunjukkan anda setiap sebutan dari frase "max_length" di dokumen Django:
$ grep -r max_length /path/to/django/docs/
...\> grep -r max_length \path\to\django\docs\
Sebagai HTML, secara lokal¶
Anda bisa mendapatkan salinan lokal dari dokumentasi HTML mengikuti sedikit langkah-langkah:
Dokumentasi Django menggunakan sebuah sistem disebut Sphinx untuk merubah dari teks polos ke HTML. Anda akan butuh memasang Sphinx dengan salah satu mengunduh dan memasang paket dari situs jaringan Sphinx, atau dengan
pip:$ python -m pip install Sphinx...\> py -m pip install SphinxKemudian, gunakan
Makefiledisertakan untuk mengubah dokumentasi menjadi HTML:$ cd path/to/django/docs $ make html
Anda akan butuh GNU Make memasang untuk ini.
Jika anda berada di Windows anda dapat cara lain menggunakan berkas kumpulan disertakan:
cd path\to\django\docs make.bat htmlDokumentasi HTML akan ditempatkan di
docs/_build/html.
Perbedaan diantara versi¶
Dokumentasi teks dalam cabang utama dari gudang Git mengandung perubahan dan penambahan "latest and greatest". Perubahan ini termasuk dokumentasi dari fitur baru disasarkan untuk feature release Django selanjutnya. Untuk alasan itu, sangat berharga menunjuk kebijakan kami untuk menggarisbawahi perubahan terakhir danpenambahan pada Django.
Kami mengikuti kebijakan ini:
- Dokumentasi pengembangan pada https://docs.djangoproject.com/en/dev/ berasal dari cabang utama. Dokumen ini berkaitan pada terbitan terakhir akan datang, ditambah fitur apapun telah ditambah/dirubah dalam kerangka kerja sejak itu.
- Ketika kami menambahkan fitur-fitur ke versi pengembangan Django, kami memperbaharui dokumentasi dalam transaksi penyerahan Git yang sama.
- Untuk membedakan perubahan/penambahan fitur dalam dokumen, kami menggunakan frasa: "Baru dalam versi Pengembangan Django" untuk versi Django yang belum diterbitkan,.atau "Baru dalam versi X.Y" untuk versi diterbitkan.
- Perbaikan dan peningkatan dokumentasi mungkin dihubungkan pada cabang terbitan terakhir, at kebijaksanaan penggabungan, bagaimanapun, sekali versi Django no longer supported, versi tersebut dari dokumentasi tidak akan mendapatkan pembaharuan lanjutan.
- main documentation web page menyertakan tautan ke dokumentasi untuk versi sebelumnya. Pastikan anda sedang menggunakan versi dari dokumen sesuai pada versi Django anda sedang gunakan!
