如何自定义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/）。