Oprava varování při buildu dokumentace #154
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "sphinx-manager-descriptor"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Build dokumentace měl 346 varování a nenaimportoval řadu modulů. Po tomto PR zbývá jen 5 varování
toc.not_included.Managery zděděných modelů
sphinxcontrib_djangopatchujeManagerDescriptor.__get__nareturn self.manager, což je u zděděných managerů manager rodiče.Tema.objectstak dotazovalProblem(order_by('rocnik')→FieldError) aTextNodeViewSet/CastNodeViewSetdostaly v routeru stejný basenamepolymorphicmodel. Kvůli tomu padaly importytvorba.views,tvorba.urls,various.*,treenode.routersamamweb.urls.Oprava: v
setup()vdocs/conf.py(běží až po setupu rozšíření) patch přepíšeme verzí, která vrací manager dané třídy jako Django.Staré vygenerované moduly
docs/modulesje celé generované (a v.gitignore), alesphinx-apidoc -fstaré soubory nemaže. Zůstávaly tam moduly poseminar.*,treenode.modelsa migracích → chyby importu a stovky duplicit.make htmlteďmodulesnejdřív smaže.Kolize labelů sekcí
autosectionlabeldělal z nadpisů globální labely, takže stejné nadpisy v různých souborech kolidovaly (manage.py,Make skripty,Dokumentace,Testy). Zapnutoautosectionlabel_prefix_document, existující:ref:odkazy převedeny na tvardokument:Nadpis. Opakované „Názory“ v rámci jednoho zápisu jsou přejmenované na „Názory na …“.Drobnosti
tvorba/utils.py,prednasky/models.pyagalerie/__init__.py(reST formátování, neexistující role:py:module:)index.rst,skripty.rst,vyvoj.rsta odrážka vcss.rstLokální výpis varování
settings_localmádisable_existing_loggers: True, takže každédjango.setup()vypnulo loggery Sphinxu a lokální build nevypisoval varování ani průběh.conf.pyteď nastavíLOGGING_CONFIG = None, takže Django při buildu dokumentace logging vůbec nekonfiguruje.Zbývá
april.rst,css.rst,default_doc.rst,docker.rstastruktura.rstnejsou v žádném toctree – buď přidat doindex.rst, nebo označit:orphan:.🤖 Generated with Claude Code
https://claude.ai/code/session_01LX8JE3FxJfRKaAQN8kLQMT
Sphinx: správné managery zděděných modelůto Oprava varování při buildu dokumentace