为什么Sphinx不将:kbd:角色翻译为HTML的<kbd>标签?

4
我希望将键盘按键和输入标记为键“图标”。 Sphinx 提供了一个:kbd:角色来标记单个字符或单词,但生成的 HTML 包含<code class="kbd ......"> 标签。
那么,为什么 Sphinx 不将:kbd:角色转换成 HTML 中的<kbd>标签呢?
(我正在使用 read-the-docs 主题。)
我发现一些 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

本文讨论如何使用CSS样式来自定义键盘(kbd)元素的外观。可以设置字体、颜色、边框等样式,以满足特定需求。

这里有一个关于sphinx-doc的相关讨论。 - Paebbels
1个回答

1

相关问题 现已关闭,Sphinx确实使用kbd标签。


网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接