edit

docs/examples/index.md

@@ -6,97 +6,73 @@ hide:
 
 ## Admonitions
 
-<!-- md:option type:note -->
+!!! note
-
-:   !!! note
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:abstract -->
+!!! abstract
-
-:   !!! abstract
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:info -->
+!!! info
-
-:   !!! info
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:tip -->
+!!! tip
-
-:   !!! tip
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:success -->
+!!! success
-
-:   !!! success
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:question -->
+!!! question
-
-:   !!! question
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:warning -->
+!!! warning
-
-:   !!! warning
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:failure -->
+!!! failure
-
-:   !!! failure
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:danger -->
+!!! danger
-
-:   !!! danger
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:bug -->
+!!! bug
-
-:   !!! bug
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:example -->
+!!! example
-
-:   !!! example
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo
         purus auctor massa, nec semper lorem quam in massa.
 
-<!-- md:option type:quote -->
+!!! quote
-
-:   !!! quote
 
         Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et
         euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo

docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md

@@ -4,7 +4,7 @@
 
 以下是 Grafana 的 docker-compose 配置参考：
 
-``` title="docker-compose.yml"
+``` yaml title="docker-compose.yml"
 services:
   grafana:
     image: grafana/grafana-enterprise

docs/tech/Creating-and-Managing-SSH-Keys-for-Authentication-on-Linux-Servers.md

@@ -1,15 +1,15 @@
 # 创建和管理 Linux 服务器用于身份验证的 SSH 密钥
 
 ## 使用 ssh-keygen 生成密钥
-以下 ssh-keygen 命令默认在 ~/.ssh 目录中生成 4096 位 SSH RSA 公钥和私钥文件。 如果当前位置存在 SSH 密钥对，这些文件将被覆盖。
+以下 `ssh-keygen` 命令默认在 `~/.ssh` 目录中生成 4096 位 SSH RSA 公钥和私钥文件。如果当前位置存在 SSH 密钥对，这些文件将被覆盖。
 
 ``` bash
 ssh-keygen \
     -m PEM \
     -t rsa \
     -b 4096 \
-    -C "azureuser@myserver" \
+    -C "ubuntur@<ip>" \
-    -f ~/.ssh/mykeys/myprivatekey \
+    -f ~/.ssh/myprivatekey \
     -N mypassphrase
 ```
 
@@ -23,14 +23,19 @@ ssh-keygen \
 
 `-b 4096` = 密钥的位数，本例中为 4096
 
-`-C "azureuser@myserver"` = 追加到公钥文件末尾以便于识别的注释。 通常以电子邮件地址用作注释，但也可以使用任何最适合你事物。
+`-C "ubuntu@<ip>"` = 追加到公钥文件末尾以便于识别的注释。 通常以电子邮件地址用作注释，但也可以使用任何最适合你事物。
 
-`-f ~/.ssh/mykeys/myprivatekey` = 私钥文件的文件名（如果选择不使用默认名称）。 追加了 .pub 的相应公钥文件在相同目录中生成。 该目录必须存在。
+`-f ~/.ssh/myprivatekey` = 私钥文件的文件名（如果选择不使用默认名称）。该目录必须存在。
 
 `-N mypassphrase` = 用于访问私钥文件的其他密码。
 
 ## 使用 ssh-agent 来存储私钥密码
-为了避免在每次 SSH 登录时键入私钥文件密码，可以使用 `ssh-agent` 来缓存私钥文件密码。 如果使用 Mac，macOS Keychain 在用户调用 `ssh-agent` 时会安全存储私钥密码。验证并使用 `ssh-agent` 和 `ssh-add` 将密钥文件的情况通知给 SSH 系统，这样就无需交互使用密码。
+
+为了避免在每次 SSH 登录时键入私钥文件密码，可以使用 `ssh-agent` 来缓存私钥文件密码。
+
+如果使用 Mac，macOS Keychain 在用户调用 `ssh-agent` 时会安全存储私钥密码。
+
+验证并使用 `ssh-agent` 和 `ssh-add` 将密钥文件的情况通知给 SSH 系统，这样就无需交互使用密码。
 
 ``` bash
 eval "$(ssh-agent -s)"
@@ -45,10 +50,11 @@ ssh-add ~/.ssh/id_rsa
 私钥密码现在存储在 `ssh-agent` 中。
 
 ## 使用 ssh-copy-id 将密钥复制到现有服务器
+
 如果已有服务器，可以使用 `ssh-copy-id` 将新的 SSH 公钥添加到 Linux 服务器。
 
 ``` bash
-ssh-copy-id -i ~/.ssh/id_rsa.pub azureuser@myserver
+ssh-copy-id -i ~/.ssh/id_rsa.pub ubuntu@<ip>
 ```
 
 ## 创建并配置 SSH 配置文件
@@ -56,33 +62,35 @@ ssh-copy-id -i ~/.ssh/id_rsa.pub azureuser@myserver
 
 以下示例显示一个简单配置，通过此配置，你可以使用默认的 SSH 私钥以用户身份快速登录到特定 VM。
 
-创建文件。
+创建文件：
 
-```Bash
+``` bash
 touch ~/.ssh/config
 ```
 
-编辑文件以添加新的 SSH 配置
+编辑文件以添加新的 SSH 配置：
 
-```Bash
+``` bash
 nano ~/.ssh/config
 ```
 
-添加适用于主机 VM 的配置设置。 在此示例中，VM 名称（主机）为 myvm，帐户名称（用户）为 azureuser，IP 地址或 FQDN（主机名）为 192.168.0.255。
+添加适用于主机 VM 的配置设置。 在此示例中，VM 名称（主机）为 myvm，帐户名称（用户）为 ubuntu，IP 地址或 FQDN（主机名）为 192.168.0.255。
 
-```Bash
+``` linuxconfig
-# Azure Keys
 Host myvm
-  Hostname 192.168.0.255
+HostName 192.168.0.255
-  User azureuser
+Port 22
-# ./Azure Keys
+User ubuntu
+IdentityFile ~/.ssh/<file name> # (1)
 ```
 
+1.  此处填写密钥文件的绝对路径
+
 可为其他主机添加配置，让每台主机使用其自己的专用密钥对。 查看 SSH 配置文件获取更多高级配置选项。
 
-获得 SSH 密钥对和配置的 SSH 配置文件后，便可快速安全地远程访问 Linux VM。 运行以下命令时，SSH 从 SSH 配置文件的 Host myvm 块中找到所有设置并加载它们。
+获得 SSH 密钥对和配置的 SSH 配置文件后，便可快速安全地远程访问 Linux VM。 运行以下命令时，SSH 从 SSH 配置文件的 Host `myvm` 块中找到所有设置并加载它们。
 
-```Bash
+``` bash
 ssh myvm
 ```
 

docs/tech/Docker-Compose-Limiting-container-resource-usage.md

@@ -4,7 +4,7 @@
 
 限制资源配置字段为 `deploy.resources.limits`，以下是示例 docker-compose.yml
 
-``` title="docker-compose.yml"
+``` yaml title="docker-compose.yml"
 version: '3'
 services:
   umami:

docs/tech/Git-overwriting-local-changes.md

@@ -17,8 +17,9 @@ git reset --hard <remote>/<branch_name>
 git fetch --all
 git reset --hard origin/main
 ```
+!!! info
 
-> 不论是否使用 --hard 选项，所有尚未推送的本地提交都将丢失。
+    不论是否使用 --hard 选项，所有尚未推送的本地提交都将丢失。
 
 ## 命令详解
 

docs/tech/HC5661.md

@@ -21,9 +21,11 @@
 - hanwckf: `0HC5661_3.4.3.9-099.trx`
 - chongshengB: `T1HC5661_3.4.3.9-099.trx`
 
-> Default gateway: 192.168.1.1
+!!! info
-> Username: admin
+
-> Password: admin
+    默认管理地址: 192.168.1.1
+    用户名: admin
+    密码: admin
 
 [下载](https://www.right.com.cn/forum/thread-8250681-1-1.html)
 

docs/tech/Install-Material-for-MkDocs.md

@@ -9,16 +9,14 @@
 ``` bash
 sudo apt -y install python3 python3-full python3-pip python3.12-venv
 
-python3 -m venv <path>
+python3 -m venv <path> # (1)
     
 <path>/pip install --upgrade pip setuptools
 
 <path>/pip install mkdocs-material
 ```
 
-!!! warning "注意"
+1.  本文所有命令中的 `<path>` 请替换为 MkDocs 安装目录的绝对路径。
-
-    以上命令中的 `<path>` 请替换为 MkDocs 安装目录的绝对路径。
 
 这将自动安装所有依赖项的兼容版本： MkDocs、Markdown、Pygments 和 Python Markdown 扩展。
 

docs/tech/Mi6(sagit).md

@@ -6,8 +6,8 @@
 
 ## 准备
 
-- Android 调试桥 (adb): [Download](https://developer.android.com/studio/releases/platform-tools?hl=zh-cn)
+- Android 调试桥 (adb): [下载](https://developer.android.com/studio/releases/platform-tools?hl=zh-cn)
-- Google USB Driver: [Download](https://developer.android.com/studio/run/win-usb)
+- Google USB Driver: [下载](https://developer.android.com/studio/run/win-usb)
 - USB 2.0 接口
 
 !!! tip
@@ -61,7 +61,7 @@
 
 !!! info
 
-    adb 驱动安装基本与本教程相同，最后选择 `Android Composite ADB Interface` 即可
+    adb 驱动安装基本与以上流程相同，最后选择 `Android Composite ADB Interface` 即可
 
 ## 刷入官方固件/救砖 - Fastboot 线刷
 
@@ -80,7 +80,7 @@
 ## 刷入第三方 Recovery
 
 - 进入 Fastboot: 音量减 + 电源
-- [Download](https://down.warbler.cc/XiaoMi-6/Recovery/Twrp/12)
+- [下载第三方 Recovery](https://down.warbler.cc/XiaoMi-6/Recovery/Twrp/12)
 - 在 adb 所在目录启动 Terminal
 - 执行
 
@@ -93,7 +93,7 @@
 ## 刷入第三方 ROM: LineageOS 21
 
 - 进入 Recovery: 音量加 + 电源
-- 清除以下内容
+- 清除以下内容：
 
     * Dalvik / ART 缓存
     * Cache

docs/tech/Redmi4X(santoni).md

@@ -26,20 +26,21 @@
 ## 刷入第三方 Recovery
 
 - 进入 Fastboot: 音量减 + 电源
-- [Download](https://sourceforge.net/projects/jabiyeff-build/files/Recovery/)
+- [下载第三方 Recovery](https://sourceforge.net/projects/jabiyeff-build/files/Recovery/)，推荐 `OrangeFox-R11.1_5-santoni-27.02.22`
-推荐 `OrangeFox-R11.1_5-santoni-27.02.22`
 - 解压
 - 在 adb 所在目录启动 Terminal
-- 执行
+- 执行：
+
   ``` powershell
   .\fastboot flash recovery <real path>\OrangeFox-R11.1_5-santoni-27.02.22\recovery.img
   ```
+
 - 进入 Recovery:音量加 + 电源
 
 ## 刷入第三方 ROM: VoltageOS 13
 
 - 进入 Recovery: 音量加 + 电源
-- 清除以下内容
+- 清除以下内容：
 
     * Dalvik / ART 缓存
     * Cache
@@ -47,7 +48,7 @@
     * Vendor
     * Data {==注意：记得格式化 Data 分区==}
 
-- 刷入最新官方修补固件 (主要更新 BootLoader) [Download (注意选择国行)](https://xiaomifirmwareupdater.com/archive/firmware/santoni/)
+- 刷入最新官方修补固件 (主要更新 BootLoader): [下载 (注意选择国行)](https://xiaomifirmwareupdater.com/archive/firmware/santoni/)
 - 刷入 VoltageOS +  {==Gapps (本地备份)==}
 - 清除 Dalvik / ART 缓存, Cache & Data {==注意：记得格式化 Data 分区==}
 - 重启