Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

<kbd> 和 `` 的区别? #3263

Closed
SkyeYoung opened this issue Jun 28, 2021 · 8 comments
Closed

<kbd> 和 `` 的区别? #3263

SkyeYoung opened this issue Jun 28, 2021 · 8 comments
Labels

Comments

@SkyeYoung
Copy link
Member

SkyeYoung commented Jun 28, 2021

我正在访问这个页面

Vim - OI Wiki

我发现页面有这样的问题

这个页面中混合使用了很多 <kbd>`<code>),在我尝试对该页面进行修改时,ksyx 在 #3258 (comment) 提到「可能可以使用 <kbd> 代替 `」,于是我去查了一下。

在 MDN 中提到「<kbd> represents a span of inline text denoting textual user input from a keyboard, voice input, or any other text entry device.」,也就是说我可以写 <kbd>:set nu! rnu!</kbd> 这样的。

但它又提到「<code> displays its contents styled in a fashion intended to indicate that the text is a short fragment of computer code.」,所以似乎也可以写成 `:set nu! rnu!`

我也尝试在 Stack Overflow 中进行了搜索,有一个问题是「What are the differences between kbd, samp and code in HTML」 ,里面的回答也基本和 MDN 中说的差不多。

emmm,可能是我理解能力有问题,在上述的搜寻过后,我仍然不知道什么时候用 <kbd>,什么时候用 `。所以,请问一下各位,就以 Vim - OI Wiki 为例,我应该如何区分使用 <kbd>` 的时机呢?

@welcome
Copy link

welcome bot commented Jun 28, 2021

感谢你对 OI Wiki 的关注!记得在 Issue 中表达清楚自己的意思哦~

@SkyeYoung SkyeYoung reopened this Jun 28, 2021
@SkyeYoung SkyeYoung changed the title 可能可以使用 <kbd></kbd> <kbd> 和 `` 的区别? Jun 28, 2021
@ksyx
Copy link
Member

ksyx commented Jun 28, 2021

这个我记得之前有讨论过
但是你理解有一些偏差
<kbd></kbd> 不是一整坨用的
3dd 🚫
3dd 👍
3dd 🤔

@SkyeYoung
Copy link
Member Author

这个我记得之前有讨论过
但是你理解有一些偏差
<kbd></kbd> 不是一整坨用的
3dd
3dd
3dd

@ksyx 然而 MDN 的文档里就是一坨……比如这个《Basic example

@ksyx
Copy link
Member

ksyx commented Jun 28, 2021

🤔 MDN 那个看上去并没有突出按键

@SkyeYoung
Copy link
Member Author

MDN 那个看上去并没有突出_按键_?

@ksyx

是这样的,默认就是没有样式的,只是换了个字体。实际上 <code><kbd> 的默认样式都一样,Stack Overflow 里的回答也提到了这一点,说这样子是最合适的,只是标签的语义不同。

对上面的例子,我也比较认同 3dd 的写法,但如果遇到比较长的该怎么写呢?

比如 :set nu! rnu! 这样的,照理来说也可以用 <kbd> 包裹,emmmm,但我也感觉是不合适的。

所以问题就是什么程度应该使用 <kbd> 去写,什么程度应该使用 ` 去写……

我有点纠结……感觉还是单独介绍某个按键作用的时候用 <kbd> ,其他情况就用 ` 好了。(而且写 <kbd> 好烦,如果是在线上编辑的话。)

@ksyx
Copy link
Member

ksyx commented Jun 28, 2021

set 那串倾向命令
3dd 倾向于击键

所以 set 用 codeblock 而 3dd 用 key?

@SkyeYoung
Copy link
Member Author

set 那串倾向命令
3dd 倾向于击键

所以 set 用 codeblock 而 3dd 用 key?

这么说也行,等我做完作业改改看看效果。

@NachtgeistW
Copy link
Contributor

啊这个问题……
我当时在做格式化的时候是这么想的:如果要强调「这是键盘上的按键」就使用<kbd>;强调「这是命令」就用 `。
现在这篇文档里这些符号的运用主要体现我当时的想法,可能现在有些地方看上去不太合适了。
如有意见欢迎提出。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants