我使用sphinx来记录大量的python文件,这些文件分布在庞大的目录层次中。此外,许多文件具有相同的名称(但存在于不同的路径中)。 我尝试创建不同的.rst文件并使用:include:每个文件使用不同的路径,然后将所有.rst放在主rst(index.rst)中 - 但autodoc仅与第一个.rst文件相关与第一个文件相关的其余文件(当我试图为第一个文件中的类做autoclass时,它无法找到它,因为它认为我在第一个文件中......)。 / p>
我的问题:有没有办法让autodoc与文件/模块相关,因为它们具有相同的名称? (改变他们的名字不是一个选择)。另外,有没有办法在生成的html文件中表达文件目录层次结构?