Sphinx不会记录所有课程

Question

我正在尝试使用Sphinx作为我的文档。令人惊讶的是，它适用于某些类和模块，而有些则不适用。

您可以在下面找到源文件和.rst文件，其中sphinx不会添加该类。

我使用Sphinx的'sphinx.ext.autodoc'扩展名。

为什么Sphinx不会将我的类添加到文档中？在这种情况下如何调试Sphinx？

我的Sphinx文件：my_project.analyzers.content_ascii.rst

my_project.analyzers.content_ascii package
==========================================

Submodules
----------

my_project.analyzers.content_ascii.wl_redo_detect_date module
--------------------------------------------------------------

.. automodule:: my_project.analyzers.content_ascii.wl_redo_detect_date
    :members:
    :undoc-members:
    :show-inheritance:


Module contents
---------------

.. automodule:: my_project.analyzers.content_ascii
    :members:
    :undoc-members:
    :show-inheritance:

代码文件：__ init__.py

#!/usr/bin/python
# -*- coding: utf-8 -*-
'''
Created on Jan 24, 2014

@author: me
'''

from some_other_project.file_tools import execute_string    
from my_project.analyzers import Analyzer    
from other_project.handler.Handler import Handler

TARGET_ENCODING = 'utf-8'

class ExtractContentAscii(Analyzer):
    '''

    Further improvements: do this and that.
    '''

    def __init__(self):
        Analyzer.__init__(self)

# ...

Answer 1

我意识到Sphinx需要所有依赖项才能创建文档。不只是工作区中的所有其他项目。甚至外部项目也需要在像celery或django这样的路径中使用。

为了解决这个问题：

1）将工作区中的所有依赖项添加到路径中，例如在Sphinx的config.py中：

import os
import sys

def add_to_path():

    partial_path = os.path.join(os.path.dirname(os.path.realpath(__file__)), '../../')
    workspace_path = os.path.abspath(partial_path)
    assert os.path.exists(workspace_path)

    projects = []

    for current, dirs, c in os.walk(str(workspace_path)):
        for dir in dirs:

            project_path = os.path.join(workspace_path, dir, 'src')

            if os.path.exists(project_path):
                projects.append(project_path)

    for project_str in projects:
        sys.path.append(project_str)

add_to_path()

2）检查系统上是否安装了所有必需的外部依赖项。处理这些依赖关系的好方法是来自setup.py的distutils文件。

3）构建您的文档

> make clean; make html;

现在，所有文件都应该由Sphinx正确记录。

Answer 2

添加此元素对我来说至关重要：

：显示继承：

没有这个，我有两个模块，没有任何类被选中，还有3个模块，其中看似随机的类被忽略了。