python-sphinx - 制作 :manpage: provide a links to webpages

Question

我正在使用 Sphinx 创建教材，我经常想将学生重定向到给定的手册页。 Sphinx 对此有一个很好的内部语法，例如:手册页:ls(1)。不幸的是，Sphinx 仅对此应用了一些格式，从而导致纯文本输出。我希望 Sphinx 使用给定的联机帮助页呈现指向某个网页的链接，类似于 :rfc: 标记的处理方式。

是否可行？有没有一种方法可以轻松地重写 :manpage: 宏，这样我就可以实现这个目标？

Answer 1

我找不到任何解决方案，所以我编写了一个提供 :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 的链接。生成。 url 可以在 conf.py 中配置。