search

sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.55k stars 2.12k forks source link

manpage role display as a <em> label #8155

Closed cathaysia closed 3 years ago

cathaysia commented 4 years ago

Describe the bug

I try use this role:

:manpage:`semanage(8)`

I think this code should became a url, but a label instead.

To Reproduce Steps to reproduce the behavior:

make.bat html

Expected behavior manpage role beacme a url.

Your project new.zip

Screenshots

图片

Environment info

  • OS: Win10 2004

  • Python version: 3.8.5

  • Sphinx version: 3.2.1

  • Sphinx extensions: sphinx-materialdesign-theme, recommonmark, sphinxcontrib.plantuml

  • Extra tools: vsode, powershell

Additional context

  • [e.g. URL or Ticket]

https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html

This issue is produce even through I use the default theme.

tk0miya commented 3 years ago

The manpage role will be rendered as a hyperlink only if you set manpages_url config value. It seems your example does not set it. Please check your settings again. Thanks,