问制作:主页:提供网页链接
EN

Stack Overflow用户

提问于 2013-09-28 16:56:44

回答 1查看 231关注 0票数 2

我正在用狮身人面像制作教材，我经常想要将学生重新定向到给定的手册页。狮身人面像有一个很好的内部语法，例如:manpage:ls(1)。不幸的是，Sphinx只对此应用了一些格式，从而产生了纯文本输出。我希望狮身人面像呈现一个链接到某个网页与给定的手册页，类似于它是如何为:rfc:标签。

不知何故是可行的？有没有一种方法可以轻松地重写:manpage:宏，这样我就可以实现这一点了？

回答已采纳

发布于 2013-10-01 08:42:13

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

这个eplugin可以在pypi上使用，您可以通过：pip install sphinxcontrib-manpage安装它。

它的用法类似于斯芬克斯的:manpage:角色，您只需编写：:linuxman:ls(1)并生成一个指向http://linux.die.net/man/1/ls的链接。url可以在conf.py中配置。

票数 5

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/19069402

复制

相似问题

问制作:主页:提供网页链接EN