django-template/README.md

Django Özel Başlangıç Şablonu (Django Boilerplate)

Bu depo, yeni Django projelerine standart, hızlı ve temiz bir şekilde başlamak için hazırlanmış özel bir projedir. Klasik boş Django kurulumunun aksine, yapılandırılmış ayarlar ve hazır bir arayüz ile birlikte gelir.

🚀 Özellikler

• Hızlı Kurulum: Tek bir komutla tüm proje dizini hazır hale gelir.
• Dahili Uygulama (jcore): Ana yönlendirmeler, temel view (görünüm) mantığı ve URL yapılandırması için hazır jcore uygulaması projeye entegredir.
• Modern Arayüz: Bootstrap 5 kullanılarak hazırlanmış, mobil uyumlu ve şık bir varsayılan ana sayfa (index.html) şablonu içerir.
• Dinamik İsimlendirme: Şablon çekildiği anda tüm .py ve .html dosyalarındaki değişkenler otomatik olarak oluşturduğunuz yeni projenin adını alır.

🛠️ Gereksinimler

• Python 3.x
• Kurulum yapılacak ortamda Django'nun yüklü olması (pip install django)

📦 Kullanım

Yepyeni bir projeye başlamak için terminalinizi açın, sanal ortamınızı aktif edin ve aşağıdaki komutlardan birini çalıştırın:

# Gitea üzerinden doğrudan proje oluşturmak için:
django-admin startproject --template=https://gitea.ta1sph.info/suphicakir/django-template/archive/main.zip --extension py,html proje_adi

# Yerel diskteki bu depodan proje oluşturmak için:
django-admin startproject --template=/path/to/djtemplate --extension py,html proje_adi

Komut tamamlandığında proje_adi/ dizini oluşur; project_name olarak adlandırılmış paket dizini ve içindeki tüm .py/.html dosyaları otomatik olarak proje_adi ile değiştirilir. SECRET_KEY de otomatik olarak yeni ve rastgele bir değerle doldurulur.

Ardından:

cd proje_adi
python -m venv venv && source venv/bin/activate
pip install django
python manage.py migrate
python manage.py runserver