wip(docs): i18n (#12681)

1 files changed, 130 insertions, 0 deletions

diff --git a/packages/web/src/content/docs/ja/formatters.mdx b/packages/web/src/content/docs/ja/formatters.mdx
new file mode 100644
index 000000000..46f05ecdb
--- /dev/null
+++ b/packages/web/src/content/docs/ja/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、および [more](https://prettier.io/docs/en/index.html) | `package.json` における `prettier` の依存関係 |
+|バイオーム | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml、および [more](https://biomejs.dev/) | `biome.json(c)` 設定ファイル |
+|ジグ | .zig、.zon | `zig` コマンドが利用可能 |
+|クラン形式 | .c、.cpp、.h、.hpp、.ino、および [more](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 設定ファイル |
+|クトリント | .kt、.kts | `ktlint` コマンドが利用可能 |
+|ラフ | .py、.pyi | `ruff` コマンドは config | で使用可能です。
+|さびと.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` コマンドが利用可能 |
+| ocaml形式 | .ml、.mli |利用可能な `ocamlformat` コマンドと `.ocamlformat` 設定ファイル |
+|テラフォーム | .tf、.tfvars | `terraform` コマンドが利用可能 |
+|輝く.gleam | `gleam` コマンドが利用可能 |
+|ニクスフムト | .nix | `nixfmt` コマンドが利用可能 |
+|シュフムト | .sh、.bash | `shfmt` コマンドが利用可能 |
+|パイント | .php | `composer.json` における `laravel/pint` の依存関係 |
+| oxfmt (実験的) | .js、.jsx、.ts、.tsx | `package.json` の `oxfmt` 依存関係と [実験用環境変数 flag](/docs/cli/#experimental) |
+|オルモル | .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` プレースホルダー** は、フォーマットされるファイルへのパスに置き換えられます。