Django Byrjendaleiðbeiningar: Byggðu fyrsta vefforritið þitt hratt

Django er háþróað Python vef-rammaverk sem miðar að hraðri þróun og hreinni hönnun. Það fylgir Model-Template-View (MTV) arkitektúrnum, hvetur til endurnýtingar kóða og einingaskiptingar. Þessi leiðarvísir mun leiða þig skref fyrir skref í gegnum gerð einfalds Django forrits, sem gerir þér kleift að byrja hratt.

1. Uppsetning umhverfis

Fyrst þarftu að ganga úr skugga um að Python sé uppsett á kerfinu þínu. Django mælir með Python 3.6 eða nýrri.

1.1 Uppsetning Python

Ef Python er ekki uppsett á kerfinu þínu geturðu hlaðið því niður og sett það upp af Python vefsíðunni.

1.2 Búðu til sýndarumhverfi (Virtual Environment)

Til að einangra ósjálfstæði milli mismunandi verkefna er eindregið mælt með því að nota sýndarumhverfi.

Opnaðu flugstöð eða skipanalínu.
Búðu til verkefnamöppu, til dæmis myproject:
```
mkdir myproject
cd myproject
```
Búðu til og virkjaðu sýndarumhverfi:
```
python3 -m venv venv  # Eða python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows
```
Eftir að hafa virkjað sýndarumhverfið mun flugstöðvavísirinn þinn sýna (venv), sem gefur til kynna að þú sért að nota sýndarumhverfi.

1.3 Uppsetning Django

Í virku sýndarumhverfi skaltu nota pip til að setja upp Django:

pip install Django

Staðfestu hvort uppsetningin hafi tekist:

python -m django --version

Þú ættir að geta séð útgáfunúmer Django.

2. Búðu til Django verkefni

Eftir að hafa sett upp Django geturðu búið til nýtt Django verkefni.

Vertu áfram í verkefnamöppunni þinni (myproject) og keyrðu eftirfarandi skipun:
```
django-admin startproject mysite
```
Þetta mun búa til möppu sem heitir mysite í myproject möppunni, sem inniheldur beinagrindarskrár Django verkefnisins.
Farðu inn í mysite möppuna:
```
cd mysite
```
Django verkefnaskipulagið er sem hér segir:
```
mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
```
- manage.py: Skipanalínutól til að stjórna Django verkefnum.
- mysite/: Python pakki sem inniheldur verkefnisstillingar.
  - __init__.py: Tóm skrá sem segir Python að líta á möppuna sem Python pakka.
  - settings.py: Stillingarskrá verkefnisins, svo sem gagnagrunnsstillingar, villuleitastillingar o.s.frv.
  - urls.py: URL leiðarstillingar, sem kortleggja URL slóðir á útsýnisföll.
  - asgi.py: ASGI (Asynchronous Server Gateway Interface) stillingarskrá, notuð til að dreifa ósamstilltum forritum.
  - wsgi.py: WSGI (Web Server Gateway Interface) stillingarskrá, notuð til að dreifa hefðbundnum samstilltum forritum.## 3. Ræstu þróunarþjóninn

Django kemur með léttan þróunarþjón sem gerir þér kleift að þróa og prófa á staðnum.

Í mysite möppunni, keyrðu eftirfarandi skipun:
```
python manage.py runserver
```
Opnaðu vafrann þinn og farðu á http://127.0.0.1:8000/. Þú ættir að sjá síðu sem segir "It worked! Congratulations on your first Django-powered page.".

4. Búðu til Django forrit

Eitt Django verkefni getur innihaldið mörg forrit. Við skulum búa til forrit sem heitir myapp.

Opnaðu nýjan skipanalínu glugga (hafðu þróunarþjóninn í gangi).
Í mysite möppunni, keyrðu eftirfarandi skipun:
```
python manage.py startapp myapp
```
Þetta mun búa til möppu sem heitir myapp í mysite möppunni, sem inniheldur beinagrindarskrár Django forritsins.
Django forritsmöppuskipulagið er sem hér segir:
```
myapp/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py
```
- __init__.py: Tóm skrá sem segir Python að líta á möppuna sem Python pakka.
- admin.py: Notað til að stilla Django stjórnborðið.
- apps.py: Forritsstillingar.
- migrations/: Notað til að stjórna gagnagrunnsflutningum.
- models.py: Skilgreinir gagnamódel (gagnagrunnstöflur).
- tests.py: Skrifar prófunartilvik.
- views.py: Skilgreinir útsýnisföll, meðhöndlar beiðnir og skilar svörum.

Í mysite/settings.py, bættu myapp við INSTALLED_APPS listann:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',  # Bættu við myapp
]

5. Búðu til einfalt útsýni

Nú búum við til einfalt útsýni sem sýnir "Hello, Django!" í vafranum.

Breyttu myapp/views.py skránni og bættu við eftirfarandi kóða:

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django!")

Búðu til myapp/urls.py skrá og kortleggðu URL á útsýnisfallið:

    from django.urls import path
    from . import views

    urlpatterns = [
        path('', views.index, name='index'),
    ]
    ```

3.  Bættu `myapp/urls.py` við `mysite/urls.py`:

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

    urlpatterns = [
        path('admin/', admin.site.urls),
        path('myapp/', include('myapp.urls')),  # Bætir við URL stillingum fyrir myapp
    ]
    ```

4.  Farðu á `http://127.0.0.1:8000/myapp/`. Þú ættir að sjá síðu með "Hello, Django!".

## 6. Búðu til líkan

Við skulum búa til einfalt líkan til að geyma gögn.

1.  Breyttu `myapp/models.py` skránni og bættu við eftirfarandi kóða:

    ```python
    from django.db import models

    class Question(models.Model):
        question_text = models.CharField(max_length=200)
        pub_date = models.DateTimeField('date published')

        def __str__(self):
            return self.question_text
    ```

    Þetta skilgreinir líkan sem heitir `Question` sem inniheldur tvo reiti: `question_text` (CharField) og `pub_date` (DateTimeField).

2.  Búðu til og notaðu gagnagrunnsflutninga:

    ```bash
    python manage.py makemigrations myapp
    python manage.py migrate
    ```

    `makemigrations` skipunin býr til flutningsskrár byggðar á líkaninu þínu og `migrate` skipunin notar flutningana á gagnagrunninn.

## 7. Notaðu Django stjórnborðið

Django býður upp á öflugt stjórnborð sem gerir þér kleift að stjórna gögnunum þínum á auðveldan hátt.

1.  Búðu til ofurnotanda:

    ```bash
    python manage.py createsuperuser
    ```

    Fylgdu leiðbeiningunum til að slá inn notendanafn, netfang og lykilorð.

2.  Breyttu `myapp/admin.py` skránni og skráðu `Question` líkanið:

    ```python
    from django.contrib import admin
    from .models import Question

    admin.site.register(Question)
    ```

3.  Farðu á `http://127.0.0.1:8000/admin/` og skráðu þig inn með ofurnotandanum sem þú bjóst til. Þú ættir að sjá "Questions" eininguna, þar sem þú getur bætt við, breytt og eytt spurningum.

## 8. Notaðu sniðmát

Að nota sniðmát gerir þér kleift að búa til HTML síður á sveigjanlegri hátt.
1. Búðu til möppu sem heitir `templates` í `myapp` möppunni og búðu síðan til möppu sem heitir `myapp` í `templates` möppunni ( `myapp/templates/myapp` ).

2. Búðu til skrá sem heitir `index.html` í `myapp/templates/myapp` möppunni og bættu við eftirfarandi kóða:

    ```html
    
    
        
            Hello, Django!
        
        
            The current time is: {{ current_time }}
        
    
    ```

3. Breyttu `myapp/views.py` skránni og notaðu sniðmát:

    ```python
    from django.shortcuts import render
    import datetime

    def index(request):
        now = datetime.datetime.now()
        return render(request, 'myapp/index.html', {'current_time': now})
    ```

    `render` fallið hleður sniðmátið og sendir gögnin til sniðmátsins til að birta það. 

4. Farðu aftur á `http://127.0.0.1:8000/myapp/`. Þú ættir að sjá síðu sem inniheldur núverandi tíma.

## 9. Niðurstaða

Með þessari handbók hefurðu lært grunnhugtök og notkun Django, þar á meðal uppsetningu umhverfis, stofnun verkefna og forrita, skilgreiningu líkana, stofnun skoðana og notkun sniðmáta. Þetta er bara byrjunin, Django býður upp á ríkulega virkni og þú getur haldið áfram að læra og kanna til að byggja upp flóknari vefforrit.