Django Documentation in Hindi

 How to Start with Django?

Django के साथ शुरुआत :

Django क्या है? 

Django एक उच्च-स्तरीय पायथन वेब फ्रेमवर्क है जो तेज़ विकास और साफ़-सुथरे, व्यावहारिक डिज़ाइन को बढ़ावा देता है। यह वेब विकास से संबंधित बहुत सी झंझटों को संभालता है, जिससे आप अपना ऐप लिखने पर ध्यान केंद्रित कर सकते हैं बिना बार-बार एक ही चीज़ को फिर से बनाने की आवश्यकता के।

Django एक पूर्ण-विशेषताओं वाला वेब फ्रेमवर्क है जो मॉडल-व्यू-कंट्रोलर (MVC) वास्तुशिल्प पैटर्न का पालन करता है। यह वेब अनुप्रयोग बनाने के लिए टूल्स और लाइब्रेरीज़ का एक सेट प्रदान करता है, जिसमें ORM, टेम्पलेटिंग इंजन, और बिल्ट-इन एडमिन इंटरफ़ेस शामिल हैं।

पर्यावरण सेटअप  

Django के साथ शुरुआत करने के लिए, आपको इसे अपने कंप्यूटर पर इंस्टॉल करना होगा। आप इसे अपने टर्मिनल में निम्नलिखित कमांड चलाकर कर सकते हैं, लेकिन इससे पहले एक वर्चुअल एनवायरनमेंट सेट करें:

python3 -m venv .venv
source .venv/bin/activate
    

python3 -m venv .venv

    

विंडोज़ पर वर्चुअल एनवायरनमेंट बनाने के लिए निम्नलिखित कमांड का उपयोग करें:

python -m venv .venv
    

विंडोज़ पर वर्चुअल एनवायरनमेंट को सक्रिय करने के लिए इस कमांड का उपयोग करें:

.venv\Scripts\activate
    

Django प्रोजेक्ट

Django प्रोजेक्ट सेटिंग्स और कॉन्फ़िगरेशन का एक संग्रह है, जो एक वेब एप्लिकेशन की संरचना और व्यवहार को परिभाषित करता है। इसमें एप्लिकेशन के लिए कोड, टेम्पलेट्स, स्टैटिक फाइल्स, और अन्य संसाधन शामिल होते हैं जो एप्लिकेशन को बनाते हैं।

नया Django प्रोजेक्ट बनाने के लिए आप निम्नलिखित कमांड का उपयोग कर सकते हैं:

django-admin startproject meraproject
cd meraproject
    

यह कमांड एक नया डायरेक्टरी 'meraproject' बनाएगी, जिसमें Django प्रोजेक्ट की मूल संरचना होगी।

Django सर्वर शुरू करें

Django सर्वर शुरू करने के लिए, आप निम्नलिखित कमांड का उपयोग कर सकते हैं:

python manage.py runserver
    

Django सर्वर का पोर्ट बदलें

जब आप Django सर्वर चलाते हैं, तो यह डिफ़ॉल्ट रूप से http://127.0.0.1:8000 पर चलता है। लेकिन कभी-कभी यह हो सकता है कि पोर्ट 8000 पहले से किसी अन्य एप्लिकेशन द्वारा उपयोग हो रहा हो, और इस स्थिति में आपको एक अलग पोर्ट पर सर्वर चलाने की आवश्यकता होती है।

नीचे कुछ कमांड्स दी गई हैं जिनका उपयोग करके आप Django सर्वर को एक अलग पोर्ट पर चला सकते हैं:

python manage.py runserver 127.0.0.1:7000
    

python manage.py runserver 7000
    

python manage.py runserver 0:7000
    

इनमें से प्रत्येक कमांड आपके Django प्रोजेक्ट को एक अलग IP एड्रेस या पोर्ट पर चलाने के लिए उपयोग की जाती है:

• python manage.py runserver 127.0.0.1:7000 – यह कमांड Django को 127.0.0.1 (लोकलहोस्ट) और पोर्ट 7000 पर चलाएगी।
• python manage.py runserver 7000 – यह सर्वर को डिफ़ॉल्ट लोकलहोस्ट IP (127.0.0.1) पर, लेकिन पोर्ट 7000 पर चलाएगा।
• python manage.py runserver 0:7000 – यह कमांड सर्वर को सभी उपलब्ध नेटवर्क इंटरफेस (जैसे 0.0.0.0) पर, पोर्ट 7000 पर चलाने के लिए है, जिससे आप अन्य डिवाइस से भी सर्वर तक पहुंच सकते हैं।

इन कमांड्स का उपयोग तब किया जाता है जब आपका डिफ़ॉल्ट पोर्ट 8000 पहले से किसी अन्य एप्लिकेशन द्वारा उपयोग किया जा रहा हो या आपको किसी विशेष पोर्ट पर सर्वर चलाने की आवश्यकता हो।

हमारा पहला View बनाना

अब हम अपने Django प्रोजेक्ट में कुछ views बनाएंगे। views वे फ़ंक्शन होते हैं जो वेब ब्राउज़र से प्राप्त अनुरोधों (requests) के आधार पर प्रतिक्रिया (response) लौटाते हैं। प्रत्येक view एक वेब पेज को प्रदर्शित करता है, जैसे कि होम पेज, अबाउट पेज, और संपर्क पेज।

1. views.py फ़ाइल बनाएं

chaiaurdjango डायरेक्टरी में एक नई फ़ाइल views.py बनाएं। इस फ़ाइल में हम कुछ साधारण views परिभाषित करेंगे, जो HTML सामग्री को ब्राउज़र में प्रदर्शित करेंगे।

from django.http import HttpResponse

def home(request):
    return HttpResponse("<h1>Chai के Django प्रोजेक्ट में आपका स्वागत है: होम पेज</h1>")

def about(request):
    return HttpResponse("<h1>Chai के Django प्रोजेक्ट में आपका स्वागत है: अबाउट पेज</h1>")

def contact(request):
    return HttpResponse("<h1>Chai के Django प्रोजेक्ट में आपका स्वागत है: संपर्क पेज</h1>")
    

उदाहरण: ऊपर के कोड में तीन views बनाए गए हैं, जिनमें प्रत्येक फ़ंक्शन एक HTML प्रतिक्रिया लौटा रहा है:

• home() – यह होम पेज के लिए है, जो " Django प्रोजेक्ट में आपका स्वागत है: होम पेज" संदेश दिखाएगा।
• about() – यह अबाउट पेज के लिए है, जो " Django प्रोजेक्ट में आपका स्वागत है: अबाउट पेज" दिखाएगा।
• contact() – यह संपर्क पेज के लिए है, जो " Django प्रोजेक्ट में आपका स्वागत है: संपर्क पेज" दिखाएगा।

2. urls.py में URL Patterns जोड़ें

अब chaiaurdjango डायरेक्टरी में एक नई urls.py फ़ाइल बनाएं (यदि पहले से नहीं है)। इस फ़ाइल में, हम अपने views के लिए URL patterns परिभाषित करेंगे।

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
    path('about/', views.about, name='about'),
    path('contact/', views.contact, name='contact'),
]
    

इस कोड में हमने तीन URL patterns बनाए हैं:

• '' (रिक्त URL) – यह होम पेज को इंगित करता है। http://localhost:8000/ पर जाने से home view कॉल होगा।
• 'about/' – यह अबाउट पेज के लिए है। http://localhost:8000/about/ पर जाने से about view कॉल होगा।
• 'contact/' – यह संपर्क पेज के लिए है। http://localhost:8000/contact/ पर जाने से contact view कॉल होगा।

3. Django सर्वर चलाएं और URLs पर जाएं

अब सर्वर को फिर से चलाएं और निम्नलिखित URLs पर जाएं:

• http://localhost:8000/ – होम पेज
• http://localhost:8000/about/ – अबाउट पेज
• http://localhost:8000/contact/ – संपर्क पेज

आपको निम्नलिखित आउटपुट मिलना चाहिए:

• Django प्रोजेक्ट में आपका स्वागत है: होम पेज
• Django प्रोजेक्ट में आपका स्वागत है: अबाउट पेज
• Django प्रोजेक्ट में आपका स्वागत है: संपर्क पेज

टेम्पलेट्स जोड़ना

Django में टेम्पलेट्स का उपयोग HTML पेज बनाने के लिए किया जाता है। टेम्पलेट्स का इस्तेमाल डेटा प्रदर्शित करने और कुछ लॉजिक लागू करने के लिए होता है।

टेम्पलेट बनाने के लिए, आप meraproject डायरेक्टरी में templates/index.html नाम की एक नई फ़ाइल बना सकते हैं। सुनिश्चित करें कि templates फ़ोल्डर उसी लेवल पर हो जिस लेवल पर manage.py फ़ाइल हो। इस फ़ाइल में आप HTML कोड लिख सकते हैं, जो वेब पेज जनरेट करेगा।

1. index.html फ़ाइल बनाएँ

<!DOCTYPE html>
<html>
<head>

    <title>   Welcome to Mera Django Project   </title>
</head>
<body>
    <h1>Welcome to Django Mera Project</h1>
</body>
</html>
    

ऊपर दिए गए HTML कोड में एक साधारण वेब पेज बनाया गया है जिसमें एक हेडर और एक बॉडी है:

• <head> टैग के अंदर title सेट किया गया है: "Django प्रोजेक्ट में आपका स्वागत है"
• <body> टैग के अंदर एक h1 हेडर है, जो पेज पर दिखाई देगा।

2. सर्वर को फिर से चलाएँ

अब सर्वर को फिर से शुरू करें और http://localhost:8000/ पर जाएं। आपको निम्न आउटपुट दिखाई देगा:

• Welcome to Django Mera Project

CSS और JavaScript जोड़ना

Django प्रोजेक्ट में CSS और JavaScript जोड़ने के लिए, आप chaiaurdjango डायरेक्टरी में static/css/style.css नाम की एक नई फ़ाइल बना सकते हैं। इस फ़ाइल में आप HTML पेज को स्टाइल करने के लिए CSS कोड लिख सकते हैं। आप static/js/script.js नाम की एक नई फ़ाइल भी बना सकते हैं। इस फ़ाइल में आप HTML पेज में इंटरएक्टिविटी जोड़ने के लिए JavaScript कोड लिख सकते हैं।

1. CSS फ़ाइल बनाएं

body {
  background-color: #161616;
  font-family: Arial, sans-serif;
  color: #fff;
}
    

2. JavaScript फ़ाइल बनाएं

console.log("Hello, world!");
    

settings.py में बदलाव करें

इस CSS फ़ाइल को जोड़ने के लिए, settings.py में निम्नलिखित लाइन जोड़ें:

import os  # settings.py के शीर्ष पर

'DIRS': ['templates'],  # टेम्पलेट सेक्शन के अंदर

STATIC_URL = '/static/'  # इसके नीचे यह लाइन जोड़ें
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
    

index.html फ़ाइल में बदलाव करें

index.html फ़ाइल में निम्नलिखित लाइन जोड़ें:

{% load static %}

    

3. होम व्यू को अपडेट करें

अब होम व्यू को नया टेम्पलेट उपयोग करने के लिए बदलें:

from django.shortcuts import render

def home(request):
    return render(request, 'index.html')
    

सर्वर को फिर से चलाएँ

अब सर्वर को फिर से चलाएँ और http://localhost:8000/ पर जाएं। आपको निम्न आउटपुट दिखाई देगा:

• Welcome to Mera Django Project