wip(docs): i18n (#12681)

2026-02-09 11:34:35 -06:00
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions
--- a/packages/web/src/content/docs/zh-cn/formatters.mdx
+++ b/packages/web/src/content/docs/zh-cn/formatters.mdx
@@ -0,0 +1,130 @@
+---
+title: 格式化程序
+description: OpenCode 使用特定于语言的清理程序。
+---
+
+使用在语言的格式化程序编写或编辑文件后，OpenCode会自动格式化文件。这可以确保生成的代码遵循项目的代码风格。
+
+---
+
+## 內建
+
+OpenCode附带了多个适用于流行语言和框架的内置初始化程序。下面是格式化程序、支持的文件扩展名以及所需的命令或配置选项的列表。
+
+|格式化程序|擴展 |要求|
+| -------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+|政府| .go | `gofmt` 命令可用 |
+|混合| .ex、.exs、.eex、.heex、.leex、.neex、.sface | `mix` 命令可用 |
+|更漂亮| .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://prettier.io/docs/en/index.html) | `package.json` | `prettier` 依赖关系
+|生物群系 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://biomejs.dev/) | `biome.json(c)` 配置文件 |
+|之字形 | .zig、.zon | `zig` 命令可用 |
+| clang 格式 | .c、.cpp、.h、.hpp、.ino 和 [更多的](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 |
+|克特林特 | .kt、.kts | `ktlint` 命令可用 |
+|领子 | .py, .pyi | `ruff` 命令可通过配置 |
+|生锈 | .rs | `rustfmt` 命令可用 |
+| 货物运输 | .rs | `cargo fmt` 命令可用 |
+|美丽| .py, .pyi | `uv` 命令可用 |
+|鲁博科普 | .rb、.rake、.gemspec、.ru | `rubocop` 命令可用 |
+|标准rb | .rb、.rake、.gemspec、.ru | `standardrb` 命令可用 |
+| html美化器 | .erb、.html.erb | `htmlbeautifier` 命令可用 |
+|空气| .R | `air` 命令可用 |
+|飞镖 | .dart | `dart` 命令可用 |
+| ocaml 格式 | .ml、.mli | `ocamlformat` 可用命令和 `.ocamlformat` 配置文件 |
+|地形 | .tf、.tfvars | `terraform` 命令可用 |
+|微光| .gleam | `gleam` 命令可用 |
+|尼克斯夫MTT | .nix | `nixfmt` 命令可用 |
+| sfmt| .sh、.bash | `shfmt` 命令可用 |
+|品脱| .php | `composer.json` | `laravel/pint` 依赖关系
+| oxfmt（实验）| .js、.jsx、.ts、.tsx | `package.json` 和[实验环境指标](/docs/cli/#experimental) | `oxfmt` 依赖关系
+| 奥尔莫鲁 | .hs | `ormolu` 命令可用 |
+
+因此，如果您的项目的`package.json`或`prettier`，OpenCode将自动使用它。
+
+---
+
+## 它是如何運作的
+
+当OpenCode写入或编辑文件时，它：
+
+1. 根據所有啟用的格式化程序檢查文件擴展名。
+2. 對文件運行適當的格式化程序命令。
+3. 自動應用格式更改。
+
+此過程在後台進行，確保無需任何手動步驟即可維護您的代碼樣式。
+
+---
+
+## 配置
+
+您可以通过 OpenCode 配置中的 `formatter` 部分自定义程序。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {}
+}
+```
+
+每個格式化程序配置支持以下內容：
+
+|物業 |類型 |描述 |
+| ------------- | -------- | ------------------------------------------------------- |
+| `disabled` | 布尔 | 将其设置为 `true` 以取消删除程序 |
+| `command` |字符串[] | 格式化运行的命令 |
+| `environment` |对象|运行格式化程序时要设置的环境变量 |
+| `extensions` |字符串[] |此整理程序应处理的文件扩展名 |
+
+讓我們看一些例子。
+
+---
+
+### 禁用格式化程序
+
+要全局取消**所有**清理程序，然后`formatter`设置为`false`：
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": false
+}
+```
+
+要取消**特定**删除程序，则`disabled`设置为`true`：
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### 自定義格式化程序
+
+您可以覆蓋內置格式化程序或通過指定命令、環境變量和文件擴展名添加新格式化程序：
+
+```json title="opencode.json" {4-14}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```
+
+命令中的 **`$FILE` 占位符** 将替换为正在格式化的文件的路径。