制作：manpage：提供链接到网页

Question

我在狮身人面像中创建教材，而且我经常想将学生重定向到给定的手册页。狮身人面像有一个很好的内部语法，例如:manpage:ls(1)。不幸的是狮身人面像只适用于一些格式，导致纯文本输出。我希望狮身人面像使用给定的联机帮助页来呈现某个网页的链接，与标记:rfc:的方式类似。

是不是可以做到？有没有一种方法可以轻松地重写:manpage:宏，所以我可以实现这一目标？

Answer 1

我找不到任何解决方案，所以我编写了一个插件，它提供了:linuxman:角色并创建了自定义链接，其源代码位于此处：https://github.com/tdi/sphinxcontrib-manpage。

th eplugin可在pypi上使用，您可以通过以下方式安装它：pip install sphinxcontrib-manpage。

其用法与sphinx的:manpage:角色类似，您只需编写：:linuxman:ls(1)并链接到http://linux.die.net/man/1/ls即可生成。该网址可以在conf.py中配置。