Tahle moje „dokumentace“ je k ničemu, mažu

aesop/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 class AesopConfig(AppConfig):

aesop/urls.py

@@ -1,10 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``aesop-export/mam-rocnik-<int:prvni_rok>.csv`` (seminar_export_rocnik) :class:`~aesop.views.ExportRocnikView`
-- ``aesop-export/mam-sous-<str:datum_zacatku>.csv`` (seminar_export_sous) :class:`~aesop.views.ExportSousView`
-- ``aesop-export/index.csv`` (seminar_export_index) :class:`~aesop.views.ExportIndexView`
-"""
 from django.urls import path
 from aesop import views
 

aesop/views.py

@@ -1,8 +1,3 @@
-"""
-Soubor sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request
-a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo
-třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`)
-"""
 import django
 from django.shortcuts import get_object_or_404
 from django.http import HttpResponse

api/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

api/urls.py

@@ -1,15 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``api/expor/skoly/`` (export_skoly) :func:`~api.views.exports.exportSkolView`
-- ``api/autocomplete/skola/`` (autocomplete_skola) :class:`~api.views.autocomplete.SkolaAutocomplete`
-- ``api/autocomplete/resitel/`` (autocomplete_resitel) :class:`~api.views.autocomplete.ResitelAutocomplete`
-- ``api/autocomplete/problem/odevzdatelny`` (autocomplete_problem_odevzdatelny) :class:`~api.views.autocomplete.OdevzdatelnyProblemAutocomplete`
-
-Na autocomplete v3 čeká:
-
-- ``autocomplete/organizatori/`` (seminar_autocomplete_organizator) :class:`~api.views.autocomplete.OrganizatorAutocomplete`
-"""
 from django.urls import path
 from . import views
 from seminar.utils import org_required

api/views/__init__.py

@@ -1,7 +1,2 @@
-"""
-Soubory sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request
-a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo
-třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`)
-"""
 from .autocomplete import *
 from .exports import *

galerie/urls.py

@@ -1,12 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``<int:pk>/`` :func:`~galerie.views.nahled`
-- ``<int:pk>/<int:fotka>/`` :func:`~galerie.views.detail`
-- ``<int:galerie>/new/`` :func:`~galerie.views.new_galerie`
-- ``<int:galerie>/plus/<int:subgalerie>/`` :func:`~galerie.views.plus_galerie`
-- ``<int:galerie>/minus/<int:subgalerie>/`` :func:`~galerie.views.minus_galerie`
-"""
 from django.urls import path
 from seminar.utils import org_required
 from . import views

header_fotky/admin.py

@@ -1,14 +1,3 @@
-"""
-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:
-
-- :class:`~header_fotky.models.FotkaHeader`
-- :class:`~header_fotky.models.FotkaUrlVazba`
-"""
 from django.contrib import admin
 from django.contrib.admin import ModelAdmin
 import header_fotky.models as m
@@ -22,4 +11,4 @@ class FotkaPozadiAdmin(ModelAdmin):
     readonly_fields = ['cas']
 
 admin.site.register(m.FotkaHeader, FotkaPozadiAdmin)
-admin.site.register(m.FotkaUrlVazba)
+admin.site.register(m.FotkaUrlVazba)

header_fotky/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

header_fotky/models.py

@@ -1,17 +1,3 @@
-"""
-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`
-"""
 from django.core.exceptions import ValidationError
 from django.db import models
 from django.utils import timezone

korektury/admin.py

@@ -1,13 +1,3 @@
-"""
-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:
-
-- :class:`korektury.models.KorekturovanePDF`
-"""
 from django.contrib import admin
 from reversion.admin import VersionAdmin
 from korektury.models import KorekturovanePDF

korektury/forms.py

@@ -1,13 +1,3 @@
-"""
-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
-"""
 from django import forms
 
 class OpravaForm(forms.Form):

korektury/models.py

@@ -1,17 +1,3 @@
-"""
-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`
-"""
 import os
 from django.db import models
 from django.utils import timezone

korektury/urls.py

@@ -1,11 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``korektury/`` (korektury_list) :class:`~korektury.views.KorekturySeskupeneListView`
-- ``korektury/neseskupene/`` (korektury_neseskupene_list) :class:`~korektury.views.KorekturyAktualniListView`
-- ``korektury/zastarale/`` (korektury_stare_list) :class:`~korektury.views.KorekturyZastaraleListView`
-- ``korektury/<int:pdf>/`` (korektury) :class:`~korektury.views.KorekturyView`
-"""
 from django.urls import path
 from seminar.utils import org_required
 from . import views

korektury/views.py

@@ -1,8 +1,3 @@
-"""
-Soubor sloužící k deklaraci jednotlivých „views“ (nejčastěji funkce beroucí request
-a vracející :func:`django.shortcuts.render` respektive nějakou response, nebo
-třídy většinou rozšiřující nějakou třídu z :mod:`django.views.generic`)
-"""
 from django.shortcuts import get_object_or_404, render
 from django.views import generic
 from django.conf import settings

mamweb/urls.py

@@ -1,18 +1,5 @@
 """
-Soubor sloužící jako základní „router“, tj. zde se includují veškeré ostatní urls:
-
-- ``admin/`` :mod:`django.contrib.admin.site.urls`
-- ``ckeditor/`` :mod:`ckeditor_uploader.urls`
-- :mod:`seminar.urls`
-- :mod:`odevzdavatko.urls`
-- :mod:`korektury.urls`
-- :mod:`prednasky.urls`
-- :mod:`soustredeni.urls`
-- :mod:`personalni.urls`
-- :mod:`various.autentizace.urls`
-- :mod:`api.urls`
-- :mod:`treenode.urls`
-- :mod:`aesop.urls`
+Soubor sloužící jako základní „router“, tj. zde se includují veškeré ostatní urls.
 """
 from django.urls import path, include
 from django.contrib.staticfiles.urls import staticfiles_urlpatterns

odevzdavatko/admin.py

@@ -1,9 +1,3 @@
-"""
-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`.
-"""
 from django.contrib import admin
 from django_reverse_admin import ReverseModelAdmin
 import seminar.models as m

odevzdavatko/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

odevzdavatko/urls.py

@@ -1,17 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``org/add_solution`` (seminar_vloz_reseni) :class:`~odevzdavatko.views.PosliReseniView`
-- ``resitel/nahraj_reseni`` (seminar_nahraj_reseni) :class:`~odevzdavatko.views.NahrajReseniView`
-- ``resitel/odevzdana_reseni/`` (seminar_resitel_odevzdana_reseni) :class:`~odevzdavatko.views.PrehledOdevzdanychReseni`
-- ``org/reseni/`` (odevzdavatko_tabulka) :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``org/reseni/rocnik/<int:rocnik>/`` (odevzdavatko_tabulka) :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``org/reseni/<int:problem>/<int:resitel>/`` (odevzdavatko_reseni_resitele_k_problemu) :class:`~odevzdavatko.views.ReseniProblemuView`
-- ``org/reseni/<int:pk>/`` (odevzdavatko_detail_reseni) :func:`~seminar.utils.viewMethodSwitch` + :class:`~odevzdavatko.views.DetailReseniView` + :func:`~odevzdavatko.views.hodnoceniReseniView`
-- ``org/reseni/all`` :class:`~odevzdavatko.views.SeznamReseniView`
-- ``org/reseni/akt`` :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``resitel/reseni/<int:pk>`` (odevzdavatko_resitel_reseni) :class:`~odevzdavatko.views.ResitelReseniView`
-"""
 from django.urls import path
 
 from seminar.utils import org_required, resitel_required, viewMethodSwitch, \

personalni/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

personalni/urls.py

@@ -1,17 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``org/add_solution`` (seminar_vloz_reseni) :class:`~odevzdavatko.views.PosliReseniView`
-- ``resitel/nahraj_reseni`` (seminar_nahraj_reseni) :class:`~odevzdavatko.views.NahrajReseniView`
-- ``resitel/odevzdana_reseni/`` (seminar_resitel_odevzdana_reseni) :class:`~odevzdavatko.views.PrehledOdevzdanychReseni`
-- ``org/reseni/`` (odevzdavatko_tabulka) :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``org/reseni/rocnik/<int:rocnik>/`` (odevzdavatko_tabulka) :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``org/reseni/<int:problem>/<int:resitel>/`` (odevzdavatko_reseni_resitele_k_problemu) :class:`~odevzdavatko.views.ReseniProblemuView`
-- ``org/reseni/<int:pk>/`` (odevzdavatko_detail_reseni) :func:`~seminar.utils.viewMethodSwitch` + :class:`~odevzdavatko.views.DetailReseniView` + :func:`~odevzdavatko.views.hodnoceniReseniView`
-- ``org/reseni/all`` :class:`~odevzdavatko.views.SeznamReseniView`
-- ``org/reseni/akt`` :class:`~odevzdavatko.views.TabulkaOdevzdanychReseniView`
-- ``resitel/reseni/<int:pk>`` (odevzdavatko_resitel_reseni) :class:`~odevzdavatko.views.ResitelReseniView`
-"""
 from django.urls import path
 from django.contrib.auth.decorators import login_required
 from . import views

prednasky/urls.py

@@ -1,12 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``prednasky/`` :func:`~prednasky.views.newPrednaska`
-- ``prednasky/hotovo`` :func:`~prednasky.views.Prednaska_hotovo`
-- ``prednasky/metaseznam_prednasek`` (metaseznam-list) :class:`~prednasky.views.MetaSeznamListView`
-- ``prednasky/seznam_prednasek/<int:seznam>/export`` (seznam-export) :func:`~prednasky.views.SeznamExportView`
-- ``prednasky/seznam_prednasek/<int:seznam>/`` (seznam-list) :class:`~prednasky.views.SeznamListView`
-"""
 from django.urls import path
 from seminar.utils import org_required, resitel_or_org_required
 from . import views

seminar/urls.py

@@ -1,34 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- Organizátoři
-	- ``o-nas/organizatori/`` (organizatori) :class:`~seminar.views.views_all.CojemamOrganizatoriView`
-	- ``o-nas/organizatori/organizovali/`` (stari_organizatori) :class:`~seminar.views.views_all.CojemamOrganizatoriStariView`
-- Archiv
-	- ``archiv/rocniky/`` (seminar_archiv_rocniky) :class:`~seminar.views.views_all.ArchivView`
-	- ``archiv/temata/`` (seminar_archiv_temata) :class:`~seminar.views.views_all.ArchivTemataView`
-	- ``rocnik/<int:rocnik>/`` (seminar_rocnik) :class:`~seminar.views.views_all.RocnikView`
-	- ``cislo/<int:rocnik>.<str:cislo>/`` (seminar_cislo) :class:`~seminar.views.views_all.CisloView`
-	- ``problem/<int:pk>/`` (seminar_problem) :func:`~seminar.views.views_all.problemView`
-- Zadání
-	- ``aktualni/zadani/`` (seminar_aktualni_zadani) :func:`~seminar.views.views_all.AktualniZadaniView`
-	- ``aktualni/vysledkova-listina/`` (seminar_aktualni_vysledky) :func:`~seminar.views.views_all.ZadaniAktualniVysledkovkaView`
-	- ``aktualni/rocnik/`` (seminar_aktualni_rocnik) :class:`~seminar.views.views_all.AktualniRocnikRedirectView`
-- Články
-	- ``archiv/clanky/`` (clanky_resitel) :class:`~seminar.views.views_all.ClankyResitelView`
-- Orgovské stránky
-	- ``rocnik/<int:rocnik>/vysledkovka.tex`` (seminar_rocnik_vysledkovka) :class:`~seminar.views.views_all.RocnikVysledkovkaView`
-	- ``rocnik/<int:rocnik>/resitele.csv`` (seminar_rocnik_resitele_csv) :func:`~seminar.views.views_all.resiteleRocnikuCsvExportView`
-	- ``cislo/<int:rocnik>.<str:cislo>/vysledkovka.tex`` (seminar_cislo_vysledkovka) :class:`~seminar.views.views_all.CisloVysledkovkaView`
-	- ``cislo/<int:rocnik>.<str:cislo>/obalky.pdf`` (seminar_cislo_obalky) :func:`~seminar.views.views_all.cisloObalkyView`
-	- ``cislo/<int:rocnik>.<str:cislo>/tituly.tex`` (seminar_cislo_titul) :func:`~seminar.views.views_all.TitulyView`
-	- ``stav`` (stav_databaze) :func:`~seminar.views.views_all.StavDatabazeView`
-	- ``cislo/<int:trocnik>.<str:tcislo>/odmeny/<int:frocnik>.<str:fcislo>/`` (seminar_archiv_odmeny) :class:`~seminar.views.views_all.OdmenyView`
-- Další
-	- `` `` (titulni_strana) :class:`~seminar.views.views_all.TitulniStranaView`
-	- ``jak-resit/`` (jak_resit) :class:`~seminar.views.views_all.JakResitView`
-	- ``stare-novinky/`` (stare_novinky) :class:`~seminar.views.views_all.StareNovinkyView`
-"""
 from django.urls import path, include, re_path
 from . import views
 from .utils import org_required

soustredeni/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

treenode/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

treenode/urls.py

@@ -1,8 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- Zatím tu nic moc není…
-"""
 from django.urls import path, re_path
 from . import views
 

various/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig
 
 

various/autentizace/forms.py

@@ -1,14 +1,3 @@
-"""
-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
-"""
-
 from django.contrib.auth.forms import AuthenticationForm
 from django.forms import BooleanField
 

various/autentizace/urls.py

@@ -1,16 +1,3 @@
-"""
-Soubor sloužící jako „router“, tj. zde se definují url adresy a na co ukazují:
-
-- ``prihlasit/`` (login) :class:`~various.autentizace.views.LoginView`
-- ``login/`` :class:`django.views.generic.base.RedirectView` předchozího
-- ``odhlasit/`` (logout) :class:`~various.autentizace.views.LogoutView`
-- ``logout/`` :class:`django.views.generic.base.RedirectView` předchozího
-- ``reset-hesla/`` (reset_password) :class:`~various.autentizace.views.PasswordResetView`
-- ``zmena-hesla/`` (change_password) :class:`~various.autentizace.views.PasswordChangeView`
-- ``zmena-hesla/2/`` (reset_password_done) :class:`~various.autentizace.views.PasswordResetDoneView`
-- ``reset-hesla/potvrzeni/<uidb64>/<token>/`` (reset_password_confirm) :class:`~various.autentizace.views.PasswordResetConfirmView`
-- ``reset-hesla/hotovo/`` (reset_password_complete) :class:`~various.autentizace.views.PasswordResetCompleteView`
-"""
 from django.urls import path
 from . import views
 from django.views.generic.base import RedirectView

vysledkovky/apps.py

@@ -1,6 +1,3 @@
-"""
-Soubor sloužící k pojmenování a jiným nastavením djangovské aplikace.
-"""
 from django.apps import AppConfig