style: single KBD

add_your_program/main.rst

@@ -69,7 +69,7 @@ src/example_single/main.cpp 中有一个 :cpp:`int main()` 函数, 它就是该
 :cpp:`add(5, 3)`
   :cpp:`add(5, 3)` 函数来自于 :cpp:`"add.hpp"`, 我们通过 :cpp:`#include "add.hpp"` 来包含它.
 
-  通过 :KBD:`Ctrl` + :KBD:`鼠标左键` 或 :KBD:`Command⌘` + :KBD:`鼠标左键` :cpp:`#include "add.hpp"` 的文件名 :cpp:`"add.hpp"` 部分, 你可以跳转到对应的文件. 可见, 我们跳转到了 include/add.hpp, 这是我配置的公共头文件存放处, 放在此处的头文件将能被任意位置的源文件直接 :cpp:`#include`.
+  通过 :KBD:`Ctrl-鼠标左键` 或 :KBD:`Command⌘-鼠标左键` :cpp:`#include "add.hpp"` 的文件名 :cpp:`"add.hpp"` 部分, 你可以跳转到对应的文件. 可见, 我们跳转到了 include/add.hpp, 这是我配置的公共头文件存放处, 放在此处的头文件将能被任意位置的源文件直接 :cpp:`#include`.
 
 :cpp:`#include "add.hpp"`
   该文件是头文件 (header file), 相比于源文件 (source file), 它旨在以 :cpp:`#include` 形式被包含到源文件中而被使用, 因此:

appendix/about_inlay_hints/main.rst

@@ -11,11 +11,11 @@
 **但这有时提示地过多而影响阅读.** 为此, 你可以:
 
 关闭这些额外信息的显示
-  打开 test 文件夹下的 main.cpp, :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``inlay hints`` 以找到 :menuselection:`clangd: Toggle inlay hints`, :KBD:`回车`.
+  打开 test 文件夹下的 main.cpp, :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``inlay hints`` 以找到 :menuselection:`clangd: Toggle inlay hints`, :KBD:`回车`.
 
   重复此操作可以开启显示.
 
 选择性启用额外信息显示
   打开学习模板下的 .clangd 文件, 按需求开关 ``InlayHints`` 下的选项.
 
-  然后打开 test 文件夹下的 main.cpp, 通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 从而刷新配置.
+  然后打开 test 文件夹下的 main.cpp, 通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 从而刷新配置.

appendix/about_warnings/main.rst

@@ -16,13 +16,13 @@
 
   .. tab:: 问题面板
 
-    如果没有显示出面板, 你可以通过 :KBD:`Ctrl` + :KBD:`J` 或 :KBD:`Command⌘` + :KBD:`J` 打开.
+    如果没有显示出面板, 你可以通过 :KBD:`Ctrl-J` 或 :KBD:`Command⌘-J` 打开.
 
     .. figure:: 问题面板.png
 
   .. tab:: 鼠标悬停
 
-    你也可以用快捷键打开光标位置的悬停提示 (editor.action.showHover), 但这默认快捷键很复杂, 建议查询并修改快捷键.
+    你也可以用 :KBD:`Ctrl-K Ctrl-I` 或 :KBD:`Command⌘-K Command⌘-I` 打开光标位置的悬停提示 (editor.action.showHover), 但这默认快捷键很复杂, 建议查询并修改快捷键.
 
     .. figure:: 鼠标悬停.png
 
@@ -73,7 +73,7 @@ clang-tidy 产生的警告
 
 在代码或错误信息中选择它, 将会弹出 **蓝色** 小灯泡样式 (黄色小灯泡为 clangd 提供的代码重构功能), 点击它即可进行修复.
 
-你也可以选中后按快捷键 :KBD:`Ctrl` + :KBD:`句号` 或 :KBD:`Command⌘` + :KBD:`句号` 进行, 需要按 :KBD:`两次`.
+你也可以选中后按快捷键 :KBD:`Ctrl-句号` 或 :KBD:`Command⌘-句号` 进行, 需要按 :KBD:`两次`.
 
 .. figure:: 可修复的变量未初始化警告.png
 
@@ -83,7 +83,7 @@ clang-tidy 产生的警告
 一键修复整个源文件中的警告
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-打开要修复的源文件, :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``task`` 找到 :menuselection:`任务: 运行任务(Tasks: Run Task)`, :KBD:`回车`, 在出现的界面中选择我配置的 :menuselection:`Clang-Tidy: fix current file`, :KBD:`回车`.
+打开要修复的源文件, :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``task`` 找到 :menuselection:`任务: 运行任务(Tasks: Run Task)`, :KBD:`回车`, 在出现的界面中选择我配置的 :menuselection:`Clang-Tidy: fix current file`, :KBD:`回车`.
 
 这么做运行时间可能比较长, 但相比于按键修复, **它甚至能自动添加头文件包含保护**.
 

appendix/choose_compiler/main.rst

@@ -24,7 +24,7 @@
 
 .. note::
 
-  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看：切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
+  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看：切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
 
 .. figure:: VSCode_打开设置.gif
 

appendix/explain.rst

@@ -67,7 +67,7 @@ clangd 的配置文件. clangd 让 VSCode 能够解析 C++ 代码, 并为程序
 
 clangd 为 VSCode 提供了 clang-tidy 支持, 将会在编写代码时实时调用 clang-tidy 进行静态检查. (但不支持某些 clang-tidy 功能如自动添加, 如果需要, 请通过 :ref:`Clang-Tidy: fix current file <tasks_json>` 对当前源文件使用 clang-tidy.)
 
-clangd 也为 VSCode 提供了 clang-format 支持, 因而在通过 :KBD:`Ctrl` + :KBD:`S` 或 :KBD:`Command⌘` + :KBD:`S` 或工具栏手动保存代码时, 代码将会被格式化.
+clangd 也为 VSCode 提供了 clang-format 支持, 因而在通过 :KBD:`Ctrl-S` 或 :KBD:`Command⌘-S` 或工具栏手动保存代码时, 代码将会被格式化.
 
 - 文档见 `Clang-Tidy 诊断选项列表`_ 和 `Clangd 官网`_.
 
@@ -102,7 +102,7 @@ CMake 的项目配置文件, 整个项目所有程序都由它管理:
 
 为了加快 clangd 的解析速度, 我在 .clangd 配置文件中为 clangd 启用了后台缓存, 而这些缓存存放在 .cache 文件夹中.
 
-在有些情况下 (软件更新、源文件大幅变动……), 你可能需要删除该文件夹并重启 clangd (:KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 回车).
+在有些情况下 (软件更新、源文件大幅变动……), 你可能需要删除该文件夹并重启 clangd (:KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 回车).
 
 ========================================================================================================================
 cmake/

appendix/windows_chinese_issue/main.rst

@@ -44,7 +44,7 @@ Windows 终端输出中文乱码问题
 
 .. note::
 
-  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看: 切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
+  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看: 切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
 
 .. figure:: VSCode_打开设置.gif
 

command_line_hint_others.irst

@@ -8,11 +8,11 @@
   粘贴命令到终端中
     在窗口内 :KBD:`右键` 然后选择 :menuselection:`粘贴 (Paste)`.
 
-    请勿使用 :KBD:`Control` + :KBD:`V` 进行粘贴! 如果习惯性按了, 请狂按几次 :KBD:`删除键`.
+    请勿使用 :KBD:`Control-V` 进行粘贴! 如果习惯性按了, 请狂按几次 :KBD:`删除键`.
 
   执行命令
     通过在窗口内 :KBD:`回车` 执行命令, 当终端再次出现 **打开终端时的窗口样式** 时, 命令执行完毕.
 
     如果命令停住不继续执行, 可能是因为这个命令需要你进行再次确认; 对于本教程而言, **狂敲几次** :KBD:`回车` 即可.
 
-    如果实在卡住太长时间, 你可以 :KBD:`Ctrl` + :KBD:`C` 终止执行, 然后重新输入并执行命令.
+    如果实在卡住太长时间, 你可以 :KBD:`Ctrl-C` 终止执行, 然后重新输入并执行命令.

command_line_hint_wsl.irst

@@ -8,11 +8,11 @@
   粘贴命令到终端中
     在窗口内 :KBD:`右键`.
 
-    请勿使用 :KBD:`Control` + :KBD:`V` 进行粘贴! 如果习惯性按了, 请狂按几次 :KBD:`删除键`.
+    请勿使用 :KBD:`Control-V` 进行粘贴! 如果习惯性按了, 请狂按几次 :KBD:`删除键`.
 
   执行命令
     通过在窗口内 :KBD:`回车` 执行命令, 当终端再次出现 **打开终端时的窗口样式** 时, 命令执行完毕.
 
     如果命令停住不继续执行, 可能是因为这个命令需要你进行再次确认; 对于本教程而言, **狂敲几次** :KBD:`回车` 即可.
 
-    如果实在卡住太长时间, 你可以 :KBD:`Ctrl` + :KBD:`C` 终止执行, 然后重新输入并执行命令.
+    如果实在卡住太长时间, 你可以 :KBD:`Ctrl-C` 终止执行, 然后重新输入并执行命令.

configure/main.rst

@@ -37,7 +37,7 @@
 
 .. note::
 
-  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看：切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
+  如果窗口左下角没有齿轮, 请尝试通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``toggle activity bar`` 以找到 :menuselection:`查看：切换活动栏可见性(View: Toggle Activity Bar Visibility)`, :KBD:`回车`.
 
 在弹出的窗口中, 点击蓝色按钮右边的下三角下拉按钮, 选择 :menuselection:`导入配置文件...(Import Profile...)`.
 
@@ -97,7 +97,7 @@ WSL 专属步骤: 用 WSL 打开该文件夹
 
   VSCode 远程窗口 (例如 WSL) 专属步骤, 其他配置方案请忽略这一部分 **往下接着看**.
 
-:KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``wsl open`` 以找到 :menuselection:`WSL: 在 WSL 中打开文件夹...`, :KBD:`回车`, 并选择该 cpp_novice 文件夹.
+:KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``wsl open`` 以找到 :menuselection:`WSL: 在 WSL 中打开文件夹...`, :KBD:`回车`, 并选择该 cpp_novice 文件夹.
 
 .. figure:: WSL_打开文件夹.png
 
@@ -137,13 +137,13 @@ WSL 专属步骤: 用 WSL 打开该文件夹
   如果没有弹出, 请
 
   扫描工具包
-    :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``cmake kit`` 以找到 :menuselection:`CMake: 扫描工具包`, :KBD:`回车`.
+    :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``cmake kit`` 以找到 :menuselection:`CMake: 扫描工具包`, :KBD:`回车`.
 
   选择工具包
-    :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``cmake kit`` 以找到 :menuselection:`CMake: 选择工具包`, :KBD:`回车`.
+    :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``cmake kit`` 以找到 :menuselection:`CMake: 选择工具包`, :KBD:`回车`.
 
   配置 CMake
-    :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``cmake configure`` 以找到 :menuselection:`CMake: 配置`, :KBD:`回车`.
+    :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``cmake configure`` 以找到 :menuselection:`CMake: 配置`, :KBD:`回车`.
 
 .. note::
 
@@ -168,7 +168,7 @@ WSL 专属步骤: 用 WSL 打开该文件夹
 配置完成
 ========================================================================================================================
 
-打开 test 文件夹下的 main.cpp, 通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 从而刷新配置.
+打开 test 文件夹下的 main.cpp, 通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``clangdr`` 以找到 :menuselection:`clangd: Restart language server`, 从而刷新配置.
 
 .. note::
 

download_and_install_macos/font/main.rst

@@ -18,7 +18,7 @@
   如果文件压缩为 **.zip / .7z / .rar** 文件, 请 :KBD:`双击` 以提取文件. 这是系统内置的解压缩方法, 如果有其他压缩软件请随意.
 
 安装
- :KBD:`Command⌘` + :KBD:`空格` 打开聚焦搜索, 搜索 **字体册** 并打开. 将 **.ttf** 或 **.ttc** 文件拖动到字体册窗口中.
+ :KBD:`Command⌘-空格` 打开聚焦搜索, 搜索 **字体册** 并打开. 将 **.ttf** 或 **.ttc** 文件拖动到字体册窗口中.
 
 ------------------------------------------------------------------------------------------------------------------------
 可选方法

download_and_install_macos/homebrew/main.rst

@@ -10,7 +10,7 @@
 打开终端
 ========================================================================================================================
 
-:KBD:`Command⌘` + :KBD:`空格` 打开聚焦搜索, 搜索 **终端** 并打开.
+:KBD:`Command⌘-空格` 打开聚焦搜索, 搜索 **终端** 并打开.
 
 .. note::
 

download_and_install_macos/other_softwares.rst

@@ -20,6 +20,6 @@
 
   echo "export PATH=\"$(brew --prefix llvm)/bin:\$PATH\"" >> ~/.zshrc
 
-安装完成后, 你可以通过 :menuselection:`启动台` 点击图标启动 VSCode, 或按 :KBD:`Command⌘` + :KBD:`空格` 打开聚焦搜索, 搜索 ``code`` 以找到.
+安装完成后, 你可以通过 :menuselection:`启动台` 点击图标启动 VSCode, 或按 :KBD:`Command⌘-空格` 打开聚焦搜索, 搜索 ``code`` 以找到.
 
 此后, 你可以随时在 :menuselection:`终端` 输入 ``brew upgrade --greedy`` 更新这些软件.

download_and_install_windows/msys2/environment/main.rst

@@ -50,7 +50,7 @@
 验证环境变量
 ========================================================================================================================
 
-请通过 :KBD:`Win⊞` + :KBD:`R` 打开 :menuselection:`运行` 窗口, 输入 ``cmd`` 并 :KBD:`回车`. 在弹出的窗口中输入以下命令并 :KBD:`回车`:
+请通过 :KBD:`Win⊞-R` 打开 :menuselection:`运行` 窗口, 输入 ``cmd`` 并 :KBD:`回车`. 在弹出的窗口中输入以下命令并 :KBD:`回车`:
 
 .. code-block:: bash
 

download_and_install_windows/wsl/linuxbrew/main.rst

@@ -6,7 +6,7 @@
 打开 WSL 终端
 ========================================================================================================================
 
-安装完成后, 会自动弹出一个 WSL 终端. 你也可以通过 :KBD:`Win⊞` + :KBD:`R` 打开 **运行**, 填入 ``ubuntu`` 并 :KBD:`回车` 来启动终端.
+安装完成后, 会自动弹出一个 WSL 终端. 你也可以通过 :KBD:`Win⊞-R` 打开 **运行**, 填入 ``ubuntu`` 并 :KBD:`回车` 来启动终端.
 
 .. note::
 

download_and_install_windows/wsl/wsl/main.rst

@@ -6,7 +6,7 @@
 以管理员身份打开 PowerShell
 ========================================================================================================================
 
-按 :KBD:`Win⊞` + :KBD:`X`, 然后选择 :menuselection:`Windows PowerShell (管理员)(A)` 从而以管理员身份打开 PowerShell.
+按 :KBD:`Win⊞-X`, 然后选择 :menuselection:`Windows PowerShell (管理员)(A)` 从而以管理员身份打开 PowerShell.
 
 .. figure:: 以管理员身份打开 PowerShell.png
 

how_to_update.rst

@@ -35,7 +35,7 @@ Windows (WSL)
 MacOS
 ------------------------------------------------------------------------------------------------------------------------
 
-1. :KBD:`Command⌘` + :KBD:`空格` 打开聚焦搜索, 搜索 **终端** 并打开.
+1. :KBD:`Command⌘-空格` 打开聚焦搜索, 搜索 **终端** 并打开.
 2. 在 :menuselection:`终端` 输入 ``brew upgrade --greedy`` 并 **耐心等待**; 由于配置了中科大镜像源, 无需科学工具即可更新.
 
 ------------------------------------------------------------------------------------------------------------------------

preface/main.rst

@@ -38,7 +38,7 @@ clangd 提供了自动添加头文件功能: clangd 常常在我们编写代码
 自动格式化
 ------------------------------------------------------------------------------------------------------------------------
 
-clangd 为 VSCode 提供了 clang-format 支持, 因而在通过 :KBD:`Ctrl` + :KBD:`S` 或 :KBD:`Command⌘` + :KBD:`S` 或工具栏手动保存代码时, 代码将会被格式化.
+clangd 为 VSCode 提供了 clang-format 支持, 因而在通过 :KBD:`Ctrl-S` 或 :KBD:`Command⌘-S` 或工具栏手动保存代码时, 代码将会被格式化.
 
 .. figure:: 自动格式化.gif
 
@@ -130,9 +130,9 @@ clangd 允许 VSCode 的大纲获知当前源文件的代码结构, 此外还提
 
 变量会被声明和使用, 函数会被声明和调用…… clangd 支持在文件间或文件内查找符号被用在了其他哪些地方:
 
-- 通过 :KBD:`Ctrl` + :KBD:`鼠标左击` 或 :KBD:`Command⌘` + :KBD:`鼠标左击`, 我们将能在鼠标点击的符号和它的定义之间跳转.
+- 通过 :KBD:`Ctrl-鼠标左击` 或 :KBD:`Command⌘-鼠标左击`, 我们将能在鼠标点击的符号和它的定义之间跳转.
 - 通过 :KBD:`F12`, 我们将能在光标所在的符号和它的定义之间跳转.
-- 通过 :KBD:`Shift` + :KBD:`F12`, 我们将能在代码区域中打开一个小窗口, 临时地查看光标所在的符号的所有被使用地点.
+- 通过 :KBD:`Shift-F12`, 我们将能在代码区域中打开一个小窗口, 临时地查看光标所在的符号的所有被使用地点.
 - ……
 
 .. hint::

verify/diagnostics/main.rst

@@ -11,7 +11,7 @@
 
   诊断信息
 
-此外, 代码高亮软件 clangd 还提供了一些内嵌提示, 你可以通过 :KBD:`Ctrl` + :KBD:`Shift` + :KBD:`P` 或 :KBD:`Command⌘` + :KBD:`Shift` + :KBD:`P` 打开命令菜单, 输入 ``inlay`` 以找到 :menuselection:`clangd: Toggle inlay hints`, :KBD:`回车` 来开启或关闭:
+此外, 代码高亮软件 clangd 还提供了一些内嵌提示, 你可以通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``inlay`` 以找到 :menuselection:`clangd: Toggle inlay hints`, :KBD:`回车` 来开启或关闭:
 
 .. tabs::
 

verify/format/main.rst

@@ -10,7 +10,7 @@
 
 **这太丑了!**
 
-让我们点击代码, 按 :KBD:`Ctrl` + :KBD:`S` 或 :KBD:`Command⌘` + :KBD:`S` 手动保存代码. 由于我配置了保存时自动格式化, 此后代码就会被格式化为以下格式:
+让我们点击代码, 按 :KBD:`Ctrl-S` 或 :KBD:`Command⌘-S` 手动保存代码. 由于我配置了保存时自动格式化, 此后代码就会被格式化为以下格式:
 
 .. figure:: 格式化后.png