如何自定義sphinx文件makefile？

Question

我想知道是否有自定義獅身人面像文件的生成文件？

我想實現的是每次我做make html時，sphinx都會進入某個目錄並將特定文件複製到我的source目錄中。

---

例如：

假設我有一個~/bar目錄下名爲名foo.py腳本。我想將foo.py複製到~/docs/source/目錄，該目錄將由我的project.rst引用。

---

我想這樣做的原因是，我要保持我的文檔參考爲最新版本的劇本，我討厭做我每做make html時間複製粘貼。

我知道我可以用一個簡單的shell腳本實現這個目的。但是，我想知道我是否可以通過獅身人面像文件直接做到這一點？

非常感謝！

Answer 1

一個簡單的解決方案是創建一個符號/硬鏈接（ln -s path/to/destination path/to/link，刪除硬鏈接-s）。

在你的情況下，ln -s ~/bar/foo.py ~/docs/source/foo.py將在~/docs/source/目錄中創建一個鏈接（始終保持最新狀態，因爲它只是指向原始文件的鏈接）。

對於發燒友或更完整的Makefile規則，看看this customized sphinx Makefile。有很多規則可以通過網絡或從一個目錄發送文件到另一個目錄（在我的案例中爲~/web-sphinx/.build/html/*到~/Public/）。