獅身人面像會使用導入不好的代碼嗎？

Question

Sphinx文檔引擎是否會成功生成導入不好的項目的文檔？特別是我的項目具有異國情調的依賴。我不希望文檔生成依賴於這種依賴性。

Sphinx是否需要導入我的模塊並使用自省或解析？

Answer 1

Core Sphinx根本不觸碰你的代碼。該autodoc擴展呢，它的確進口它：

對於獅身人面像（實際上，執行獅身人面像Python解釋器）來找到你的模塊，它必須是可導入。

Answer 2

如果您使用的是autodoc擴展，那麼是的，您的項目必須是可導入的。但是有時候可以在你的conf.py中剔除依賴關係（因爲大概在導入的時候，依賴關係只是名義上的）。閱讀文檔文檔有一個例子how to do this。