From 3556aa75721b2eaccf811f5bb2afe279a164525f Mon Sep 17 00:00:00 2001 From: uabyss <47887646+u-abyss@users.noreply.github.com> Date: Thu, 30 Nov 2023 00:48:24 +0900 Subject: [PATCH] docs(ja): translate big-projects into Japanese (#962) --- .../src/content/docs/guides/big-projects.mdx | 2 +- .../content/docs/ja/guides/big-projects.mdx | 93 +++++++++++++++++++ 2 files changed, 94 insertions(+), 1 deletion(-) create mode 100644 website/src/content/docs/ja/guides/big-projects.mdx diff --git a/website/src/content/docs/guides/big-projects.mdx b/website/src/content/docs/guides/big-projects.mdx index af47bddf3152..4452d5565904 100644 --- a/website/src/content/docs/guides/big-projects.mdx +++ b/website/src/content/docs/guides/big-projects.mdx @@ -40,7 +40,7 @@ It's possible to use the [`extends`](/reference/configuration#extends) configura Let's assume that we have these requirements: - `legacy-app` have to format using spaces; -- `backend` and `new-pp` have to format using tabs; +- `backend` and `new-app` have to format using tabs; - all apps have to format using line width 120; - `backend` app needs some extra linting; diff --git a/website/src/content/docs/ja/guides/big-projects.mdx b/website/src/content/docs/ja/guides/big-projects.mdx new file mode 100644 index 000000000000..693b4341c226 --- /dev/null +++ b/website/src/content/docs/ja/guides/big-projects.mdx @@ -0,0 +1,93 @@ +--- +title: 大きなプロジェクトでのBiomeの使用方法 +description: 大きなプロジェクトでBiomeを使用するための簡単なガイド +--- + +Biomeは、モノレポや複数のプロジェクトを含むワークスペースなどの大きなプロジェクトで、適切に使用するためのツールを提供しています。 + +## 複数の設定ファイルの使用 + +Biomeの機能をCLIやLSPで使用する場合、ツールは現在の作業ディレクトリから最も近い設定ファイルを参照します。 + +設定ファイルが見つからない場合、Biomeは設定ファイルが見つかるまで、**上へ上へ**とディレクトリを移動します。 + +この機能を活用して、プロジェクトやディレクトリごとに異なるオプションを適用することができます。 + +例えば、backendディレクトリとfrontendディレクトリを含むプロジェクトがあるとします。 + + +``` +app +├── backend +│ ├── biome.json +│ └── package.json +└── frontend + ├── biome.json + ├── legacy-app + │ └── package.json + └── new-app + └── package.json +``` + +この場合、`app/backend/package.json`からスクリプトを実行すると、Biomeは`app/backend/biome.json`を設定ファイルとして使用します。 + +`app/frontend/legacy-app/package.json`または`app/frontend/new-app/package.json`からスクリプトを実行すると、Biomeは`app/frontend/biome.json`を設定ファイルとして使用します。 + +## 設定の共有 + +[`extends`](/reference/configuration#extends)オプションを使用して、オプションを複数ファイルに分割することができる。 + +例えば、以下の要件があるとします: +- `legacy-app`ディレクトリでは、スペースでフォーマットする +- `backend`ディレクトリと`new-app`ディレクトリでは、タブでフォーマットする +- すべてのディレクトリでは、行幅を120でフォーマットする +- `backend`ディレクトリでは、追加で他のlint設定を行う + +まず、`app/biome.json`に新しい設定ファイルを作成し、共通オプションの設定を行います: + + +```json title="app/biome.json" +{ + "formatter": { + "enabled": true, + "lineWidth": 120 + } +} +``` + +ここで、`legacy-app`ディレクトリで別のオプションを使用するため、`app/frontend/biome.json`を`app/frontend/legacy-app/`に**移動**します: + + +```json title="app/frontend/legacy-app/biome.json" +{ + "formatter": { + "indentStyle": "space" + } +} +``` + +次に、`extends`プロパティを使って、`app/biome.json`のすべてのオプションを継承するように設定を加えます: + +```json title="app/frontend/legacy-app/biome.json" ins={2} +{ + "extends": ["../../biome.json"], + "formatter": { + "indentStyle": "space" + } +} +``` + +最後に、`app/backend/biome.json`でlinterを有効にします: + + +```json title="app/backend/biome.json" +{ + "extends": ["../biome.json"], + "linter": { + "enabled": "true", + "rules": { + "recommended": true + } + } +} +```