我正在用 Sphinx 创建教材，我经常想将学生重定向到给定的手册页。Sphinx 对此有一个很好的内部语法，例如:manpage:ls(1). 不幸的是，Sphinx 只对此应用了一些格式，从而导致纯文本输出。我希望 Sphinx 使用给定的手册页呈现指向某个网页的链接，就像它为:rfc:标签所做的那样。
以某种方式可行吗？有没有办法轻松重写:manpage:宏，所以我可以做到这一点？
问问题
195 次
1 回答
5
我找不到任何解决方案，所以我编写了一个提供:linuxman:角色并创建自定义链接的插件，源代码可在此处获得：https ://github.com/tdi/sphinxcontrib-manpage 。
eplugin 在 pypi 上可用，您可以通过以下方式安装它：pip install sphinxcontrib-manpage.
用法和sphinx的作用类似:manpage:，你只要写：就会生成一个http://linux.die.net/man/1/ls:linuxman:ls(1)的链接。url 可以在.conf.py
于 2013-10-01T08:42:13.863 回答