mamweb/docs/default_doc.rst

Defaultní dokumentace speciálních souborů
=========================================

Drobná nápověda k běžným django souborům. (Do nich jsem to vkládal copy-paste.)

admin.py
--------
Soubor sloužící k definici toho, co bude v adminu. Většinou pouhým zavoláním
funkce :func:`django.contrib.admin.site.register`, v případě, že chceme něco
upravit, tak jako třída rozšiřující :class:`django.contrib.admin.ModelAdmin`
s dekorátorem :func:`django.contrib.admin.register`.

Zde se definuje admin pro:

apps.py
-------
Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.

forms.py
--------
Formuláře (:class:`django.forms.Form`) umožňují jednoduchou tvorbu formulářů,
které lze pak jednoduše dát do frontendu i zpracovat na backendu.

Pro přidání políčka do formuláře je potřeba
 - mít v modelu tu položku, kterou chci upravovat
 - přidat do views (prihlaskaView, resitelEditView)
 - přidat do forms
 - includovat do html

models.py
---------
Tento soubor slouží k definici databázového modelu.

Třídy rozšiřují většinou :class:`django.db.models.Model` a jejich atributy jsou
většinou sloupce v databázi (tj. nastaví se na hodnotu něčeho z :mod:`django.db.models`).
Na výběr jsou:

	- :class:`django.db.models.TextField`
	- :class:`django.db.models.ForeignKey`
	- :class:`django.db.models.DateField`
	- :class:`django.db.models.DateTimeField`
	- :class:`django.db.models.ImageField`
	- :class:`django.db.models.CharField`

testutils.py
------------
Soubor sloužící ke generování testdat.

urls.py
-------
Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:

views.py
--------