为什么 Sphinx 不将 :kbd: roles 翻译成 HTML 的 <kbd> 标签？

Question

我想将键盘键和输入标记为键 "icons"。 Sphinx 提供了一个 :kbd: 角色来标记单个字符或单词，但生成的 HTML 包含 <code class="kbd ......"> 个标签。

那么为什么 Sphinx 不将 :kbd: 角色翻译成 HTML 的标签？

（我使用的是阅读文档主题。）

我发现一些 CSS 可以将 <kbd> 标签转换成漂亮的键。

kbd
{
  -moz-border-radius:3px;
  -moz-box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 2px #fff inset;
  -webkit-border-radius:3px;
  -webkit-box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 2px #fff inset;
  background-color:#f7f7f7;
  border:1px solid #ccc;
  border-radius:3px;
  box-shadow:0 1px 0 rgba(0,0,0,0.2),0 0 0 2px #fff inset;
  color:#333;
  display:inline-block;
  font-family:Arial,Helvetica,sans-serif;
  font-size:11px;
  line-height:1.4;
  margin:0 .1em;
  padding:.1em .6em;
  text-shadow:0 1px 0 #fff;
}

来源：http://meta.superuser.com/questions/4788/css-for-the-new-kbd-style

Answer 1

relevant issue 现已关闭，Sphinx 确实使用了 kbd 标签。

为什么 Sphinx 不将 :kbd: roles 翻译成 HTML 的 <kbd> 标签？

Why doesn't Sphinx translate :kbd: roles to HTML's <kbd> tags?

html

css

restructuredtext

python-sphinx

read-the-docs