Note that there are some explanatory texts on larger screens.

plurals
  1. POdjango sphinx automodule -- basics
    primarykey
    data
    text
    <p>I have a project with several large apps and where settings and apps files are split.</p> <p>directory structure goes something like that:</p> <p><strong>project_name</strong></p> <ul> <li>__init__.py</li> <li>apps <ul> <li>__init__.py</li> <li>app1</li> <li>app2</li> </ul></li> <li>3rdparty <ul> <li>__init__.py</li> <li>lib1</li> <li>lib2</li> </ul></li> <li>settings <ul> <li>__init__.py</li> <li>installed_apps.py</li> <li>path.py</li> <li>templates.py</li> <li>locale.py</li> <li>...</li> </ul></li> <li>urls.py</li> </ul> <p><strong>every app is like that</strong></p> <ul> <li>__init__.py</li> <li>admin <ul> <li>__init__.py</li> <li>file1.py</li> <li>file2.py</li> </ul></li> <li>models <ul> <li>__init__.py</li> <li>model1.py</li> <li>model2.py</li> </ul></li> <li>tests <ul> <li>__init__.py</li> <li>test1.py</li> <li>test2.py</li> </ul></li> <li>views <ul> <li>__init__.py</li> <li>view1.py</li> <li>view2.py</li> </ul></li> <li>urls.py</li> </ul> <p>how to use a sphinx to autogenerate documentation for that?</p> <p>I want something like that for each in settings module or INSTALLED_APPS (not starting with django.* or 3rdparty.*) give me a auto documentation output based on docstring</p> <p>and autogen documentation and run tests before git commit</p> <p>btw. I tried doing .rst files by hand with</p> <pre><code>.. automodule:: module_name :members: </code></pre> <p>but is sucks for such a big project, and it does not works for settings</p> <p>Is there an autogen method or something?</p> <p>I am not tied to sphinx, is there a better solution for my problem?</p>
    singulars
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload