feat: 提供访问 github 的方法建议

FeignClaims · Oct 31, 2024 · 178d23c · 178d23c
1 parent 4d0ab70
commit 178d23c
Show file tree

Hide file tree

Showing 6 changed files with 15 additions and 8 deletions.
diff --git a/_static/links.rst b/_static/links.rst
@@ -33,6 +33,7 @@
 .. _`Conan 2.0 Documentation`: https://docs.conan.io/2/
 .. _`Adding Packages to ConanCenter`: https://github.com/conan-io/conan-center-index/blob/master/docs/adding_packages/README.md
 .. _`Browse public vcpkg packages`: https://vcpkg.io/en/packages
+.. _`《如何修改Windows系统中文账号名为英文，解决游戏报错问题》by 游戏圣地`: https://www.bilibili.com/video/BV1w24y1t7WY
 
 .. 参考文献
 .. _`VSCode 变量参考`: https://code.visualstudio.com/docs/editor/variables-reference

diff --git a/configure/main.rst b/configure/main.rst
@@ -31,7 +31,7 @@
 
 .. note::
 
-  2024-09 更新的 VSCode 1.93 更改了配置文件界面, 如果你使用的是老版本, 请点击窗口左下角的 :menuselection:`齿轮`, 点击 :menuselection:`配置文件(Profiles)` 来更新你的 VSCode.
+  2024-09 更新的 VSCode 1.93 更改了配置文件界面. 如果你使用的是老版本, 请点击窗口左下角的 :menuselection:`齿轮`, 点击 :menuselection:`配置文件(Profiles)` 来更新你的 VSCode.
 
 点击窗口左下角的 :menuselection:`齿轮`, 点击 :menuselection:`配置文件(Profiles)`.
 
@@ -77,13 +77,15 @@
 
 .. note::
 
-  如果 CodeLLDB 下载失败, 请点击按钮手动下载, 然后通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``vsix`` 以找到 :menuselection:`扩展: 从 VSIX 安装...`, :KBD:`回车`, 在弹出的窗口中选择刚刚点击按钮下载到的文件.
+  CodeLLDB 所需的包需要通过 github 下载, 因此很容易下载失败. 如果 CodeLLDB 下载失败, 请查询如何成功访问 github (例如 "steam++工具箱" 中可以选择加速 github 访问) 然后重启 VSCode.
+
+  或者如果你觉得自己网络没有问题, 你可以尝试点击按钮手动下载, 然后通过 :KBD:`Ctrl-Shift-P` 或 :KBD:`Command⌘-Shift-P` 打开命令菜单, 输入 ``vsix`` 以找到 :menuselection:`扩展: 从 VSIX 安装...`, :KBD:`回车`, 在弹出的窗口中选择刚刚点击按钮下载到的文件.
 
   .. figure:: VSCode_CodeLLDB下载package失败.png
 
       CodeLLDB 下载所需的包失败
 
-.. warning::
+.. error::
 
   切换配置文件后, 右下角可能弹出如下通知, 询问你是否安装 clangd (Would you like to download and install clangd x.x.x?), **请不要安装!** 我们已经通过其他方式安装好了 clangd, 而 VSCode 提示的版本存在一定的问题, 会导致之后步骤中配置失败.
 

diff --git a/learning_template.irst b/learning_template.irst
@@ -9,8 +9,12 @@
 - Windows: :KBD:`右键` 该文件, 然后选择 :menuselection:`提取` 以提取文件.
 - MacOS: :KBD:`双击` 该文件以提取文件.
 
-.. note::
+.. warning::
 
   - 这里写的都是系统内置的解压缩方法, 如果有其他压缩软件请随意.
   - 解压在全英路径, 且文件夹名不要有奇怪的标点符号乃至空格!
-  - 不要图省事解压到桌面, 以免因用户名过于奇怪而出错! —— **来自提问者的真实经历!**
+  - 不要图省事解压到桌面, 以免因用户名有中文或过于奇怪而出错!
+
+.. error::
+
+  请改掉用户名中的中文!!! 参考 `《如何修改Windows系统中文账号名为英文，解决游戏报错问题》by 游戏圣地`_
diff --git a/ohmyzsh/main.rst b/ohmyzsh/main.rst
@@ -4,7 +4,7 @@
 
 .. warning::
 
-  请确保网络可访问 github.
+  请确保网络可访问 github (例如 "steam++工具箱" 中可以选择加速 github 访问).
 
 .. figure:: 美化后的终端.png
 

diff --git a/third_party/conan/main.rst b/third_party/conan/main.rst
@@ -4,7 +4,7 @@
 
 .. warning::
 
-  请确保网络可访问 github.
+  请确保网络可访问 github (例如 "steam++工具箱" 中可以选择加速 github 访问).
 
 .. hint::
 

diff --git a/third_party/vcpkg/main.rst b/third_party/vcpkg/main.rst
@@ -4,7 +4,7 @@
 
 .. warning::
 
-  请确保网络可访问 github.
+  请确保网络可访问 github (例如 "steam++工具箱" 中可以选择加速 github 访问).
 
 .. hint::