edit

2024-07-26 02:07:14 +08:00 · 2024-07-26 02:07:14 +08:00 · cb5848a3f8
commit cb5848a3f8
parent 5d8eafda23
10 changed files with 101 additions and 115 deletions
--- a/docs/examples/index.md
+++ b/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
--- a/docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md
+++ b/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
--- a/docs/tech/Creating-and-Managing-SSH-Keys-for-Authentication-on-Linux-Servers.md
+++ b/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" \
-    -f ~/.ssh/mykeys/myprivatekey \
+    -C "ubuntur@<ip>" \
+    -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
-# Azure Keys
+``` linuxconfig
 Host myvm
-  Hostname 192.168.0.255
-  User azureuser
-# ./Azure Keys
+HostName 192.168.0.255
+Port 22
+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
 ```

--- a/docs/tech/Docker-Compose-Limiting-container-resource-usage.md
+++ b/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:
--- a/docs/tech/Git-overwriting-local-changes.md
+++ b/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 选项，所有尚未推送的本地提交都将丢失。

 ## 命令详解

--- a/docs/tech/HC5661.md
+++ b/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
-> Username: admin
-> Password: admin
+!!! info
+
+    默认管理地址: 192.168.1.1
+    用户名: admin
+    密码: admin

 [下载](https://www.right.com.cn/forum/thread-8250681-1-1.html)

--- a/docs/tech/Install-Material-for-MkDocs.md
+++ b/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 "注意"
-
-    以上命令中的 `<path>` 请替换为 MkDocs 安装目录的绝对路径。
+1.  本文所有命令中的 `<path>` 请替换为 MkDocs 安装目录的绝对路径。

 这将自动安装所有依赖项的兼容版本： MkDocs、Markdown、Pygments 和 Python Markdown 扩展。

--- a/docs/tech/Mi6(sagit).md
+++ b/docs/tech/Mi6(sagit).md
@ -6,8 +6,8 @@

 ## 准备

- Android 调试桥 (adb): [Download](https://developer.android.com/studio/releases/platform-tools?hl=zh-cn)
- Google USB Driver: [Download](https://developer.android.com/studio/run/win-usb)
+- Android 调试桥 (adb): [下载](https://developer.android.com/studio/releases/platform-tools?hl=zh-cn)
+- 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
--- a/docs/tech/Redmi4X(santoni).md
+++ b/docs/tech/Redmi4X(santoni).md
@ -26,20 +26,21 @@
 ## 刷入第三方 Recovery

 - 进入 Fastboot: 音量减 + 电源
- [Download](https://sourceforge.net/projects/jabiyeff-build/files/Recovery/)
-推荐 `OrangeFox-R11.1_5-santoni-27.02.22`
+- [下载第三方 Recovery](https://sourceforge.net/projects/jabiyeff-build/files/Recovery/)，推荐 `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 分区==}
 - 重启