有獅身人面像報告損壞的鏈接

Question

當建立HTML文檔時，你如何強制獅身人面像報告，或創建一個錯誤，在不存在的鏈接？

具體來說，我有我的Python項目中的屬性和方法已被刪除或重命名，並很難找到所有的死鏈接與獅身人面像生成的HTML輸出。

我覺得我正盯着這裏的答案： http://sphinx-doc.org/glossary.html，如在開篇中所描述的。

我顯然不理解的東西。

Answer 1

我認爲CheckExternalLinksBuilder是你在找什麼。

它基本上通過調用'sphinx-build'與-b linkcheck選項使用。有關更多信息，請參閱sphinx-build。另外，請看一下sphinx-extensions的列表here和here。

Answer 2

將nitpicky配置變量設置爲True（運行sphinx-build時，也可以使用-n option）。

在nitpicky模式下，對函數（如:func:`myfunc`），類或其他無法找到的對象的交叉引用將生成警告消息。