警告：autodoc：无法导入模块＆＃x27; upload_data_to_server＆＃x27;来自模块＆＃x27;手册＆＃x27;;

Question

我正在尝试使用Sphinx的AutoDoc扩展名来记录Django项目。我有两个主要问题：

1. 它记录了一些模块中的多余问题（我不想从django导入文档），
2. 它根本没有记录其中一个软件包。

这是我的django树：

|main_app
|   core
|      migrations
|      static
|      templates
|      consumers.py
|      forms.py
|      models.py
|      routing.py
|      serializers.py
|      urls.py
|      views.py
|   main_app
|      asgi.py
|      settings.py
|      urls.py
|      wsgi.py
|   manual
|      upload_data_to_server.py
|   manage.py
|   docs
|      _build
|      _static
|      _templates
|      conf.py
|      index.rst
|      make.bat
|      Makefile

DOCS文件是我创建的文件，该文件是为了托管sphinx-QuickStart创建的文件。然后，我更改了conf.py添加此行的文件：

import os
import sys
import django
sys.path.insert(0, os.path.abspath('..'))
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "main_app.settings")
django.setup()


extensions = ['sphinx.ext.autodoc', 'sphinx.ext.napoleon']

然后我更改了index.rst添加模块：

Welcome to yourProject's documentation!
====================================

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   modules


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

我执行了sphinx-- apidoc -o。 ..和./进行HTML。我得到的是类似于我想要的东西，但是正如我之前所说的，我对Django文件有太多评论，而对手册软件包根本没有评论。 我正在将此手册包用于Django之外的内容，例如将某些数据从某些Excel上传到服务器上的数据库。因此，它不会遵循Django设置。但是如何将其指定为狮身人面像？当./做html：

WARNING: autodoc: failed to import module 'upload_data_to_server' from module 'manual';

我是否需要在conf.py中添加一些新路径？

另一方面，如何手动“清洁”或编辑由AutoDoc创建的评论？