我正在Sphinx中创建教材，我经常想将学生重定向到给定的手册页。 Sphinx有一个很好的内部语法，例如:manpage:ls(1)。不幸的是，Sphinx只对它应用了一些格式，导致纯文本输出。我希望Sphinx使用给定的联机帮助页呈现指向某个网页的链接，类似于:rfc:标记的方式。
以某种方式可行吗？有没有办法轻松地重写:manpage:宏，所以我可以做到这一点？
答案 0 :(得分：4)
我找不到任何解决方案，所以我编写了一个提供:linuxman:角色并创建自定义链接的插件，源代码可在此处获取：https://github.com/tdi/sphinxcontrib-manpage。
pypi上有eplugin，您可以通过以下方式安装：pip install sphinxcontrib-manpage。
该用法类似于sphinx的:manpage:角色，您只需编写：:linuxman:ls(1)，并生成指向http://linux.die.net/man/1/ls的链接。可以在conf.py中配置网址。