製作：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中配置。