إذا كنت جديدًا في عالم بايثون، وتتساءل عن ماهية جانغو، فإليك مقال قد يساعدك كمقدمة عملية.

Django يشبه مجموعة الأدوات التي تتمنى لو كانت لديك دائمًا. فهو يجعل إنشاء تطبيقات ويب قوية وقابلة للتطوير ليس ممكنًا فحسب، بل إنه ممتع حقًا. وتخمين ماذا؟ لا تحتاج إلى أن تكون خبيرًا للبدء.

في هذا الدليل، سنتبع منهجًا عمليًا لإنشاء مشروع Django كاملاً من الصفر. وفي النهاية، سيكون لديك تطبيق ويب خاص بك يعمل بكامل طاقته ويمكنك تعديله وتحسينه. هيا بنا نتعمق!

للحصول على نظرة عامة تفصيلية عن مكدس Django، يمكنك زيارة هذه الصفحة على Code Clash.

المتطلبات الأساسية

قبل البدء، ستحتاج إلى تثبيت بعض الأشياء على جهاز الكمبيوتر الخاص بك:

1. Python 3.x: يحتاج Django إلى Python 3.x للعمل بشكل صحيح.
2. pip: هذا هو مدير حزم Python، وستستخدمه لتثبيت Django والحزم الأخرى.
3. Virtualenv (اختياري ولكن يوصى به بشدة): يساعدك على إنشاء بيئات معزولة حتى تتمكن من فصل تبعيات المشاريع المختلفة.

إذا لم يكن لديك بايثون بعد، يمكنك تنزيله من python.org.

الخطوة 1: إعداد بيئتك

أول الأشياء أولاً - نحتاج إلى إعداد بيئة افتراضية لمشروع Django الخاص بنا. سيؤدي هذا إلى الاحتفاظ بجميع تبعيات مشروعنا في مكان واحد والتأكد من عدم تداخلها مع المشاريع الأخرى على نظامك.

لإنشاء بيئة افتراضية، قم بتشغيل الأمر التالي:

# Create a virtual environment
python -m venv myenv

# Activate the virtual environment
# On Windows
myenv\Scripts\activate

# On macOS/Linux
source myenv/bin/activate

بمجرد تنشيط بيئتك الافتراضية، تابع وتثبيت Django:

pip install django

وهكذا، أنت جاهز لبدء البناء!

الخطوة 2: إنشاء مشروع جانغو جديد

فلنبدأ بإنشاء مشروع Django جديد. قم بتشغيل الأمر التالي لإنشاء المشروع:

django-admin startproject myproject

سيقوم هذا الأمر بإنشاء دليل جديد يسمى myproject، وسيحتوي على البنية التالية:

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

• manage.py: برنامج نصي يساعدك على إدارة المشروع (على سبيل المثال، بدء تشغيل الخادم، وترحيل قواعد البيانات).
• settings.py: يحتوي على جميع إعدادات التكوين لمشروع Django، مثل معلومات قاعدة البيانات والتطبيقات المثبتة.
• urls.py: حيث يمكنك تعيين عناوين URL لطرق العرض المقابلة لها.

الخطوة 3: تشغيل خادم التطوير

حسنًا، حان الوقت لمعرفة ما إذا كان كل شيء يعمل أم لا. انتقل إلى مجلد المشروع الخاص بك وابدأ خادم التطوير:

cd myproject
python manage.py runserver

الآن، افتح المتصفح وانتقل إلى http://127.0.0.1:8000/. من المفترض أن تشاهد صفحة الترحيب الافتراضية لـ Django، مكتملة بسفينة صاروخية. وهذا يعني أن مشروعك جاهز للعمل، وهو رائع!

الخطوة 4: إنشاء تطبيق جانغو

تشبه مشاريع جانغو الصناديق الكبيرة، وداخل هذه الصناديق، لدينا صناديق أصغر تسمى "التطبيقات". التطبيقات هي مكونات معيارية لمشروعك، مثل مدونة، أو نظام مصادقة المستخدم، أو وحدة التجارة الإلكترونية.

لنقم بإنشاء تطبيق يسمى blog عن طريق تشغيل هذا الأمر:

python manage.py startapp blog

سيؤدي هذا إلى إنشاء مجلد جديد باسم blog يحتوي على ملفات مثل view.py وmodels.py وغيرها لمساعدتك في تنظيم التعليمات البرمجية الخاصة بك.

للسماح لـ Django بمعرفة تطبيقك الجديد، أضف "blog" إلى قائمة INSTALLED_APPS في myproject/settings.py:

INSTALLED_APPS = [
    ...
    'blog',
]

الخطوة 5: تحديد النماذج

النموذج في Django هو ببساطة فئة Python التي تحدد كيفية تنظيم بياناتك. افتح blog/models.py وحدد نموذجًا بسيطًا لمنشور مدونة:

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    date_created = models.DateTimeField(auto_now_add=True)

• العنوان: حقل نصي قصير لعنوان المنشور.
• المحتوى: حقل نصي أطول لمحتوى المنشور.
• date_created: يقوم تلقائيًا بتخزين تاريخ إنشاء المنشور.

الآن، نحتاج إلى تطبيق هذه التغييرات على قاعدة البيانات الخاصة بنا عن طريق تشغيل الأوامر التالية:

python manage.py makemigrations
python manage.py migrate

ستعمل هذه الأوامر على إنشاء جداول قاعدة البيانات اللازمة لنموذج النشر.

الخطوة 6: إنشاء طرق العرض والقوالب

العرض هو المكان الذي يحدث فيه المنطق. فهو يأخذ طلبًا ويعيد استجابة، وغالبًا ما يعرض صفحة HTML. لنقم بإنشاء طريقة عرض لعرض جميع منشورات المدونة. افتح blog/views.py وأضف:

from django.shortcuts import render
from .models import Post

def home(request):
    posts = Post.objects.all()
    return render(request, 'blog/home.html', {'posts': posts})

يسترد هذا العرض الرئيسي جميع المشاركات من قاعدة البيانات ويرسلها إلى قالب يسمى home.html.

بعد ذلك، لنقم بإنشاء القالب. داخل دليل blog/، أنشئ مجلدًا باسم templates/blog/ وأضف ملفًا باسم home.html:

    
Blog Posts
    {% for post in posts %}
        

            
{{ post.title }}
            
{{ post.content }}
            Published on: {{ post.date_created }}
        
    {% endfor %}

سيعرض كود HTML هذا جميع المشاركات مع عنوانها ومحتواها وتاريخ إنشائها.

الخطوة 7: إعداد توجيه URL

الآن، نحتاج إلى إعداد توجيه URL لربط العروض بعناوين URL الصحيحة. في الدليل blog/، أنشئ ملفًا باسم urls.py (إذا لم يكن موجودًا) وأضف:

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='blog-home'),
]

ثم قم بتضمين عناوين URL للمدونة في ملف urls.py الخاص بالمشروع الرئيسي:

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('blog.urls')),
]

بهذه الطريقة، عندما يزور شخص ما عنوان URL الجذر، سيعمل Django على عرض الصفحة الرئيسية من تطبيق المدونة.

الخطوة 8: اختبار التطبيق الخاص بك

أنت على وشك الوصول! لنقم بتشغيل الخادم مرة أخرى ونرى ما إذا كانت مدونتنا تعمل:

python manage.py runserver

ارجع إلى http://127.0.0.1:8000/ في متصفحك، وسترى قائمة بجميع منشورات مدونتك — تهانينا، لقد أنشأت أول تطبيق Django!

موارد إضافية

• وثائق جانغو - الوثائق الرسمية هي كنز من المعلومات والأمثلة.
• Python-Anaconda Stack - تعرف على كيفية استخدام Python مع Anaconda لعلوم البيانات.
• أفضل أطر تطوير الويب - اكتشف أفضل أطر تطوير الويب، بما في ذلك Django.

خاتمة

في هذا الدليل، تناولنا كيفية إعداد بيئة Django، وإنشاء مشروع جديد، وإنشاء تطبيق تدوين بسيط. يحتوي Django على الكثير من الميزات المضمنة التي تجعل تطوير الويب أسرع وأسهل، حتى تتمكن من التركيز على بناء ما هو أكثر أهمية. إذا كنت مستعدًا للمزيد، فاطلع على صفحة Django Stack الخاصة بـ Code Clash للتعمق أكثر في عالم Django.

سعيد بالبرمجة، ومرحبًا بكم في مجتمع جانغو!