如何为django项目构建sphinx文档

pip install sphinx

sphinx-quickstart

import os
import sys
sys.path.insert(0, os.path.abspath('.'))

import django
django.setup()

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.doctest',
    'sphinx.ext.coverage',
    'sphinx.ext.viewcode',
    'sphinx.ext.napoleon',
    'sphinx.ext.todo',
]

autodoc_default_flags = ['members', 'undoc-members', 'private-members', 'special-members', 'show-inheritance']
autodoc_member_order = 'bysource'

source_suffix = '.rst'
master_doc = 'index'

project = 'Your Django Project'
copyright = '2021, Your Name'
author = 'Your Name'

version = '0.1'
release = '0.1.0'

language = None

exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

pygments_style = 'sphinx'

html_theme = 'sphinx_rtd_theme'
html_static_path = ['_static']
htmlhelp_basename = 'YourDjangoProjectdoc'

latex_elements = {
    'papersize': 'a4paper',
    'pointsize': '10pt',
    'preamble': '',
}

latex_documents = [
    (master_doc, 'YourDjangoProject.tex', 'Your Django Project Documentation', 'Your Name', 'manual'),
]

man_pages = [
    (master_doc, 'yourdjangoproject', 'Your Django Project Documentation', [author], 1)
]

texinfo_documents = [
    (master_doc, 'YourDjangoProject', 'Your Django Project Documentation', author, 'YourDjangoProject', 'One line description of project.', 'Miscellaneous'),
]

todo_include_todos = True

My App Documentation
=====================

.. automodule:: myapp
    :members:
    :undoc-members:
    :private-members:
    :special-members:
    :show-inheritance:

make html