獅身人面像不生成聲明模塊的文檔

Question

我直接跟着this tutorial。

我的代碼住在N:/Tools/data/generic_accessor.py。

而且generic_accessor.py包含的東西，如：

def access_hfri_returns(terms=[]): 
    """ 
    This accesses HFRI returns data. 
    Returns: 

    """ 

在generic_accessor只有功能，沒有課。

我說：

sys.path.insert(0,"N:\\Tools\\data") 

到N:\Tools\data\conf.py。

我N:\Tools\data\index.rst寫着：

.. data documentation master file, created by 
    sphinx-quickstart on Fri Feb 24 11:52:57 2017. 
    You can adapt this file completely to your liking, but it should at least 
    contain the root `toctree` directive. 

Welcome to data's documentation! 
================================ 

Contents: 

.. toctree:: 
    :maxdepth: 2 

.. automodule:: generic_accessor 

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

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

我重新make html但我N:\Tools\data\_build\html\index.html看起來是這樣的：

我沒有看到文檔generic_accessor任何地方。

感謝您的任何指導。

Answer 1

嘗試下面的修改。請注意，我正在使用.txt文件。

index.txt

.. data documentation master file, created by 
    sphinx-quickstart on ... 
    You can adapt this file completely to your liking, but it should at least 
    contain the root `toctree` directive. 

Welcome to data's documentation! 
=================================== 

Contents: 

.. toctree:: 
    :maxdepth: 2 

    generic_accessor 




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

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

generic_accessor.txt

:mod:`generic_accessor` 
========================== 

.. automodule:: generic_accessor 
    :members: 
    :undoc-members: 
    :inherited-members: 
    :show-inheritance: