docs(tools): add pip/errors

Author: Sun-ZhenXing

docs/.vuepress/config.ts

@@ -5,7 +5,6 @@ import { mdEnhancePlugin } from 'vuepress-plugin-md-enhance'
 import { copyCodePlugin } from 'vuepress-plugin-copy-code2'
 import { searchProPlugin } from 'vuepress-plugin-search-pro'
 import { autoCatalogPlugin } from 'vuepress-plugin-auto-catalog'
-// import { shikiPlugin } from '@vuepress/plugin-shiki'
 
 const __dirname = getDirname(import.meta.url)
 const isProd = process.env.NODE_ENV === 'production'
@@ -33,20 +32,12 @@ export default defineUserConfig({
     editLinkText: '在 GitHub 上编辑此页',
     contributorsText: '贡献者',
     lastUpdatedText: '上次更新',
+    openInNewWindow: '在新窗口打开',
+    toggleColorMode: '切换深色模式',
+    toggleSidebar: '切换侧边栏',
     navbar: [
     ],
-    sidebar: {
-      '/pypi-package/pyside6': [
-        '/pypi-package/pyside6/chapter01/',
-        '/pypi-package/pyside6/chapter02/',
-        '/pypi-package/pyside6/chapter03/',
-        '/pypi-package/pyside6/chapter04/',
-        '/pypi-package/pyside6/chapter05/',
-        '/pypi-package/pyside6/chapter06/',
-        '/pypi-package/pyside6/chapter07/',
-        '/pypi-package/pyside6/chapter08/',
-      ]
-    },
+    sidebar: 'auto',
   }),
   plugins: [
     mdEnhancePlugin({
@@ -114,7 +105,6 @@ export default defineUserConfig({
     copyCodePlugin({
       showInMobile: true
     }),
-    // isProd ? shikiPlugin({ theme: 'dark-plus' }) : [],
   ],
   alias: {
     '@': path.resolve(

docs/tools/pip/errors.md

@@ -0,0 +1,23 @@
+# pip 错误合集
+
+[[TOC]]
+
+## 1. 网络问题列表
+
+出现下面任何一种情况：
+- `These Packages Do Not Match The Hashes From The Requirements File.`
+- `THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE`
+
+哈希校验错误，原因可能是使用不安全传输时出现错误，重复尝试或者更换网络环境即可，一般是网络环境过差。
+
+如果正在使用 HTTPS，可能出现下面的情况：
+- `pip decryption failed or bad record mac (_ssl.c:2309)`
+- `ERROR: Could not install packages due to an EnvironmentError: [SSL: DECRYPTION_FAILED_OR_BAD_RECORD_MAC]`
+
+可能是网络受到攻击，或者是网络环境过差，可以尝试更换网络环境或者使用代理。
+
+::: tip 解决
+
+可以在其他环境使用 `pip download` 下载包，然后在当前环境使用 `pip install` 安装。在 Linux 下使用 `md5sum` 或者 `sha256sum` 命令计算哈希值。如果哈希值于服务器提供的不同则是网络传输问题。
+
+:::

package.json

@@ -21,7 +21,6 @@
   "license": "ISC",
   "devDependencies": {
     "@vuepress/client": "2.0.0-beta.61",
-    "@vuepress/plugin-shiki": "2.0.0-beta.61",
     "@vuepress/utils": "2.0.0-beta.61",
     "vue": "^3.2.47",
     "vuepress": "2.0.0-beta.61",