fixing doc

2026-04-10 09:46:13 +00:00 · 2025-06-18 01:59:54 +09:00
parent d8c4d85186
commit 1ea644d0dd
118 changed files with 3108 additions and 9104 deletions
--- a/content/dev/build/faq/_index.es.md
+++ b/content/dev/build/faq/_index.es.md
@@ -3,9 +3,9 @@ title: FAQ para Windows
 weight: 40
 ---

-# vcpkg el paquete de descarga falló
+## vcpkg el paquete de descarga falló

-## Error
+### Error

 ```
 -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b...
@@ -13,15 +13,15 @@ weight: 40
       Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n
 ```

-## Solución
+### Solución

 Usa un navegador para descargar `https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`, luego muévelo a `vcpkg/downloads` y reinstalar.



-# El paquete en Cargo.lock no existe
+## El paquete en Cargo.lock no existe

-## Error
+### Error

 ```
 $ cargo run
@@ -42,34 +42,34 @@ $ cargo run

 Tal vez el autor usó `git force push` y la confirmación anterior se sobrescribió.

-## Solución
+### Solución

 `cargo update`, forzar la actualización del paquete



-# VCPKG_ROOT no establecido
+## VCPKG_ROOT no establecido

-## Error
+### Error

 ```
 thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45
 ```

-## Solución
+### Solución

 Agregar `VCPKG_ROOT` variable de entorno, o ejecutar con `VCPKG_ROOT=<vcpkg_dir> cargo run`



-# clang no instalado, o LIBCLANG_PATH no establecido
+## clang no instalado, o LIBCLANG_PATH no establecido

-## Error
+### Error

 ```
 thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31
 ```

-## Solución
+### Solución

 Instalar [llvm](https://releases.llvm.org/download.html), Añade el `LIBCLANG_PATH` variable de entorno como `llvm_install_dir/bin`
--- a/content/dev/build/faq/_index.fr.md
+++ b/content/dev/build/faq/_index.fr.md
@@ -3,9 +3,9 @@ title: FAQ
 weight: 40
 ---

-# Échec du téléchargement du package vcpkg
+## Échec du téléchargement du package vcpkg

-## Erreur
+### Erreur

 ```
 -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b...
@@ -13,14 +13,14 @@ weight: 40
       Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n
 ```

-## Solution
+### Solution

 Utiliser un navigateur pour télécharger `https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`,  puis déplacez-le dans `vcpkg/downloads` et réinstallez.


-# Le paquet dans Cargo.lock n'existe pas
+## Le paquet dans Cargo.lock n'existe pas

-## Erreur
+### Erreur

 ```
 $ cargo run
@@ -41,31 +41,31 @@ $ cargo run

 Peut-être que l'auteur a utilisé `git force push` et que le commit précédent a été écrasé.

-## Solution
+### Solution

 `cargo update`, forcer la mise à jour du paquet.


-# VCPKG_ROOT non défini
+## VCPKG_ROOT non défini

-## Erreur
+### Erreur

 ```
 thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45
 ```

-## Solution
+### Solution

 Ajoutez la variable d'environnement `VCPKG_ROOT` ou lancer avec la commande `VCPKG_ROOT=<vcpkg_dir> cargo run`

-# clang non installé ou LIBCLANG_PATH non défini
+## clang non installé ou LIBCLANG_PATH non défini

-## Erreur
+### Erreur

 ```
 thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31
 ```

-## Solution
+### Solution

 Installer [llvm](https://releases.llvm.org/download.html), et ajoutez la variable d'environnement `LIBCLANG_PATH` avec la valeur `llvm_install_dir/bin`
--- a/content/dev/build/faq/_index.zh-cn.md
+++ b/content/dev/build/faq/_index.zh-cn.md
@@ -3,20 +3,20 @@ title: Windows 常见问题
 weight: 40
 ---

-# vcpkg下载包失败
-## 错误示例
+## vcpkg下载包失败
+### 错误示例
 ```
 -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b...
   CMake Error at scripts/cmake/vcpkg_execute_required_process.cmake:127 (message):
       Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n
 ```
-## 解决方法
+### 解决方法
 使用浏览器下载`https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`,  然后放到`vcpkg/downloads`下， 重新安装.



-# Cargo.lock里的版本不存在
-## 错误示例
+## Cargo.lock里的版本不存在
+### 错误示例
 ```
 $ cargo run
       Updating git repository `https://github.com/open-trade/confy`
@@ -34,25 +34,25 @@ $ cargo run
     object not found - no match for id (27fa12941291b44ccd856aef4a5452c1eb646047); class=Odb (9); code=NotFound (-3)
 ```
 可能作者使用`git force push`覆盖了之前的commit
-## 解决方法
+### 解决方法
 `cargo update`强制更新包



-# VCPKG_ROOT环境变量未设置
-## 错误示例
+## VCPKG_ROOT环境变量未设置
+### 错误示例
 ```
 thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45
 ```
-## 解决办法
+### 解决办法
 添加VCPKG_ROOT环境变量, 或者使用`VCPKG_ROOT=<vcpkg_dir> cargo run`



-# 未安装clang环境, 或未设置LIBCLANG_PATH环境变量
-## 错误示例
+## 未安装clang环境, 或未设置LIBCLANG_PATH环境变量
+### 错误示例
 ```
 thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31
 ```
-## 解决办法
+### 解决办法
 安装[llvm](https://releases.llvm.org/download.html), 设置`LIBCLANG_PATH`环境变量为`llvm_install_dir/bin`
--- a/content/dev/build/faq/_index.zh-tw.md
+++ b/content/dev/build/faq/_index.zh-tw.md
@@ -3,9 +3,9 @@ title: Windows 常見問題
 weight: 40
 ---

-# vcpkg 下載包失敗
+## vcpkg 下載包失敗

-## 錯誤
+### 錯誤

 ```
 -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b...
@@ -13,15 +13,15 @@ weight: 40
       Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n
 ```

-## 解決方法
+### 解決方法

 使用瀏覽器下載 `https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`，然後放到 `vcpkg/downloads下，重新安裝。



-# Cargo.lock 裡的套件不存在
+## Cargo.lock 裡的套件不存在

-## 錯誤
+### 錯誤

 ```
 $ cargo run
@@ -42,34 +42,34 @@ $ cargo run

 可能作者使用 `git force push` 覆蓋了之前的 commit。

-## 解決方法
+### 解決方法

 使用 `cargo update`，強制更新套件



-# VCPKG_ROOT 環境變數未設置
+## VCPKG_ROOT 環境變數未設置

-## 錯誤
+### 錯誤

 ```
 thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45
 ```

-## 解決辦法
+### 解決辦法

 加入 VCPKG_ROOT 環境變數, 或者使用 `VCPKG_ROOT=<vcpkg_dir> cargo run`



-# 未安裝 clang 環境，或未設置 LIBCLANG_PATH 環境變數
+## 未安裝 clang 環境，或未設置 LIBCLANG_PATH 環境變數

-## 錯誤
+### 錯誤

 ```
 thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31
 ```

-## 解決辦法
+### 解決辦法

 安裝 [llvm](https://releases.llvm.org/download.html)，設置 `LIBCLANG_PATH` 環境變數為 `llvm_install_dir/bin`