From 36350dfb2544766ecfef00860737554ec7ccf68c Mon Sep 17 00:00:00 2001 From: Naoki Ikeguchi Date: Mon, 16 Feb 2026 23:43:10 +0900 Subject: [PATCH 1/5] feat(ja): update Japanese documentation translations MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update outdated Japanese translations in src/content/docs/ja/ to match the latest English documentation: - assist/index.mdx: Add IDE usage section and enforce assist configuration - linter/index.mdx: Major update with configuration, domains, editor integration, and FAQ sections - index.mdx: Add Biome v2.4 banner and update feature cards - internals/language-support.mdx: Add plugin support column and update HTML super languages section - formatter/index.mdx: Rewrite CLI section and restructure options - guides/configure-biome.mdx: Enhance configuration file resolution and exclude files sections - reference/configuration.mdx: Add root, assist, and html sections with comprehensive updates All changes pass textlint validation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- src/content/docs/ja/assist/index.mdx | 63 +- src/content/docs/ja/formatter/index.mdx | 101 ++- .../docs/ja/guides/configure-biome.mdx | 46 +- src/content/docs/ja/index.mdx | 23 +- .../docs/ja/internals/language-support.mdx | 153 ++-- src/content/docs/ja/linter/index.mdx | 431 ++++++++---- .../docs/ja/reference/configuration.mdx | 653 +++++++++++++++--- 7 files changed, 1133 insertions(+), 337 deletions(-) diff --git a/src/content/docs/ja/assist/index.mdx b/src/content/docs/ja/assist/index.mdx index 6e5782f61..d8f64e197 100644 --- a/src/content/docs/ja/assist/index.mdx +++ b/src/content/docs/ja/assist/index.mdx @@ -5,36 +5,67 @@ description: Biomeのアシストについて import NumberOfRules from "@/components/generated/assist/NumberOfRules.astro"; import PackageManagerBiomeCommand from "@/components/PackageManagerBiomeCommand.astro"; +import EditorAction from "@/components/EditorAction.astro"; -Biomeのアシストはユーザのコード品質とDXを向上するためのアクション（またはルール）を提供します。 +Biome Assistはコード品質と開発者体験を向上させるための一連のアクションを提供します。 -リンタのルールとは違い、アシストのアクションはエディタやIDE向けであり、プロパティおよびフィールドのソートや二項式の単純化といったものを含みます。アシストには **つのアクション** があります． +リンターのルールとは異なり、アシストのアクションは常にコード修正を提供します。プロパティやフィールドのソート、二項式の単純化、リファクタリングなどを実行します。アシストのアクションはバグを検出したり、特定のコーディングスタイルを強制したりすることを目的としていません。現在 **個のアシストアクション** が利用可能です。 -アシストのアクションは [LSPのコードアクション](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#codeActionKind) とよく似たセマンティクスを持ちます。 +アシストのコード修正は一般的に安全に適用できます。もしアシストの修正がコードを壊した場合、それはバグと見なされますので、バグ報告をお願いします。 -Biomeのアシストはデフォルトで有効になっています。以下の例では、アシストを有効にした上でアクション `useSortKeys` を有効にしています： +アシストはエディタやIDEで最も効果を発揮します。ただし、CLIでもアシストアクションの使用を強制することが可能です。アシストアクションはセマンティクスにおいて[LSPコードアクション](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#codeActionKind)に非常に近く、[グループ](#groups)に分けられています。 + +Biomeのアシストはデフォルトで有効になっており、いくつかのルールは推奨ルールセットに含まれています。以下の例は `useSortedKeys` アクションを有効にする方法を示しています： ```json title="biome.json" { - "assist": { - "enabled": true, - "actions": { - "source": { - "useSortedKeys": "on" - } - } + "assist": { + "enabled": true, + "actions": { + "source": { + "useSortedKeys": "on" + } } + } } ``` -アシストのアクションはエディタに診断結果を表示 **しません**。しかし、以下の方法があります： +## IDEでアシストアクションを使用する + +LSP互換のIDEを使用している場合、保存時に特定のアクションを実行するようにBiomeを設定できます。各アシストアクションには「コードアクション」と呼ばれる特定のコードがあります。大部分の名前は同じパターンに従っていますが、いくつかの例外がある場合があります（例：`organizeImports`）ので、関連するコードを知るには各アクションのドキュメントページを参照してください。 + +まず、保存時にすべての修正を適用するようにエディタを設定する必要があります。設定はエディタによって異なります。コードアクション名は `source.fixAll.biome` です： + + -## CLIでアシストのアクションを強制する +次に、各アクションのコードを追加できます。たとえば、アクション [`useSortedKeys`](/assist/actions/use-sorted-keys) には `source.action.useSortedKeys.biome` というコードアクションがあります。VSCodeを使用している場合、このコードをコピーして `editor.codeActionsOnSave` セクションに配置すると、ドキュメントを保存したときにBiomeがそれを適用します： -アシストのアクションはCLIの `check` コマンドで強制できます： + + +## CLIでアシストアクションを強制する + +アシストアクションは `check` コマンドを介してCLI経由で強制できます： -しかし、`check` は複数のツールを一度に実行するためのものであり、アシストのアクションのみを確認したい場合は以下を実行するべきです： +ただし、`check` は複数のツールを一度に実行するためのものなので、アシストアクションのみをチェックしたい場合は、次のように実行する必要があります： + + + +### アシストを強制しない + +デフォルトでは、Biomeは `check` コマンドを実行するときにアシストを強制します。*アシストを強制したくない*場合は、`--enforce-assist` CLIフラグを `false` に使用できます。こうすることで、一部のアクションが適用されていない場合でもBiomeは診断エラーを出力しません： + +```shell +biome check --enforce-assist=false +``` + +## アシストアクションの抑制 + +[抑制ページ](/analyzer/suppressions)を参照してください。 + +## グループ + +### Source - +このグループは、保存時にドキュメントに安全に適用できるアクションを表します。これらのアクションは一般的にすべて安全であり、通常はプログラムの機能を変更しません。 diff --git a/src/content/docs/ja/formatter/index.mdx b/src/content/docs/ja/formatter/index.mdx index 93f349893..0bfdbb881 100644 --- a/src/content/docs/ja/formatter/index.mdx +++ b/src/content/docs/ja/formatter/index.mdx @@ -5,40 +5,48 @@ description: Biomeのフォーマッタの使い方 import PackageManagerBiomeCommand from "@/components/PackageManagerBiomeCommand.astro"; -Biomeは、スタイル関する議論に終止符を打つことを目的とした「opinionated」なフォーマッタです。 -[Prettierと近い哲学](https://prettier.io/docs/en/option-philosophy.html)を持ち、 +Biomeは[複数の言語をサポートする](/internals/language-support)、opinionatedなフォーマッタです。 +[Prettierと近い哲学](https://prettier.io/docs/en/option-philosophy.html)に従い、 スタイルに関する議論がBiomeのオプションに関する議論に発展するのを避けるために、いくつかのオプションのみをサポートしています。 -チーム内での[些細な議論](https://ja.wikipedia.org/wiki/パーキンソンの凡俗法則)を防ぎ、本当に重要なことに集中できるようにするために、[新しいオプションを意図的に追加しない](https://github.com/prettier/prettier/issues/40)ようにしています。 +チーム内での[些細な議論](https://en.wikipedia.org/wiki/Law_of_triviality)を防ぎ、本当に重要なことに集中できるようにするために、[新しいオプションを意図的に追加しない](https://github.com/prettier/prettier/issues/40)ようにしています。 -## オプション +## CLI -Biomeがサポートする、言語に依存しないオプションは以下の通りです。 +次のコマンドは、`src` ディレクトリ内のファイルのフォーマットをチェックします。 +フォーマットされていないコードが見つかった場合、テキストの差分を出力します。 -- インデントスタイル（デフォルト： `tab`）：インデントにはスペースまたはタブを使用します -- タブ幅（デフォルト：`2`）：インデントレベルごとのスペースの数です。 -- 行幅（デフォルト：`80`）：Biomeがコードを折り返す列幅です。 + -特定の言語に対する他のフォーマットオプションも利用可能です。詳しくは[設定オプション](/reference/configuration)をご覧ください。 +新しいフォーマットを**適用**する場合は、`--write` オプションを渡してください： -## CLI + -デフォルトでは、フォーマッタはコードを**チェック**し、差分がある場合はそれを報告します。 +このコマンドは、ファイルとディレクトリのリストを受け入れます。 - +:::caution +パラメータとしてglobを渡すと、シェルによって展開されます。 +展開の結果は、使用しているシェルによって異なります。 +例えば、一部のシェルは次のコマンドの再帰的glob `**` や代替 `{}` をサポートしていません： -新しいフォーマットを**適用**する場合は、`--write`オプションを使用してください。 +```shell +biome format ./src/**/*.test.{js,ts} +``` - +シェルの展開にはパフォーマンスコストがあり、コマンドに渡せるファイル数にも制限があります。 +::: -利用可能なオプションを知りたい場合は、`--help`フラグを使用してください。 +利用可能なすべてのオプションの詳細については、[CLIリファレンス](/reference/cli#biome-format)を確認してください。 - +## オプション -その他については、[CLIのリファレンス](/reference/cli#biome-format)を確認してください。 +Biomeは、フォーマッタの動作を調整するためのいくつかのオプションを提供しています。 +他のツールとは異なり、Biomeは言語に依存しないオプションと言語固有のオプションを分離しています。 -## 設定 +フォーマッタオプションは、[CLI](/reference/cli/#biome-format)または[Biome設定ファイル](/guides/configure-biome)で設定できます。 +v1.9以降、Biomeは `.editorconfig` ファイルの読み込みをサポートしています。 -`biome.json`を使用して、[フォーマッターを設定](/reference/configuration/#formatter)することができます。以下はデフォルトの設定です。 +[Biome設定ファイル](/guides/configure-biome)を使用して、Biome CLIとBiome LSPの両方が同じオプションを適用するようにすることをお勧めします。 +以下のデフォルト設定が適用されます： ```json title="biome.json" { @@ -49,8 +57,8 @@ Biomeがサポートする、言語に依存しないオプションは以下の "attributePosition": "auto", "indentStyle": "tab", "indentWidth": 2, - "lineEnding": "lf", - "lineWidth": 80 + "lineWidth": 80, + "lineEnding": "lf" }, "javascript": { "formatter": { @@ -71,21 +79,58 @@ Biomeがサポートする、言語に依存しないオプションは以下の } ``` -他のツールと違って、Biomeは言語ごとに関するオプションを設定することができます。 +Biomeフォーマッタがサポートする主な言語に依存しないオプションは次のとおりです： + +- インデントスタイル（デフォルト：`tab`）：インデントにスペースまたはタブを使用します。 +- インデント幅（デフォルト：`2`）：インデントレベルごとのスペースの数です。 +- 行幅（デフォルト：`80`）：Biomeがコードを折り返す列幅です。 -## コードのフォーマットを無効にする +詳細については、[設定リファレンス](/reference/configuration#formatter)を参照してください。 + +## コードを無視する フォーマットされたコードが理想的でない場合があります。 -そのような場合は、フォーマットを抑制するコメントが使用できます。 +### ファイル全体を無視する + +ファイル全体に対してフォーマッタを抑制（無視）するには、**ファイルの先頭**に `biome-ignore-all format: reason` コメントを使用します： + +例えば、JavaScriptの場合： + +```js title="example.js" +// biome-ignore-all format: generated file + +const expr1 = + [ + (2 * n) / (r - l), + 0, + (r + l) / (r - l), + -1, + 0, + ]; + + +const expr2 = + [ + (2 * n) / (r - l), + 0, + (r + l) / (r - l), + -1, + 0, + ]; +``` + +### ノードを無視する + +コードの一部（ノード）だけを抑制したい場合は、抑制コメント `biome-ignore format: reason` を使用します -```js -// biome-ignore format: <説明文> +```js title="example.js" +// biome-ignore format: reason ``` -Example: +例： -```js +```js title="example.js" const expr = // biome-ignore format: この配列はフォーマットさせない。 [ diff --git a/src/content/docs/ja/guides/configure-biome.mdx b/src/content/docs/ja/guides/configure-biome.mdx index 3752e72e4..22799220f 100644 --- a/src/content/docs/ja/guides/configure-biome.mdx +++ b/src/content/docs/ja/guides/configure-biome.mdx @@ -74,10 +74,23 @@ Biomeでは、JavaScript言語のすべての種類を `javascript` と呼んで ## 設定ファイルの解決 -Biomeは最も近い設定ファイルを見つけるために自動探索を利用します。 -作業ディレクトリとその親ディレクトリから `biome.json` または `biome.jsonc` ファイルを見つけます。 -いずれの設定も見つからない場合は、Biomeのデフォルトを適用します。 -`biome.json` と `biome.jsonc` の両方が同じフォルダにある場合は、`biome.json` を優先します。 +Biomeは次の順序で以下の設定ファイルをサポートしています： +1. `biome.json` +2. `biome.jsonc` +3. `.biome.json` +4. `.biome.jsonc` + +Biomeは次の順序で設定ファイルを検出しようとします： +1. 現在の作業ディレクトリ + - CLIでは、作業ディレクトリはコマンドが実行される場所です + - エディタでは、作業ディレクトリはプロジェクトのルートです +2. 親フォルダを再帰的に検索 +3. ホームディレクトリ（OSによって異なります）： + - Linuxでは [`$XDG_CONFIG_HOME`](https://specifications.freedesktop.org/basedir/latest/#variables) または `$HOME/.config/biome` + - macOSでは `/Users/$USER/Library/Application Support/biome` + - Windowsでは `C:\Users\$USER\AppData\Roaming\biome\config` + +設定が見つからない場合は、Biomeのデフォルト設定が使用されます。 以下は例です： @@ -100,7 +113,7 @@ Biomeは最も近い設定ファイルを見つけるために自動探索を利 `app/frontend/biome.json` の設定ファイルを使います :::note -Biome（v2.0.0以降）はネストされた `biome.json` ファイルをサポートしています。詳細については、[大規模プロジェクトでのBiomeの使用](/guides/big-projects#use-multiple-configuration-files)を参照してください。 +Biomeはネストされた `biome.json` ファイルをサポートしています。詳細については、[大規模プロジェクトでのBiomeの使用](/guides/big-projects#use-multiple-configuration-files)を参照してください。 ::: @@ -187,24 +200,36 @@ biome lint test/ #### 設定ファイルでファイルを除外する -Biomeによって処理されないファイルやフォルダを除外したい場合は、`files.includes` 設定を使用し、先頭に `!` を付けたnegatedパターンを使用できます。 +Biomeによって処理されないファイルやフォルダを除外したい場合は、`files.includes` 設定を使用し、negatedパターンを使用できます： +- 先頭に `!` を使用してファイルをリント/フォーマットから除外する +- 二重の先頭 `!!` を使用してプロジェクト関連の操作からファイルを除外する + +プロジェクト関連の操作には以下が含まれます： +- 内部モジュールグラフの構築。[一部のプロジェクトルール](/linter/domains/#project)がインポートとエクスポートから情報を解決できるようにするためです。 +- 型の推論。型を考慮したリントルールが正しく型を推論できるようにするためです。 + +プロジェクト関連の操作の対象と見なされるファイルは**インデックス化**されます。 negatedされたglobを列挙する前に、**それらの前に `**` パターンを付ける必要があります**。 -次の例では、すべてのファイルを含めるようBiomeに指示しますが、任意の `dist/` フォルダ内のファイルと、`.generated.js` で終わるファイルは除外します： +次の例では、すべてのファイルを含めるようBiomeに指示しますが、以下を除外します： +- `dist/` フォルダ。プロジェクト関連の操作から除外されるため、インデックス化されません。 +- `.generated.js` で終わるファイル。フォーマットとリントから除外されますが、インデックス化はされます。 ```json title="biome.json" { "files": { "includes": [ "**", - "!**/dist", - "!**/*.generated.js" + "!**/*.generated.js", + "!!**/dist" ] } } ``` +スキャナーとの相互作用、およびファイルのインデックス化方法の詳細については、[関連するリファレンスページ](/reference/configuration#interaction-with-the-scanner)を確認してください。 + ### VCSでファイルを制御する @@ -267,3 +292,6 @@ negatedされたglobを列挙する前に、**それらの前に `**` パター - `tsconfig.json` - `typedoc.json` - `typescript.json` +- `$PROJECT/.vscode/*` フォルダ配下および[ユーザーVSCode設定フォルダ](https://code.visualstudio.com/docs/configure/settings#_user-settingsjson-location)配下のすべての `.json` ファイル +- `$PROJECT/.zed/*` フォルダ配下および[ユーザーZed設定フォルダ](https://zed.dev/docs/configuring-zed#user-settings-file)配下のすべての `.json` ファイル +- `$PROJECT/.cursor/*` フォルダ配下およびユーザーCursor設定フォルダ配下のすべての `.json` ファイル diff --git a/src/content/docs/ja/index.mdx b/src/content/docs/ja/index.mdx index f78014df2..167383b92 100644 --- a/src/content/docs/ja/index.mdx +++ b/src/content/docs/ja/index.mdx @@ -8,6 +8,10 @@ description: フォーマット、リントなどが一瞬で完了します！ editUrl: false next: false +banner: + content: | + 今年最初のマイナーリリース、Biome v2.4がリリースされました！ + hero: title: Web開発のためのたった1つのツールチェーン tagline: フォーマット、リントなどが一瞬で完了します！ @@ -40,7 +44,8 @@ import "@/styles/_community.css"; import Netlify from "@/components/Netlify.astro"; import Sponsors from "@/components/Sponsors.astro"; import LinterExample from "@/components/linter/example.md"; -import AwardBanner from "@/components/AwardBanner.astro"; +import NumberOfRules from "@/components/generated/linter/NumberOfRules.astro"; +import AwardBanner from "@/components/AwardBanner.astro" import FeaturedUsers from "@/components/FeaturedUsers.astro"
@@ -49,7 +54,7 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro"

Prettierのようにコードをフォーマット、しかも高速

- **Biomeは _JavaScript_、_TypeScript_、_JSX_、_JSON_、_CSS_ そして _GraphQL_ のための[高速なフォーマッタ](https://github.com/biomejs/biome/tree/main/benchmark#formatting)** であり、[**_Prettier_ と97%の互換性**](https://console.algora.io/challenges/prettier)を持ち、**CIと開発者の時間を節約します**。 + **Biomeは _JavaScript_、_TypeScript_、_JSX_、_TSX_、_JSON_、_HTML_、_CSS_ そして _GraphQL_ のための[高速なフォーマッタ](https://github.com/biomejs/biome/tree/main/benchmark#formatting)** であり、[**_Prettier_ と97%の互換性**](https://console.algora.io/challenges/prettier)を持ち、**CIと開発者の時間を節約します**。 Biomeは、[お気に入りのエディタ](/ja/guides/editors/first-party-extensions/)でコードを書く際に、**不正な形式のコード**さえもフォーマットできます。 @@ -98,7 +103,7 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro"

問題を修正し、ベストプラクティスを学ぶ

- **Biomeは _JavaScript_、_TypeScript_、_JSX_、_CSS_ そして _GraphQL_ のための[高性能なリンタ](https://github.com/biomejs/biome/tree/main/benchmark#linting)** であり、ESLint、typescript-eslint、[その他のソース](https://github.com/biomejs/biome/discussions/3)に由来する **[200以上のルール](/linter/rules/)** を備えています。 + **Biomeは _JavaScript_、_TypeScript_、_JSX_、_CSS_ そして _GraphQL_ のための[高性能なリンタ](https://github.com/biomejs/biome/tree/main/benchmark#linting)** であり、ESLint、TypeScript ESLint、[その他のソース](/linter/rules-sources/)に由来する **[個のルール](/linter/)** を備えています。 **Biomeは、文脈を考慮した詳細な診断を出力**してくれるため、あなたがコードを改善してより優れたプログラマーになるのに役立ちます！ @@ -144,14 +149,14 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro" あらゆる規模のコードベースに対応するよう設計されているので、ツールではなく製品の成長に集中できます。 - - 各機能の内部処理は、可能な限り統合され、再利用されています。このため、あるツールの改善がすべてのツールを向上させることがあります。 - - + 曖昧なエラーメッセージを極力避けます。問題がある場合は、その位置を明示して、解決のためのステップを提供します。 - フロントエンド開発で利用される言語に対して、優れたサポートを提供します。特にTypeScriptおよびJSXへのサポートを第一にしています。 + 今日使用しているすべての言語機能をそのままサポートします。TypeScriptとJSXへのファーストクラスサポートを提供します。 + + + コントリビューターのコミュニティを通じて、必要とする組織に商用サポートを提供しています。
@@ -162,7 +167,7 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro"
好みのパッケージマネージャーを使用してBiomeをインストールし、エディターに組み込みましょう。
- + パッケージマネージャーでインストール arrow diff --git a/src/content/docs/ja/internals/language-support.mdx b/src/content/docs/ja/internals/language-support.mdx index ee04c5d43..40d67ac06 100644 --- a/src/content/docs/ja/internals/language-support.mdx +++ b/src/content/docs/ja/internals/language-support.mdx @@ -7,29 +7,52 @@ description: Biomeがサポートする言語と機能。 - ✅: 対応済み - 🚫: 進行中ではない - ⌛️: 進行中 -- ⚠️: 一部サポート（いくつかの注意点あり） - -| Language | Parsing | Formatting | Linting | -| -------- | ------- | ---------- | ------- | -| [JavaScript](#javascriptのサポート) | ✅ | ✅ | ✅ | -| [TypeScript](#typescriptのサポート) | ✅ | ✅ | ✅ | -| JSX | ✅ | ✅ | ✅ | -| TSX | ✅ | ✅ | ✅ | -| JSON | ✅ | ✅ | ✅ | -| JSONC | ✅ | ✅ | ✅ | -| HTML | ✅ | ✅ | ✅ | -| [Vue](#html拡張言語のサポート) | ⚠️ | ⚠️ | ⚠️ | -| [Svelte](#html拡張言語のサポート) | ⚠️ | ⚠️ | ⚠️ | -| [Astro](#html拡張言語のサポート) | ⚠️ | ⚠️ | ⚠️ | -| CSS | ✅️ | ✅️ | ✅️ | -| [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | 🚫 | 🚫 | -| GraphQL | ✅️ | ✅️ | ✅️ | -| [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | 🚫 | 🚫 | +- 🟡: 実験的 + +| Language | Parsing | Formatting | Linting | Plugin Support | +|----------------------------------------------------------|------------------------------------------------------|------------------------------------------------------|---------------------------------------------------------|---------------------------------------------------------| +| [JavaScript](#javascriptのサポート) | ✅ | ✅ | ✅ | ✅ | +| [TypeScript](#typescriptのサポート) | ✅ | ✅ | ✅ | ✅ | +| JSX | ✅ | ✅ | ✅ | ✅ | +| TSX | ✅ | ✅ | ✅ | ✅ | +| JSON | ✅ | ✅ | ✅ | ✅ | +| JSONC | ✅ | ✅ | ✅ | ✅ | +| HTML* | ✅ | ✅ | ✅ | ✅ | +| [Vue](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Svelte](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Astro](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | +| CSS | ✅️ | ✅️ | ✅️ | ✅ | +| SCSS | ⌛️ | ⌛️ | 🚫 | 🚫 | +| [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | ⌛️ | 🚫 | 🚫 | +| GraphQL | ✅️ | ✅️ | ✅️ | 🚫 | +| [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | ⌛️ | 🚫 | 🚫 | +| GritQL | ✅️ | ✅️ | 🚫 | 🚫 | + +*\* 現在、[明示的なオプトイン](https://biomejs.dev/reference/configuration/#html)が必要です。* ## JavaScriptのサポート -Biomeは、JavaScript（ES2024）をサポートしています。 -また、公式の構文のみをサポートしています。新しい構文に対する機能の開発は、その構文の提案が[Stage 3](https://github.com/tc39/proposals#stage-3)に達したときに開始されます。 +BiomeはES2024バージョンの言語をサポートしています。 + +Biomeは公式の構文のみをサポートしています。新しい構文の開発は、提案が +[Stage 3](https://github.com/tc39/proposals#stage-3)に達したときに開始されます。 + +### 埋め込み言語のサポート（実験的） + +BiomeはJavaScriptのテンプレートリテラル内に埋め込まれた以下の言語をサポートしています： + +- CSS（`css` または `styled` タグ） +- GraphQL（`gql` または `graphql` タグ） + +この機能はまだ実験的で、デフォルトでは無効になっています。この機能を有効にするには、`javascript.experimentalEmbeddedSnippetsEnabled` オプションを設定してください。 + +```json title=biome.json +{ + "javascript": { + "experimentalEmbeddedSnippetsEnabled": true + } +} +``` ## TypeScriptのサポート @@ -51,39 +74,65 @@ JSONCは「コメント付きJSON」の略です。この形式は、[VS Code](h ## HTML拡張言語のサポート -バージョン `1.6.0` 以降、これらの言語は**部分的に**サポートされています。Biomeは時間とともに改善され、プロジェクトを調整するためのオプションが増えていく予定です。しかし、現在ではいくつかの期待と制限を考慮する必要があります： -- `.astro` ファイルでは、**フロントマター部分のみ**がサポートされています。 -- `.vue` および `.svelte` ファイルでは、**\タグ部分のみ**がサポートされています。 -- 診断は上記の部分に属するコードフレームのみを表示します。 -- `.vue` および `.svelte` ファイルを**フォーマット**する際、JavaScript/TypeScriptコードのインデントは最初から始まります。 - - ```vue title="file.vue" del={2} ins={3} - - ``` - -- `.svelte` 、`.astro` 、 `.vue` ファイルを**静的解析**する際、コンパイラエラーを防ぐためにいくつかのルールをオフにすることをお勧めします。オプション `overrides` を使用します： - - ```json - { - "overrides": [ - { - "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], - "linter": { - "rules": { - "style": { - "useConst": "off", - "useImportType": "off" - }, - "correctness": { - "noUnusedVariables": "off", - "noUnusedImports": "off" - } +バージョン `v2.3.0` 以降、BiomeはVue、Svelte、Astroファイルをすぐにサポートしています。これは、Biomeがファイル内のHTML、CSS、JavaScriptの部分をフォーマットおよびリントできることを意味します。 + +ただし、この**サポートは実験的なもの**と見なす必要があり、変更や改善の対象となります。`v2.3.0` では、この機能を可能にするアーキテクチャが導入されましたが、いくつかのフォーマットおよびリントルールは調整が必要です。 + +特に、`v2.3.0` の時点では、Biomeは言語固有の構文（例：Svelteの制御フロー構文 `{#if } {/if}`）に対して特別なパースを行いません。これは、フォーマットが期待される結果と一致しない場合があり、リントルールが一部のケースを検出できない可能性があることを意味します。 + +埋め込み言語をまたいで動作するリントルールはまだサポートされていません。 + +### HTML系言語のリント + +`.svelte`、`.astro`、または `.vue` ファイルを**リント**し、`html.experimentalFullSupportEnabled` が `false` の場合、部分的なサポートによって引き起こされる誤検出のリントエラーを防ぐために、いくつかの追加ルールをオフにすることをお勧めします。そのために `overrides` オプションを使用します： + +```json title=biome.json +{ + "overrides": [ + { + "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], + "linter": { + "rules": { + "style": { + "useConst": "off", + "useImportType": "off" + }, + "correctness": { + "noUnusedVariables": "off", + "noUnusedImports": "off" } } } - ] + } + ] +} +``` + +### 異なる設定でのフォーマット + +Biomeでは、異なる言語のフォーマットを制御できます。Biomeが同じファイル内で複数の言語を処理できるようになったため、 +設定によっては不整合が発生する可能性が高まります。 + +例えば、完全サポートが有効になっていると仮定した場合、JavaScriptとCSSコードを含むHTML系ファイルをフォーマットする際に、次の例のようにタブとスペースが混在するファイルになるリスクがあります： + +```json title=biome.json +{ + "javascript": { + "format": { + "indentStyle": "tab" + } + }, + "css": { + "format": { + "indentStyle": "space", + "indentWidth": 4 + } } - ``` +} +``` + +この問題に対処するための[GitHubディスカッション](https://github.com/biomejs/biome/discussions/7754)を作成しました。ディスカッションに参加して、ご意見をお聞かせください。 + +:::note +この最後のセクションは古くなる可能性があるため、[プレイグラウンド](https://biomejs.dev/playground)を使用して、機能が実装されているかどうかを確認することをお勧めします。 +::: diff --git a/src/content/docs/ja/linter/index.mdx b/src/content/docs/ja/linter/index.mdx index af8035081..f62a795a3 100644 --- a/src/content/docs/ja/linter/index.mdx +++ b/src/content/docs/ja/linter/index.mdx @@ -5,179 +5,212 @@ description: Biomeリンタの使い方 import NumberOfRules from "@/components/generated/linter/NumberOfRules.astro"; import PackageManagerBiomeCommand from "@/components/PackageManagerBiomeCommand.astro"; +import { Steps } from '@astrojs/starlight/components'; +import EditorAction from "@/components/EditorAction.astro"; -Biomeのリンタはあなたのコードを静的に分析し、典型的なエラーを検出して、より自然なコードを書く手助けをします。 -[複数の言語](/internals/language-support)をサポートし、全部で** 個のルール**を提供しています。 +Biomeのリンタはコードを静的に分析し、一般的なエラーを見つけて修正し、より優れた最新のコードを書くのに役立ちます。 +[複数の言語](/internals/language-support)をサポートし、全部で**個のルール**を提供しています。 -## CLI - -以下のコマンドはプロジェクトのルートからすべてのファイルに対してリンタを実行します： +CLIを使用してBiomeリンタをすぐに試すことができます。次のコマンドは、プロジェクトのルートからすべてのファイルに対してリンタを実行します： -または、フォルダを指定できます。例えば `./src` を指定します： +または、1つまたは複数のフォルダを指定できます。たとえば `./src` と `./public` です： - + -コマンドはファイルとディレクトリのリストを受け入れます。 +このコマンドはファイルとディレクトリのリストを受け入れます。 :::caution -globをパラメータとして渡す場合、シェルがそれを展開します。 -シェルによって展開結果は異なります。 -例えば、いくつかのシェルは以下のコマンドのような再帰的なglob `**` や代替 `{}` をサポートしていません： +パラメータとしてglobを渡すと、シェルがそれを展開します。**BiomeはGlobをサポートしていません**。 +展開の結果はシェルによって異なります。 +たとえば、一部のシェルでは、次のコマンドで再帰的なglob `**` や代替 `{}` をサポートしていません： ```shell biome lint ./src/**/*.test.{js,ts} ``` -シェルの展開にはパフォーマンスのコストがあり、またコマンドに渡せるファイルの数には制限があります。 +シェル展開にはパフォーマンスコストがあり、コマンドに渡すことができるファイル数にも制限があります。 + +globの使用は**推奨されません**。代わりに `includes` 設定を使用してください。 ::: -利用可能なすべてのオプションについて、詳しくは[CLIリファレンス](/reference/cli#biome-lint)を参照してください。 +利用可能なすべてのオプションの詳細については、[CLIリファレンス](/reference/cli#biome-lint)を確認してください。 ## ルール -リンタはルールに整理されています。 -ルールはその要求に満たないコードを検知すると診断結果を出力します。 -例えば、[noDebugger](/linter/rules/no-debugger) ルールはJavaScriptコードでの `debugger` 命令の利用を報告します。 +リンタはルールに整理されています。ルールはコードスタイルを強制または拒否したり、バグにつながる可能性のあるものの使用などを目的としています。一般的に、ルールは他のルールと競合してはいけません（特に指示がない限り）。 +Biomeのルールには命名規則があります。`use*` で始まるルールは何かを強制/提案することを目的としており、`no*` で始まるルールは何かを拒否することを目的としています。ルールがその概念の*違反*に遭遇すると、診断を出力します。 -ルールは診断結果を `info`、`warn`、`error` の重大度で出力します。 -`error` 重大度の診断結果はコマンドを非ゼロのステータスコードで終了させます。 -`info` または `warn` 重大度の診断結果はコマンドを失敗させません。 +たとえば、[noDebugger](/linter/rules/no-debugger) はJavaScriptコードでの `debugger` ステートメントの使用を拒否し、見つけた場合に診断を出力します。 -`--error-on-warnings` オプションを使うことで、 `warn` の診断結果にコマンドを失敗させることができます： +Biomeリンタには言語に基づいて異なる推奨ルールのセットが付属しており、`lint` または `check` コマンドを実行する際にデフォルトのBiome設定（または設定なし）を利用すると、デフォルトで有効になります： ```shell -biome lint --error-on-warnings ./src +biome lint +biome check ``` -デフォルトでは、Biomeのリンタは**推奨されたルール**のみを実行します。 -_すべてのルール_を無効化するには、Biomeの設定ファイルで推奨されたルールを無効化します。 -これはいくつかのルールのみを有効化したいときに有用です。 -推奨されたルールは `error` 重大度で診断結果を出力します。 +各リントルールにはデフォルトの[重大度](/reference/diagnostics#diagnostic-severity)があり、ルールのドキュメントを読むことで詳細を学ぶことができます。 -ルールはグループに分割されています。 -例えば、`noDebugger` ルールは [`suspicious` グループ](/ja/linter#suspicious) の一部です。 -このグループのルールは、間違っている可能性があるか不要であるコードを検出します。 -各グループの説明はルールページで確認できます。 +ルールは[グループ](#linter-groups)に分けられています。たとえば、`noDebugger` ルールは [`suspicious` グループ](#suspicious)の一部です。 -他のリンタとは違い、コードのフォーマットをチェックするルールを提供していません。 -こうしたチェックは[コードフォーマッタ](/ja/formatter/)が行います。 +Biomeは*言語に依存しないルール*をサポートしています。これらは複数の言語で機能するルールで、たとえば `noUselessEscapeInString` はJavaScriptとCSSの両方で無駄なエスケープシーケンスを報告できます。 + +他のリンタとは異なり、Biomeはコードフォーマットをチェックするルールを提供していません。[Biomeフォーマッタ](/formatter/)がすべてのフォーマット決定を処理することを意図しています。 多くのルールは自動的に適用できる**コード修正**を提供しています。 -Biomeでは、**安全な**修正と**安全ではない**修正を区別しています。 -### 安全な修正（Safe fixes） +Biomeは[**安全な修正**](#safe-fixes)と[**安全でない修正**](#unsafe-fixes)を区別しており、これらは若干異なる動作をします。主な違いは、安全な修正はファイルの保存時に自動的に適用できますが、安全でない修正はできません。ただし、ユーザーはどの修正を安全と見なすかを上書きできます。 + +Biomeリンタには自動的に有効になる推奨ルールのセットが付属しており、言語によって異なります。 -安全な修正は、コードのセマンティクスを変更しないことが保証されています。明示的なレビューなしに適用できます。 +### 安全な修正 (Safe fixes) -_安全な修正_ を適用するには、`--write`を使用します： +安全な修正は、コードのセマンティクスを変更しないことが保証されています。 +明示的なレビューなしに適用できます。 + +CLIから_安全な修正_を適用するには、`--write` を使用します： -### 安全ではない修正（Unsafe fixes） +LSP互換エディタから、コードアクション `source.fixAll.biome` を使用して安全な修正を**保存時に**適用できます。 +適用方法については、エクステンションのドキュメントを参照してください。 + +### 安全でない修正 -安全ではない修正は、プログラムのセマンティクスを変更する可能性があります。そのため、変更を手動でレビューすることをおすすめします。 +安全でない修正は、プログラムのセマンティクスを変更する可能性があります。 +したがって、変更を手動でレビューすることをお勧めします。 -_安全ではない修正_ を適用するには、`--write --unsafe`を使用します： +CLIから_安全な修正_と_安全でない修正_の両方を適用するには、`--write --unsafe` を使用します： -### ルールの基本原則 +LSP互換エディタから、保存時にすべての安全でない修正を適用することはできません。保存時にコードのセマンティクスを変更することは望ましくありません。ただし、個々のコード修正を確認して適用することを選択できます。 -私たちは、ただルールを指示的に指摘するのではなく、なぜそのルールがトリガーされた理由をユーザーに説明し、エラーを修正する方法をユーザーに伝えることが大切だと考えています。 -ルールは以下のような**重要な要素**に沿って選定されています： +### ルールの基本原則 -1. ユーザーに対してエラーの説明を行います。これは基本的に診断のメッセージです。 -2. 次に、ユーザーに対してエラーがトリガーされた理由を説明します。これは基本的に追加のノードで実装されます。 -3. 最後にユーザーに何をすべきかを伝えます。これは基本的にコードアクションを使用して実装されます。 - コードアクションが適用できない場合は、ノートでユーザーに何をすべきかを伝えます。 +Biomeでは、ルールは情報を提供し、ルールがトリガーされた理由をユーザーに説明し、エラーを修正するために何をすべきかを伝える必要があります。 +ルールは次の**基本原則**に従う必要があります： -もしルールがこれらの要素に従っていないと感じたのであれば、[イシューを作成](https://github.com/biomejs/biome/issues/new?assignees=&labels=S-To+triage&projects=&template=01_bug.yml&title=%F0%9F%90%9B+%3CTITLE%3E)してください。 +1. ユーザーにエラーを説明します。一般的に、これは診断のメッセージです。 +2. ユーザーに**なぜ**エラーがトリガーされたかを説明します。一般的に、これは追加のノートで実装されます。 +3. ユーザーに何をすべきかを伝えます。一般的に、これはコードアクションを使用して実装されます。 +コードアクションが適用できない場合、ノートでユーザーにエラーを修正するために何をすべきかを伝える必要があります。 -### ルールまたはグループをスキップする +ルールがこれらの基本原則に従っていないと思う場合は、[イシューを開いてください](https://github.com/biomejs/biome/issues/new?assignees=&labels=S-To+triage&projects=&template=01_bug.yml&title=%F0%9F%90%9B+%3CTITLE%3E)。 -バージョン **v1.8.0** から、`biome lint` コマンドはルールまたはルールの属するグループを無効化する `--skip` オプションを受け入れるようになりました。 +## リンタの設定 -例えば、以下のコマンドは `style` グループに属するすべてのルールと `suspicious/noExplicitAny` ルールをスキップします： +多くの場合、個人のニーズや組織/プロジェクトのニーズに基づいてリンタを変更したいと思うでしょう。 +Biomeではリンタをカスタマイズでき、このセクションではその方法を学びます。 -```shell -biome lint --skip=style --skip=suspicious/noExplicitAny -``` -### ルールまたはスキップを実行する +### ルールを無効にする -バージョン **v1.8.0** から、`biome lint` コマンドは特定のルールまたはルールの属するグループのみを実行する `--only` オプションを受け入れるようになりました。 +ルールを `off` で無効にすることができます。 -例えば、以下のコマンドは `style/useNamingConvension` ルール、`style/noInferrableTypes` ルール、そして `a11y` グループに属するすべてのルールのみを実行します。 -ルールが設定によって無効化されている場合、推奨されるルールの重大度は `error` に設定され、それ以外のルールの重大度は `warn` に設定されます。 +次の設定は、推奨ルール `noDebugger` を無効にします： -```shell -biome lint --only=style/useNamingConvention --only=style/noInferrableTypes --only=a11y +```json title="biome.json" ins="\"off\"" +{ + "linter": { + "rules": { + "suspicious": { + "noDebugger": "off" + } + } + } +} ``` -## 設定 +### 推奨ルールを無効にする -ルールはニーズに応じて設定できます。 +簡単な設定で推奨ルールを無効にできます。これは、いくつかのルールのみを有効にしたい場合に便利です。 -### リントルールの無効化 +```json name="biome.json" ins={4} +{ + "linter": { + "rules": { + "recommended": false + } + } +} +``` -重大度 `error`、`warn`、`info` のいずれかを指定するとルールは有効化され、`off` を指定すると無効化されます。 +### ルールの重大度を変更する -以下の設定では、推奨された `noDebugger` ルールを無効化し、`noShoutyConstants` と `useNamingConvention` ルールを有効化します。 +Biomeのリントルールには独自のデフォルトの重大度が設定されています。デフォルトの重大度を適用したい場合は、`"on"` 設定を使用できます。 -重大度 `warn` はリファクタリングの最中にCIをパスさせる必要がある場合に便利です。 -診断結果のメッセージは黄色です。 -`--error-on-warnings` を使うことで、 `warn` が指定されたルールが検知された場合にエラーコードで終了させられます。 +たとえば、`noShoutyConstants` はデフォルトで推奨されておらず、トリガーされると情報重大度の診断を出力します。 -重大度 `info` は `--error-on-warnings` が渡されたとしても、CLIの終了ステータスコードに影響しません。 -診断結果のメッセージは青色です。 +このデフォルトに満足していて使用したい場合、設定は次のようになります： -```json title="biome.json" +```json title="biome.json" ins="\"on\"" { "linter": { "rules": { - "suspicious": { - "noDebugger": "off", - "noConsoleLog": "info" - }, "style": { - "noShoutyConstants": "warn", - "useNamingConvention": "error" + "noShoutyConstants": "on" } } } } ``` -### ルール修正の設定 +デフォルトの重大度に満足していない場合、Biomeでは `"error"`、`"warn"`、`"info"` で変更できます。 -バージョン **v1.8.0** から、 `fix` オプションによって修正方法を設定できるようになりました。 -次の3つのオプションがあります： +[`"error"`](/reference/diagnostics#error) の診断は常にCLIをエラーコードで終了させます。この重大度は、特定のルールに属する違反がある場合にCIをブロックしたい場合に役立ちます。 + +[警告](/reference/diagnostics#warning)はエラーと似ていますが、`--error-on-warnings` フラグが使用されない限り、CLIをエラーコードで終了させません。`warn` 重大度の可能な使用法は、特定のルールに対する診断がまだある間にCIをパスさせたい場合です。 + +[`info`](/reference/diagnostics#information) 重大度は、`--error-on-warnings` が渡された場合でも、CLIの終了ステータスコードに影響しません。 + +### グループの重大度を変更する + +さらに、**グループレベル**でリントルールの重大度を制御できます。これにより、グループに属する**すべてのルール**の診断重大度を制御できます。 + +たとえば、プロジェクトはバックエンドで実行されるコードであるため `a11y` ルールの使用を必要としない場合、アクセシビリティは懸念事項ではありません。次の例は、`a11y` グループに属するすべてのルールを無効にします： + +```json name="biome.json" ins={4} +{ + "linter": { + "rules": { + "a11y": "off" + } + } +} +``` + +### コード修正を設定する + +上記で説明したように、ルールは**安全**または**安全でない**コード修正を出力する場合があります。Biomeでは、安全な修正を安全でないものとして扱うように設定でき、その逆も可能です。コード修正を完全に無効にすることもできます。 + +コード修正は `fix` オプションを使用して設定できます。次の3つの値のいずれかを持つことができます： - `none`: ルールはコード修正を出力しません -- `safe`: ルールは[安全な修正](#安全な修正safe-fixes)のみを出力します -- `unsafe`: ルールは[安全ではない修正](#安全ではない修正unsafe-fixes)も出力します +- `safe`: ルールは[安全な修正](#safe-fixes)を出力します +- `unsafe`: ルールは[安全でない修正](#unsafe-fixes)を出力します -```json title="biome.json" +```json title="biome.jsonc" ins={7,13,17} { "linter": { "rules": { "correctness": { "noUnusedVariables": { "level": "error", - "fix": "none" + "fix": "none" // noUnusedVariablesにはコード修正が提案されません } }, "style": { "useConst": { "level": "warn", - "fix": "unsafe" + "fix": "unsafe" // useConstのコード修正は安全でないと見なされます }, "useTemplate": { "level": "warn", - "fix": "safe" + "fix": "safe" // useTemplateのコード修正は安全と見なされます } } } @@ -185,10 +218,30 @@ biome lint --only=style/useNamingConvention --only=style/noInferrableTypes --onl } ``` -## ルールの設定 +### ルールまたはグループをスキップする + +`biome lint` コマンドは、個々のルールまたはルールのグループを無効にできる `--skip` オプションを受け入れます。 + +たとえば、次のコマンドは `style` グループに属するすべてのルールと `suspicious/noExplicitAny` ルールをスキップします： + +```shell +biome lint --skip=style --skip=suspicious/noExplicitAny +``` + +### ルールまたはグループのみを実行する + +`biome lint` コマンドは、個々のルールまたはルールのグループを実行できる `--only` オプションを受け入れます。 + +たとえば、次のコマンドは、`style/useNamingConvention` ルール、`style/noInferrableTypes` ルール、および `a11y` に属するルールのみを実行します。ルールが設定で無効になっている場合、推奨ルールの重大度レベルは `error` に設定され、それ以外の場合は `warn` に設定されます。 + +```shell +biome lint --only=style/useNamingConvention --only=style/noInferrableTypes --only=a11y +``` + +### ルールオプション -いくつかのルールには、より詳細な設定があります。 -ルールに詳細な設定がある場合、ルールの値を変更することで指定できます。 +いくつかのルールにはオプションがあります。 +ルールの値を異なる形式にすることで設定できます。 - `level` は診断の重大度を示します - `options` はルールによって異なります @@ -196,12 +249,13 @@ biome lint --only=style/useNamingConvention --only=style/noInferrableTypes --onl ```json title="biome.json" { "linter": { - "enabled": true, "rules": { - "correctness": { - "noCommentText": { - "level": "warn", - "options": {} + "style": { + "useNamingConvention": { + "level": "error", + "options": { + "strictCase": false + } } } } @@ -209,65 +263,188 @@ biome lint --only=style/useNamingConvention --only=style/noInferrableTypes --onl } ``` +### ドメイン -## コードの無視 +ドメインは、ルールを技術、つまり_ドメイン_でグループ化できるBiomeの機能です。ドメインの例には、`"react"`、`"solid"`、`"test"` があります。 -特定のコード行に対するリントを無視したい場合があります。 -これは、リンタが指摘している行の上に抑制コメントを追加することで実現できます。 +ドメインは： +- 独自の推奨ルールのセットを持ちます。 +- `package.json` ファイルで特定の依存関係を検出すると、Biomeが自動的に有効にできます。 +- 追加のグローバル変数を定義できます。 -抑制コメントは、以下の形式で記述します： +Biomeのリンタは、最も近い `package.json` で特定の依存関係を検出すると、ドメインに属するルールを自動的に有効にします。たとえば、`mocha` 依存関係が検出された場合、Biomeは [`test`](/linter/domains#test) ドメインの**推奨ルール**を有効にします。 -```js -// biome-ignore lint: -// biome-ignore lint/suspicious/noDebugger: +ただし、`package.json` がない場合、またはデフォルトの設定が適用されない場合は、設定を介してドメインを有効にできます： + +```json title="biome.json" ins={4} +{ + "linter": { + "domains": { + "test": "recommended" + } + } +} ``` -ここで +さらに、`"all"` 値を使用して、ドメインに属する**すべての**ルールを有効にできます： -- `biome-ignore`：抑制コメントの開始を表します； -- `lint`：はリンタを抑制することを表します； -- `/suspicious/noDebugger`：**任意** 抑制したいルールのグループと名前を表します； -- ``：ルールが無効になっている理由を表します； -例： +```json title="biome.json" ins={4} mark="all" +{ + "linter": { + "domains": { + "test": "all" + } + } +} +``` + +ルールやグループと同様に、`"off"` 値でドメインに属するルールを無効にすることもできます： -```ts -// biome-ignore lint: reason -debugger; -// biome-ignore lint/suspicious/noDebugger: reason -debugger; +```json title="biome.json" ins={4} mark="off" +{ + "linter": { + "domains": { + "test": "off" + } + } +} ``` -Biomeはファイル全体を無視するためのコメントを提供していません。 -しかし、[Biomeの設定ファイルでファイルを無視](/ja/guides/configure-biome#ファイルを無視する)できます。 -[VCSで無視されるファイルを無視する](/ja/guides/integrate-in-vcs#無視するファイルを設定する)こともできます。 +各ドメインの詳細については、[適切なページ](/linter/domains)を参照してください。 + +## リントルールを抑制する + +[抑制ページ](/analyzer/suppressions)を参照してください。 + +## エディタとの統合 + +LSP互換エディタとのファーストクラスの統合により、Biomeの動作の特定の側面を設定できます。 + +Biomeによって違反が検出されると、診断が任意の数のコードアクションとともにエディタに送信されます。これらのアクションは診断に対処することを目的としています。 +これらのアクションは： +- 可能なコード修正。このコード修正は、ルールが**コード修正を持つ**場合にのみ表示されます。コード修正は、安全か安全でないかに関係なく表示されます。 +- [インライン抑制](/analyzer/suppressions#inline-suppressions)で診断を抑制します。 +- [トップレベル抑制](/analyzer/suppressions#top-level-suppressions)で診断を抑制します。 + +通常、カーソルを診断の範囲に配置して特定のショートカット（エディタによって異なります）を入力すると、可能なコードアクションを含むツールチップが表示されます。 + +デフォルトでは、これらのアクションは常にエディタによって表示されますが、オプトアウトすることができます。 + +### 保存時にアクションを適用する + +`source.fixAll.biome` コードアクションを使用して、保存時にすべての**安全な修正**を適用するようBiomeに指示します。 + + + + +### エディタの抑制 + +`source.suppressRule.inline.biome` を使用して、エディタがインライン抑制コードアクションを表示するかどうかを制御します： + + + +`source.suppressRule.topLevel.biome` を使用して、エディタがトップレベル抑制コードアクションを表示するかどうかを制御します： + + + ## 他のリンタからの移行 -Biomeの多くのリントルールは他のリンタを参考にしています。 -ESLintや `typescript-eslint` などの他のリンタから移行する場合は、ルールのソース ページを確認してください。 -ESLintから移行する場合は、専用の[移行ガイド](/ja/guides/migrate-eslint-prettier#eslintからの移行)があります。 +Biomeのリントルールの多くは、他のリンタに触発されています。 +ESLintや `typescript-eslint` などの他のリンタから移行する場合は、[ルールソースページ](/linter/rules-sources)を確認してください。 +ESLintから移行する場合は、専用の[移行ガイド](/guides/migrate-eslint-prettier#migrate-from-eslint)があります。 + + + +1. `biome migrate eslint` コマンドを使用して、`eslint` 設定ファイルで定義されたルールを `biome.json` に移植します： + ```shell + biome migrate eslint + ``` +2. 次のコマンドを使用して、Biomeによってキャッチされる可能性のある新しいルールを抑制してプロジェクトをリントします： + ```shell + biome lint --write --unsafe --suppress="suppressed due to migration" + ``` + このコマンドは、Biomeが見つけたすべてのリント違反を、理由 `"suppressed due to migration"` を使用して抑制します。これでリンタはエラーを出さなくなり、後の段階で抑制コメントを削除することができます。 + + + +## リンタグループ + +リンタはルールを_グループ_に分けます。グループは、ルールが属するある種のカテゴリを提供することを目的としています。この情報は、有効/無効にするルールを選択する際や、開発者が新しいリントルールを作成する際に役立ちます。 + +### Accessibility + +アクセシビリティの問題を防ぐことに焦点を当てたルール。 + +### Complexity +単純化できる複雑なコードの検査に焦点を当てたルール。 + +### Correctness +不正確または役に立たないことが保証されているコードを検出するルール。 + +### Nursery +まだ開発中の新しいルール。Nurseryルールは、まだバグやパフォーマンスの問題がある可能性があるため、安定版では設定による明示的なオプトインが必要です（推奨とマークされている場合でも）。ナイトリービルドではデフォルトで有効になっていますが、不安定であるため、最終的に安定化されたときに推奨されることを意図しているかどうかに応じて、診断重大度はエラーまたは警告に設定される場合があります。Nurseryルールは安定すると他のグループに昇格するか、削除される場合があります。このグループに属するルールはセマンティックバージョンの対象ではありません。 + +### Performance +コードをより高速に実行するため、または一般的により効率的にするための方法を検出するルール。 + +### Security +潜在的なセキュリティ上の欠陥を検出するルール。 + +### Style +一貫性のある慣用的なコードの書き方を強制するルール。デフォルトでは、これらのルールはエラーではなく警告のみを生成します。 + +### Suspicious +不正確または役に立たない可能性が高いコードを検出するルール。 ## よくある質問（FAQ） +### なぜルールXは*安全でない*修正を持っているのですか？安全に見えます + +Biomeチームが修正を安全でないとマークすることを決定する理由はさまざまですが、ほとんどの場合、次のことに要約されます： +- リントルールはまだ開発中であり、修正も同様です。 +- ルール修正はプログラムのセマンティクスを変更する可能性があるため、ユーザーが修正をオプトインする必要があります。 +- ルール修正は、入力中や保存中のDXを悪化させる可能性があります。例として `noUnusedVariables` があり、未使用の変数の名前に `_` を追加します。これは、入力中や保存中のプログラマーのDXを悪化させる可能性があります。この動作は[設定](/linter/#configure-the-code-fix)で変更できます。 + +コード修正がこれら3つのガイドラインに従っていない場合、チームがルール修正を安全にすることを忘れた可能性があります。イシューを開くかPRを送信してください！ + ### なぜBiomeリンタはv1と比べて遅いのですか？ -Biome v2以降、スキャナーと呼ばれるツールでアーキテクチャを拡張しました。スキャナーは、プロジェクトのファイルをクロールし、モジュールグラフや推論された型などの重要な情報を作成する役割を担っています。 +Biome v2以降、Scannerと呼ばれるツールでアーキテクチャを拡張しました。Scannerは、プロジェクトファイルをクロールし、モジュールグラフや推論された型などの重要な情報を作成する役割を担っています。 + +このような情報は、`noFloatingPromises`、`noUnresolvedImports`、`noImportCycles` などの一部のルールに**必要**であり、これらのルールはそうでなければ機能しません。一般的に、[projectドメイン](/linter/domains/#project)に属するルールの場合です。 + +Scannerは**オプトイン**であり、[projectドメイン](/linter/domains#project-rules)に属するルールが有効になっている場合にのみトリガーされます。 + +テストに基づいて、おおよそ次の数値に気づきました： +| | Scannerなし | Scannerあり | +|-----------|-----------------|--------------| +| ~2k ファイル | ~800ms | ~2s | +| ~5k ファイル | ~1000ms | ~8s | + +また、**チームはこのパフォーマンスへの影響を認識しており**、ソフトウェアのこの部分のパフォーマンスを改善することを約束していることも言及する価値があります。 + +低速化の調査と緩和に関するアドバイスについては、[低速化の調査ガイド](/guides/investigate-slowness)を参照してください。 + +メモリや時間に関して異常な数値に気づいた場合は、リポジトリへのリンクを含むイシューをファイルしてください。サポートいたします。 + +### なぜBiomeはそんなに多くのメモリを使用しているのですか？ -このような情報は、`noFloatingPromises`、`noUnresolvedImports`、`noImportCycles`などの一部のルールに**必要**であり、これらのルールはこの情報なしでは機能しません。一般的に、[projectドメイン](/linter/domains/#project)に属するルールに必要です。 +Biomeを使用するエディタエクステンションを使用している場合、そのプロセスの1つが大量のメモリを使用する可能性があることに気づくかもしれません。 -スキャナーは**オプトイン**であり、[projectドメイン](/linter/domains#project-rules)に属するルールが有効になっている場合にのみトリガーされます。 +これは通常、[projectドメイン](/linter/domains/#project)に属するルールの1つを有効にした場合に発生します。 -私たちのテストに基づくと、おおよそ以下のような数値が確認されています： -| | スキャナーなし | スキャナーあり | -|-----------|---------------|---------------| -| ~2k ファイル | ~800ms | ~2s | -| ~5k ファイル | ~1000ms | ~8s | +Biome v2以降、ツールチェーンはTypeScriptを使用して型を推論し、より強力なルールを提供できるようになりました。これを実現するために、Biomeは +推移的な依存関係のものを含む `node_modules` フォルダ内の `.d.ts` ファイルをスキャンします。 -また、**チームはこのパフォーマンスへの影響を認識しており**、ソフトウェアのこの部分のパフォーマンス改善に取り組むことを約束しています。 +これは愚かなミスのように見えるかもしれませんが、言語の動作方法により、これは意図的です。ライブラリは +**依存関係から型をエクスポートできます**が、エンドユーザーはそれに依存していない可能性があります。 -パフォーマンス低下の調査と緩和に関するアドバイスについては、[パフォーマンス低下の調査ガイド](/ja/guides/investigate-slowness)を参照してください。 +たとえば、`Validator` 型をエクスポートするライブラリ `@org/foo` に依存している可能性がありますが、 +この `Validator` はライブラリ `@other-org/validator` から来ており、これは *`@org/foo`の依存関係*です。ただし、 +ライブラリ `@other-org/validator` はプロジェクトの直接の依存関係ではありません。 -メモリや時間に関して異常な数値に気づいた場合は、リポジトリへのリンクを含めてIssueを報告してください。私たちがサポートします。 +**チームは制約を認識しており**、時間とリソースをかけてインフラストラクチャの最適化に取り組みます。 diff --git a/src/content/docs/ja/reference/configuration.mdx b/src/content/docs/ja/reference/configuration.mdx index 500dc9a48..145803fe4 100644 --- a/src/content/docs/ja/reference/configuration.mdx +++ b/src/content/docs/ja/reference/configuration.mdx @@ -32,13 +32,22 @@ JSONスキーマファイルへのパスを指定できます。 ## `extends` -他のJSONファイルへのパスのリストです。Biomeは `extends` リストに含まれるファイルのオプションを解決して適用し、最終的に `biome.json` ファイルに含まれるオプションを適用します。 +他のBiome設定ファイルへのパスのリストです。Biomeは `extends` リストに含まれるファイルの設定を解決して適用し、 +最終的に `biome.json`/`biome.jsonc` ファイルに含まれるオプションを適用します。 -```json title="biome.json" -{ - "extends": ["./biome.base.json"] -} -``` +拡張するパスの順序は、関連性の低いものから高いものへと進みます。 + +v2以降、このオプションは値 `"//"` に一致する必要がある文字列を受け入れます。これは[モノレポ](/guides/big-projects#monorepo)を設定する際に使用できます。 + + +## `root` + +この設定をルートとして扱うかどうかを指定します。デフォルトでは、すべての設定ファイルはデフォルトでルートと見なされます。 +設定ファイルが「ネストされた設定」である場合、`"root": false` を設定する必要があります。そうしないとエラーがスローされます。 + +これは、BiomeがCLIとエディタで同時に複数のファイルを調整できるようにするために必要です。 + +> デフォルト: `true` ## `files` @@ -73,22 +82,48 @@ Biomeは、これらのパターンに一致するファイルやフォルダの 3. しかし、 `special.test.js` は処理対象に戻す。 4. ただし、`test` という名前のフォルダ内にある場合は処理しない。 +:::note +`!test` を使用してディレクトリを完全に除外することは `files.includes` でのみサポートされています。`includes` を使用する他の場所（`linter.includes`、`formatter.includes` など）では、ディレクトリを除外するために `!/test/**` を使用する必要があります。 +::: + つまり、結果は以下の通りです。 + * `src/app.js` は処理対象 * `src/app.test.js` は処理対象**外** * `src/special.test.js` は処理対象 * `test/special.test.js` は処理対象**外** -#### Biome のスキャナーについて +`node_modules/` 内のファイルは、`files.includes` 設定に関係なく無視されることに注意してください。 -Biomeにはスキャナーがあり、ネストされた `.gitignore` ファイルを検出したり、プロジェクトドメインのルールが有効な場合はプロジェクトをインデックス化します。 -スキャナーは `files.includes` の設定を尊重しますが、いくつか注意点があります。詳細は [スキャナーのドキュメント](/internals/architecture/#scanner) を参照してください。 +#### スキャナーとの相互作用 -### `files.ignoreUnknown` +Biomeには[スキャナー](/internals/architecture/#scanner)があり、ネストされた設定ファイルや `.gitignore` ファイルを検出します。また、 +[プロジェクトドメイン](/linter/domains/#project)の1つ以上のルールが有効になっている場合、ソースファイルをインデックス化することもできます。 -Biomeは、処理できないファイルに遭遇した場合、診断情報を出力しません。 +スキャナーは `files.includes` と `.gitignore` ファイルからの無視パターンの両方を尊重しますが、注意すべき2つの例外があります： +* `biome.json` や `.gitignore` などの特殊ファイルは、`files.includes` の無視パターンよりも優先されます。 +* プロジェクトドメインのルールが有効な場合、スキャナーはソースファイルとそのソースファイルの**依存関係をインデックス化**します。これは、`files.includes` の一部として無視されるファイルでも、それらのファイルをインポートする他の含まれるファイルがある限り、スキャナーによってインデックス化される可能性があることを意味します。また、これは `node_modules/` 内の `.d.ts` ファイルや `package.json` マニフェストもインデックス化される可能性があることを意味します。 +スキャナーによって明示的に無視するファイルを強制したい場合は、 +いわゆる _force-ignore パターン_ を使用できます。force-ignoreパターンは通常のnegatedパターンのように見えますが、二重の感嘆符 (`!!`) で始まります。 +例えば、次の設定を使用して、Biomeに任意の `dist/` フォルダ内を決して見ないように指示できます： + +```json title="biome.json" +{ + "files": { + "includes": ["**", "!!**/dist"] + } +} +``` + +`build/` や `dist/` などの _出力_ ファイルを含むフォルダには、force-ignore構文を使用することをお勧めします。このようなフォルダの場合、インデックス化が有用な利点を持つ可能性は極めて低いです。生成されたファイルを含むフォルダの場合、通常の無視パターンを使用することをお勧めします。これにより、ファイルから型情報を抽出できます。 + +明示的に無視したいネストされた `biome.json` ファイルや `.gitignore` ファイルについても、force-ignore構文を使用する必要があります。 + +### `files.ignoreUnknown` + +`true` の場合、Biomeは処理できないファイルに遭遇しても診断を出力しません。 ```json title="biome.json" { @@ -100,6 +135,21 @@ Biomeは、処理できないファイルに遭遇した場合、診断情報を > デフォルト: `false` +### `files.maxSize` + +ソースコードファイルの最大許容サイズ（バイト単位）です。この制限を超えるファイルは、パフォーマンス上の理由から無視されます。 + +> デフォルト: `1048576`（1024*1024、1MB） + +### `files.experimentalScannerIgnores` + +:::caution +このオプションは**非推奨**となり、将来のリリースで削除される可能性があります。 +代わりに `files.includes` で [_force-ignore 構文_](/reference/configuration/#interaction-with-the-scanner) を使用してください。 +::: + +スキャナーがクロール中に無視すべきリテラルパスセグメントの配列です。無視されたファイルはインデックス化されません。つまり、これらのファイルはモジュールグラフの一部にならず、それらから型が推論されません。 + ## `vcs` BiomeをVCS（バージョン管理システム）ソフトウェアと統合するためのプロパティのセットです。 @@ -139,53 +189,69 @@ Biomeのリンタを有効にします。 > デフォルト: `true` -### `linter.ignore` - -Biomeのリンタは、パターンに一致するファイルやフォルダを無視します。 -Unixシェル形式のパターンのリストで指定します。 +### `linter.includes` +リントするファイルの[globパターン](#glob-syntax-reference)のリストです。 +次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルをリントします： ```json title="biome.json" { "linter": { - "ignore": ["scripts/*.js"] + "includes": ["src/**/*.js"] } } ``` +`*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 +[glob構文リファレンス](#glob-syntax-reference)を参照してください。 -### `linter.include` - -Biomeのリンタは、これらのパターンに一致するファイルやフォルダのみを処理します。 -Unixシェル形式のパターンのリストで指定します。 +`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 +例外は順番に処理されるため、例外の例外を指定できます。 +次の例を考えてみましょう： ```json title="biome.json" { "linter": { - "include": ["scripts/*.js"] + "includes": ["**", "!**/*.test.js", "**/special.test.js"] } } ``` -:::caution -`include` と `ignore` の両方が指定されている場合、`ignore` が `include` よりも**優先**されます。 -::: +この例は次のことを指定しています： -例えば、下記のような指定を考えます。 +1. `**` パターンのおかげで、すべての（サブ）フォルダ内のすべてのファイルがリントされます。.. +2. ... ただし、それらのファイルが `.test.js` 拡張子を持つ場合は除きます。.. +3. ... しかし、ファイル `special.test.ts` は _まだ_ リントされます。 -```json title="biome.json" +つまり： + +* `src/app.js` は**リントされます**。 +* `src/app.test.js` は**リントされません**。 +* `src/special.test.js` は**リントされます**。 + +`linter.includes` は `files.includes` の _後に_ 適用されることに注意してください。これは、`files.includes` に一致しないファイルは、もはや `linter.includes` に一致できないことを意味します。これは、次の例が**機能しない**ことを意味します： + +```json5 title="biome.jsonc" { + "files": { + "includes": "src/**" + }, "linter": { - "include": ["scripts/**/*.js", "src/**/*.js"], - "ignore": ["scripts/**/*.js"] + // これは files.includes と重複がないため何も一致しません： + "includes": "scripts/**" } } ``` -パターン `src/**/*.js` に一致するファイルのみが処理され、パターン `scripts/**/*.js` に一致するファイルは無視されます。 +`linter.includes` が指定されていない場合、[`files.includes`](#filesincludes) に一致するすべてのファイルがリントされます。 + +:::note +技術的な制限により、`linter.includes` は `files.includes` がフォルダに一致できるのに対して、フォルダに一致できません。フォルダ内のすべてのファイルに一致させたい場合は、 +明示的に最後に `/**` を追加する必要があります。 +::: ### `linter.rules.recommended` @@ -253,6 +319,108 @@ Unixシェル形式のパターンのリストで指定します。 } ``` +## `assist` + +### `assist.enabled` + +Biomeのアシスト機能を有効にします。 + +> デフォルト: `true` + + +### `assist.includes` + +解析するファイルの[globパターン](#glob-syntax-reference)のリストです。 + +次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルを解析します： + +```json title="biome.json" +{ + "assist": { + "includes": ["src/**/*.js"] + } +} +``` + +`*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 +[glob構文リファレンス](#glob-syntax-reference)を参照してください。 + +`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 + +例外は順番に処理されるため、例外の例外を指定できます。 + +次の例を考えてみましょう： + +```json title="biome.json" +{ + "assist": { + "includes": ["**", "!**/*.test.js", "**/special.test.js"] + } +} +``` + +この例は次のことを指定しています： + +1. `**` パターンのおかげで、すべての（サブ）フォルダ内のすべてのファイルが解析されます。.. +2. ... ただし、それらのファイルが `.test.js` 拡張子を持つ場合は除きます。.. +3. ... しかし、ファイル `special.test.ts` は _まだ_ 解析されます。 + +つまり： + +* `src/app.js` は**解析されます**。 +* `src/app.test.js` は**解析されません**。 +* `src/special.test.js` は**解析されます**。 + +`assist.includes` は `files.includes` の _後に_ 適用されることに注意してください。これは、`files.includes` に一致しないファイルは、もはや `assist.includes` に一致できないことを意味します。これは、次の例が**機能しない**ことを意味します： + +```json5 title="biome.jsonc" +{ + "files": { + "includes": "src/**" + }, + "assist": { + // これは files.includes と重複がないため何も一致しません： + "includes": "scripts/**" + } +} +``` + +`assist.includes` が指定されていない場合、[`files.includes`](#filesincludes) に一致するすべてのファイルがリントされます。 + +:::note +技術的な制限により、`assist.includes` は `files.includes` がフォルダに一致できるのに対して、フォルダに一致できません。フォルダ内のすべてのファイルに一致させたい場合は、 +明示的に最後に `/**` を追加する必要があります。 +::: + +### `assist.actions.recommended` + +すべてのグループの推奨アクションを有効にします。 + +### `assist.actions.[group]` + +単一グループのルールに影響を与えるオプションです。Biomeは次のグループをサポートしています： + +- source: このグループは、保存時にドキュメントに安全に適用できるアクションを表します。これらのアクションは一般的にすべて安全で、通常はプログラムの機能を変更しません。 + +### `assist.actions.[group].recommended` + +単一グループの推奨ルールを有効にします。 + +例： + +```json title="biome.json" +{ + "assist": { + "enabled": true, + "actions": { + "source": { + "recommended": true + } + } + } +} +``` + ## `formatter` これらのオプションはすべての言語に適用されます。 @@ -264,50 +432,69 @@ Biomeのフォーマッタを有効にします。 > デフォルト: `true` -### `formatter.ignore` +### `formatter.includes` -Biomeのフォーマッタは、パターンに一致するファイルやフォルダを無視します。 -Unixシェル形式のパターンのリストで指定します。 +フォーマットするファイルの[globパターン](#glob-syntax-reference)のリストです。 +次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルをフォーマットします： ```json title="biome.json" { "formatter": { - "ignore": ["scripts/*.js"] + "includes": ["src/**/*.js"] } } ``` -### `formatter.include` +`*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 +[glob構文リファレンス](#glob-syntax-reference)を参照してください。 -Biomeのフォーマッタは、これらのパターンに一致するファイルやフォルダのみを処理します。 -Unixシェル形式のパターンのリストで指定します。 +`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 +例外は順番に処理されるため、例外の例外を指定できます。 + +次の例を考えてみましょう： ```json title="biome.json" { "formatter": { - "include": ["scripts/*.js"] + "includes": ["**", "!**/*.test.js", "**/special.test.js"] } } ``` -:::caution -`include` と `ignore` の両方が指定されている場合、`ignore` が `include` よりも**優先**されます。 -::: +この例は次のことを指定しています： -例えば、下記のような指定を考えます。 +1. `**` パターンのおかげで、すべての（サブ）フォルダ内のすべてのファイルがフォーマットされます。.. +2. ... ただし、それらのファイルが `.test.js` 拡張子を持つ場合は除きます。.. +3. ... しかし、ファイル `special.test.ts` は _まだ_ フォーマットされます。 -```json title="biome.json" +つまり： + +* `src/app.js` は**フォーマットされます**。 +* `src/app.test.js` は**フォーマットされません**。 +* `src/special.test.js` は**フォーマットされます**。 + +`formatter.includes` は `files.includes` の _後に_ 適用されることに注意してください。これは、`files.includes` に一致しないファイルは、もはや `formatter.includes` に一致できないことを意味します。これは、次の例が**機能しない**ことを意味します： + +```json5 title="biome.jsonc" { + "files": { + "includes": "src/**" + }, "formatter": { - "include": ["scripts/**/*.js", "src/**/*.js"], - "ignore": ["scripts/**/*.js"] + // これは files.includes と重複がないため何も一致しません： + "includes": "scripts/**" } } ``` -パターン `src/**/*.js` に一致するファイルのみが処理され、パターン `scripts/**/*.js` に一致するファイルは無視されます。 +`formatter.includes` が指定されていない場合、[`files.includes`](#filesincludes) に一致するすべてのファイルがフォーマットされます。 + +:::note +技術的な制限により、`formatter.includes` は `files.includes` がフォルダに一致できるのに対して、フォルダに一致できません。フォルダ内のすべてのファイルに一致させたい場合は、 +明示的に最後に `/**` を追加する必要があります。 +::: ### `formatter.formatWithErrors` @@ -334,23 +521,14 @@ Unixシェル形式のパターンのリストで指定します。 > デフォルト: `"tab"` -### `formatter.indentSize` - -このオプションは廃止されました。代わりに [`formatter.indentWidth`](#formatterindentwidth) を使用してください。 - -
- 廃止されました - - インデントのサイズを指定します。 - - > デフォルト: `2` - -
- ### `formatter.indentWidth` インデントのサイズを指定します。 +:::note +このプロパティは、`indentStyle` が `tab` に設定されている場合は無視されます。 +::: + > デフォルト: `2` ### `formatter.lineEnding` @@ -364,16 +542,15 @@ Unixシェル形式のパターンのリストで指定します。 ### `formatter.lineWidth` -行の文字数を指定します。 +1行に書き込むことができる文字数を指定します。 > デフォルト: `80` ### `formatter.attributePosition` -HTML言語（あるいはHTMLベースの言語）における属性の位置スタイルを指定します。 - -- `"auto"`: 属性は自動的にフォーマットされ、特定の基準に達したときのみ複数行に折り返されます。 -- `"multiline"`: 属性は常に複数行でフォーマットされます。 +HTML系言語の属性位置スタイルを指定します。 +- `"auto"`、属性は自動的にフォーマットされ、特定の基準に達したときのみ複数行に折り返されます。 +- `"multiline"`、属性が2つ以上使用されている場合、複数行に折り返されます。 > デフォルト: `"auto"` @@ -385,24 +562,44 @@ HTML言語（あるいはHTMLベースの言語）における属性の位置ス ### `formatter.expand` -配列とオブジェクトのリテラルを複数行に展開するかどうかを指定します。 -- `"auto"`: オブジェクトリテラルは最初のプロパティに改行があれば複数行にフォーマットされ、配列リテラルは行に収まる場合は単一行にフォーマットされます。 -- `"always"`: これらのリテラルは長さを問わず複数行にフォーマットされます。 -- `"never"`: これらのリテラルは行に収まる場合は単一行にフォーマットされます。 +配列とオブジェクトを複数行に展開するかどうかを指定します。 +- `"auto"`、オブジェクトリテラルは最初のプロパティに改行がある場合は複数行にフォーマットされ、 + 配列リテラルは行に収まる場合は単一行にフォーマットされます。 +- `"always"`、これらのリテラルはリストの長さに関係なく複数行にフォーマットされます。 +- `"never"`、これらのリテラルは行に収まる場合は単一行にフォーマットされます。 `package.json` をフォーマットする場合、別途設定されない限りBiomeは `always` を使います。 > デフォルト: `"auto"` +### `formatter.trailingNewline` + +ファイルの末尾に改行を追加するかどうかを指定します。 + +> デフォルト: true + +:::danger +このオプションを `false` に設定することは**非常に推奨されません**。他のツールとの多くの問題を引き起こす可能性があるためです： +- https://thoughtbot.com/blog/no-newline-at-end-of-file +- https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804 +- https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files + +末尾の改行を無効にする場合は、自己責任で行ってください。 +::: + ### `formatter.useEditorconfig` -フォーマットのオプションを導出するために `.editorconfig` ファイルを利用するかを指定します。 -`true` の場合、`.editorconfig` ファイルの中の適用可能なオプションが利用されますが、`biome.json` ファイルの設定が優先されます。 +Biomeが `.editorconfig` ファイルを使用してフォーマットオプションを決定するかどうかを指定します。 + +設定ファイル `.editorconfig` と `biome.json` は次のルールに従います： -`biome migrate` でPrettierから移行する場合、このオプションはPrettierの動作と一致させるため `true` に設定されます。 +- `biome.json` のフォーマット設定は常に `.editorconfig` ファイルより優先されます。 +- `biome.json` ファイルよりも階層の上位に存在する `.editorconfig` ファイルは既に無視されます。これは、誰かのホームディレクトリからフォーマット設定を `biome.json` ファイルを持つプロジェクトにロードすることを避けるためです。 +- ネストされた `.editorconfig` ファイルは現在サポートされていません。 > デフォルト: `false` + ## `organizeImports` ### `organizeImports.enabled` @@ -700,6 +897,21 @@ JavaScript（およびその拡張言語）ファイル用のBiomeアシスト } ``` + +### `javascript.experimentalEmbeddedSnippetsEnabled` + +JavaScript（およびその拡張言語）ファイル内の埋め込み言語スニペットのパースとフォーマットを有効にします。 + +> デフォルト: `false` + +```json title=biome.json +{ + "javascript": { + "experimentalEmbeddedSnippetsEnabled": true + } +} +``` + ## `json` JSONファイルに適用されるオプションです。 @@ -848,6 +1060,14 @@ CSSファイルに適用されるオプションです。 > デフォルト: `false` +### `css.parser.tailwindDirectives` + +
tailwindDirectives, tailwind, tailwind directives, tailwind syntax
+ +[Tailwind](https://tailwindcss.com) 固有の構文（`@theme`、`@utility`、`@apply` など）の解析を有効にします。 + +> デフォルト: `false` + ### `css.formatter.enabled` CSSファイル用のBiomeのフォーマッタを有効にします。 @@ -898,11 +1118,27 @@ CSSファイルの行の文字数を指定します。 > デフォルト: `"double"` +### `css.formatter.trailingNewline` + +ファイルの末尾に改行を追加するかどうかを指定します。 + +> デフォルト: true + +:::danger +このオプションを `false` に設定することは**非常に推奨されません**。他のツールとの多くの問題を引き起こす可能性があるためです： +- https://thoughtbot.com/blog/no-newline-at-end-of-file +- https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804 +- https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files + +末尾の改行を無効にする場合は、自己責任で行ってください。 +::: + + ### `css.linter.enabled` CSSファイル用のBiomeのリンタを有効にします。 -> デフォルト: `false` +> デフォルト: `true` ```json title="biome.json" { @@ -913,12 +1149,11 @@ CSSファイル用のBiomeのリンタを有効にします。 } } ``` - ### `css.assist.enabled` CSSファイル用のBiomeのアシストを有効にします。 -> デフォルト: `false` +> デフォルト: `true` ```json title="biome.json" { @@ -973,17 +1208,32 @@ GraphQLファイルの行の文字数を指定します。 > デフォルト: `"double"` +### `graphql.formatter.trailingNewline` + +ファイルの末尾に改行を追加するかどうかを指定します。 + +> デフォルト: true + +:::danger +このオプションを `false` に設定することは**非常に推奨されません**。他のツールとの多くの問題を引き起こす可能性があるためです： +- https://thoughtbot.com/blog/no-newline-at-end-of-file +- https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804 +- https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files + +末尾の改行を無効にする場合は、自己責任で行ってください。 +::: + ### `graphql.linter.enabled` GraphQLファイル用のBiomeのリンタを有効にします。 -> デフォルト: `false` +> デフォルト: `true` ### `graphql.assist.enabled` GraphQLファイル用のBiomeのアシストを有効にします。 -> デフォルト: `false` +> デフォルト: `true` ## `grit` @@ -1028,47 +1278,225 @@ Gritファイルの行の文字数を指定します。 > デフォルト: `"double"` +### `grit.formatter.trailingNewline` + +ファイルの末尾に改行を追加するかどうかを指定します。 + +> デフォルト: true + +:::danger +このオプションを `false` に設定することは**非常に推奨されません**。他のツールとの多くの問題を引き起こす可能性があるためです： +- https://thoughtbot.com/blog/no-newline-at-end-of-file +- https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804 +- https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files + +末尾の改行を無効にする場合は、自己責任で行ってください。 +::: + ### `grit.linter.enabled` Gritファイル用のBiomeのリンタを有効にします。 -> デフォルト: `false` +> デフォルト: `true` + +```json title="biome.json" +{ + "grit": { + "linter": { + "enabled": false + } + } +} +``` ### `grit.assist.enabled` Gritファイル用のBiomeのアシストを有効にします。 +> デフォルト: `true` + +```json title="biome.json" +{ + "grit": { + "assist": { + "enabled": false + } + } +} +``` + +## `html` + +:::caution +HTMLフォーマッタは実験的であるため、**デフォルトで無効**になっています。 +破壊的な変更は最小限に抑えられますが、修正や機能の導入によってツールの動作が変わる可能性があります。 +::: + +### `html.experimentalFullSupportEnabled` + +有効にすると、BiomeはHTML系言語（Vue、Svelte、Astroファイル）の完全サポートを有効にします。これらのファイル内の埋め込み言語のパース、フォーマット、リントは一貫しています。 + +無効にすると、BiomeはこれらのファイルのJavaScript/TypeScript部分のみを解析用に抽出し、残りのコンテンツは無視します。 + +:::note +このオプションを有効にしても、これらのファイルに対してこの動作を切り替えるだけで、プレーンな `.html` ファイルには影響しません。HTMLファイルをフォーマットするには、 +`html.formatter.enabled` も有効にする必要があります。 +::: + +### `html.parser.interpolation` + +`.html` ファイル内の `{{ expression }}` のような二重テキスト式のパースを有効にします。 + > デフォルト: `false` -## `overrides` +### `html.formatter.enabled` -パターンのリストです。 -この設定を使用して、特定のファイルに対するツールの動作を変更します。 -ファイルがオーバーライドパターンに一致すると、そのパターンに指定された設定がトップレベルの設定を上書きします。 -パターンの順序は重要です。ファイルが3つのパターンに一致する場合、最初のパターンのみが使用されます。 +HTMLファイル用のBiomeのフォーマッタを有効にします。 + +> デフォルト: `false` -### `overrides..ignore` +:::note +これは、HTMLフォーマッタが実験的でなくなったときにデフォルトで有効になります。 +::: -Unixシェル形式のパターンのリストです。Biomeは、これらのパターンに一致するファイルに対してオーバーライドを適用しません。 +### `html.formatter.indentStyle` +HTMLファイルのインデントスタイルです。 `"tab"` または `"space"` のいずれかを指定できます。 -```json title="biome.json" -{ - "overrides": [{ - "ignore": ["scripts/*.js"] - }] -} +> デフォルト: `"tab"` + +### `html.formatter.indentWidth` + +HTMLファイルのインデントサイズを指定します。 + +> デフォルト: `2` + +### `html.formatter.lineEnding` + +HTMLファイルの改行コードの種類を指定します。 +- `"lf"`: Line Feedのみ (`\n`)、LinuxやmacOS、またはgitリポジトリ内で一般的です。 +- `"crlf"`: Carriage Return + Line Feed文字 (`\r\n`)、Windowsで一般的です。 +- `"cr"`: Carriage Return文字のみ (`\r`)、非常にまれに使用されます。 + +> デフォルト: `"lf"` + +### `html.formatter.lineWidth` + +HTMLファイルの行の文字数を指定します。 + +> デフォルト: `80` + +### `html.formatter.attributePosition` + +HTML要素の属性位置スタイルを指定します。 +- `"auto"`、属性は自動的にフォーマットされ、特定の基準に達したときのみ複数行に折り返されます。 +- `"multiline"`、属性が2つ以上使用されている場合、複数行に折り返されます。 + +> デフォルト: `"auto"` + +### `html.formatter.bracketSameLine` + +複数行のHTMLタグの閉じ括弧を、最後の行の末尾に配置するか、次の行に単独で配置するかを指定します。 + +> デフォルト: `false` + +### `html.formatter.whitespaceSensitivity` + +
whitespaceSensitivity, whitespace sensitivity
+ +HTML（およびその拡張言語）をフォーマットする際に、空白の重要性を考慮するかどうかを指定します。 + +> デフォルト: "css" + + +- `"css"`: フォーマッタは、ブラウザのユーザーエージェントスタイルシートでデフォルトで "inline" 表示スタイルを持つ要素の空白を重要と見なします。 +- `"strict"`: コンテンツ内の先頭と末尾の空白は、すべての要素にとって重要と見なされます。 + + 空白が存在する場合、フォーマッタは少なくとも1つの空白文字を残す必要があります。 + そうでない場合、空白がない場合は、`>` の後や `<` の前に空白を追加しないでください。つまり、空白がない場合、テキストコンテンツはタグに密着する必要があります。 + + タグに密着するテキストの例： + ```html + content + ``` +- `"ignore"`: 空白は重要ではないと見なされます。フォーマッタは適切と判断したときに空白を削除または追加できます。 + +### `html.formatter.indentScriptAndStyle` + +
indentScriptAndStyle, indent script, indent style
+ +*2.3以降：`.vue` および `.svelte` ファイルにのみ影響します* + +VueおよびSvelteファイルの ` ``` -### `overrides..include` +### `html.formatter.selfCloseVoidElements` -Unixシェル形式のパターンのリストです。Biomeは、これらのパターンに一致するファイルにのみオーバーライドを適用します。 +
selfCloseVoidElements, void elements, self closing elements
+void要素を自己閉じタグにするかどうかを指定します。デフォルトはneverです。 -```json title="biome.json" +> デフォルト: `"never"` + +- `"never"`: void要素内のスラッシュ `/` はフォーマッタによって削除されます。 +- `"always"`: void要素内のスラッシュ `/` は常に追加されます。 + +### `html.formatter.trailingNewline` + +ファイルの末尾に改行を追加するかどうかを指定します。 + +> デフォルト: true + +:::danger +このオプションを `false` に設定することは**非常に推奨されません**。他のツールとの多くの問題を引き起こす可能性があるためです： +- https://thoughtbot.com/blog/no-newline-at-end-of-file +- https://callmeryan.medium.com/no-newline-at-end-of-file-navigating-gits-warning-for-android-developers-af14e73dd804 +- https://unix.stackexchange.com/questions/345548/how-to-cat-files-together-adding-missing-newlines-at-end-of-some-files + +末尾の改行を無効にする場合は、自己責任で行ってください。 +::: + +### `html.linter.enabled` + +HTMLファイル用のBiomeのリンタを有効にします。 + +> デフォルト: `true` + +### `html.assist.enabled` + +HTMLファイル用のBiomeのアシストを有効にします。 + +> デフォルト: `true` + + +## `overrides` + +パターンのリストです。 +この設定を使用して、特定のファイルに対するツールの動作を変更します。 +ファイルがオーバーライドパターンに一致すると、そのパターンに指定された設定がトップレベルの設定を上書きします。 +パターンの順序は重要です。ファイルが3つのパターンに一致する場合、最初のパターンのみが使用されます。 + +### `overrides..includes` + +カスタマイズされた設定を適用するファイルの[globパターン](https://en.wikipedia.org/wiki/Glob_(programming))のリストです。 + +```jsonc title="biome.jsonc" { "overrides": [{ - "include": ["scripts/*.js"] + "includes": ["scripts/*.js"], + // includes フィールドで指定されたファイルにのみ適用される設定 }] } ``` @@ -1138,9 +1566,9 @@ Unixシェル形式のパターンのリストです。Biomeは、これらの } ``` -### `overrides..organizeImports` +### `overrides..[language]` -`ignore` と `include` を除いた、[上位のorganizeImports](#organizeimports) 設定のオプションが含まれます。 +トップレベルの言語設定のオプションが含まれます。特定のファイルに対して言語固有の設定を上書きできます。 ### `overrides..javascript` @@ -1198,7 +1626,7 @@ Unixシェル形式のパターンのリストです。Biomeは、これらの }, "overrides": [ { - "include": [".vscode/**"], + "includes": [".vscode/**"], "json": { "parser": { "allowComments": true, @@ -1209,3 +1637,36 @@ Unixシェル形式のパターンのリストです。Biomeは、これらの ] } ``` + +## Glob構文リファレンス + +Globパターンは、ファイルとフォルダのパスを一致させるために使用されます。Biomeは +globで次の構文をサポートしています： + +- `*` はゼロ個以上の文字に一致します。パスセパレータ `/` には一致できません。 +- `**` はディレクトリとファイルを再帰的に一致させます。このシーケンスは + パスコンポーネント全体として使用する必要があるため、`**a` と `b**` の両方が無効でエラーになります。連続する2つ以上の `*` 文字のシーケンスも + 無効です。 +- `[...]` は括弧内の任意の文字に一致します。 + 文字の範囲も指定できます。Unicodeで順序付けられているため、例えば + `[0-9]` は0から9までの任意の文字を指定します。 +- `[!...]` は `[...]` の否定、つまり括弧内に**ない**任意の文字に一致します。 +- glob全体が `!` で始まる場合、いわゆるnegatedパターンです。この + globは、パスがglobに一致_しない_場合にのみ一致します。Negatedパターンは + 単独では使用できず、通常のglobの_例外_としてのみ使用できます。 +- ファイルが含まれるかどうかを判断する際、Biomeは親フォルダも考慮します。これは、フォルダ内のすべてのファイルを_含める_場合、 + これらのファイルに一致するように `/**` サフィックスを使用する必要があることを意味します。ただし、フォルダ内のすべてのファイルを_無視_する場合は、`/**` サフィックスなしで実行できます。不必要にフォルダをトラバースすることを避けるため、また無視されたフォルダから `biome.json` または + `.gitignore` ファイルをBiomeが読み込むリスクを避けるために、末尾の `/**` なしでフォルダを無視することをお勧めします。 + +いくつかの例： + +- `dist/**` は `dist/` フォルダとその中のすべてのファイルに一致します。 +- `!dist` は `dist/` フォルダとその中のすべてのファイルを無視します。 +- `**/test/**` は `test` という名前のフォルダの下のすべてのファイルに一致します。どこにあっても。例：`dist/test`、`src/test`。 +- `**/*.js` はすべてのフォルダ内の `.js` 拡張子で終わるすべてのファイルに一致します。 + +:::caution +Globパターンは、Biome設定ファイルで使用できますが、コマンドラインから指定することもできます。コマンドラインでglobを指定すると、 +Biomeではなくシェルによって解釈されます。シェルは、globに対して若干異なる構文をサポートしている場合があります。たとえば、一部のシェルは +再帰的パターン `**` をサポートしていません。 +::: From 9e1f0425616624767c4be586ad6be676f220d02a Mon Sep 17 00:00:00 2001 From: Naoki Ikeguchi Date: Tue, 17 Feb 2026 00:28:22 +0900 Subject: [PATCH 2/5] feat(ja): revise translations --- src/content/docs/assist/index.mdx | 2 +- src/content/docs/guides/configure-biome.mdx | 2 +- .../docs/internals/language-support.mdx | 36 ++--------- src/content/docs/ja/assist/index.mdx | 8 +-- src/content/docs/ja/formatter/index.mdx | 12 ++-- .../docs/ja/guides/configure-biome.mdx | 29 +++++---- .../docs/ja/internals/language-support.mdx | 63 ++++++------------- src/content/docs/ja/linter/index.mdx | 62 +++++++++--------- .../docs/ja/reference/configuration.mdx | 22 +++---- src/content/docs/linter/index.mdx | 12 +++- 10 files changed, 105 insertions(+), 143 deletions(-) diff --git a/src/content/docs/assist/index.mdx b/src/content/docs/assist/index.mdx index 9b43cde3a..0edc25f71 100644 --- a/src/content/docs/assist/index.mdx +++ b/src/content/docs/assist/index.mdx @@ -38,7 +38,7 @@ First, you need to setup your editor for apply all fixes on save. The configurat -Then, you can add the code of each action. For example, the action [`useSortedKeys`](/assist/actions/use-sorted-keys) has a code action called `source.action.useSortedKeys.biome`. If you use VSCode, you can copy this code and place it in the `editor.codeActionsOnSave` section, and Biome will apply it when you save a document: +Then, you can add the code of each action. For example, the action [`useSortedKeys`](/assist/actions/use-sorted-keys) has a code action called `source.action.useSortedKeys.biome`. If you use VS Code, you can copy this code and place it in the `editor.codeActionsOnSave` section, and Biome will apply it when you save a document: diff --git a/src/content/docs/guides/configure-biome.mdx b/src/content/docs/guides/configure-biome.mdx index b7e05cdc9..5741c879a 100644 --- a/src/content/docs/guides/configure-biome.mdx +++ b/src/content/docs/guides/configure-biome.mdx @@ -305,6 +305,6 @@ The following files are parsed as `JSON` files with the options `json.parser.all - `tsconfig.json` - `typedoc.json` - `typescript.json` -- All `.json` files under the `$PROJECT/.vscode/*` folder and under the [user VSCode settings folder](https://code.visualstudio.com/docs/configure/settings#_user-settingsjson-location) +- All `.json` files under the `$PROJECT/.vscode/*` folder and under the [user VS Code settings folder](https://code.visualstudio.com/docs/configure/settings#_user-settingsjson-location) - All `.json` files under the `$PROJECT/.zed/*` folder and under the [user Zed settings folder](https://zed.dev/docs/configuring-zed#user-settings-file) - All `.json` files under the `$PROJECT/.cursor/*` folder and under the user Cursor settings folder diff --git a/src/content/docs/internals/language-support.mdx b/src/content/docs/internals/language-support.mdx index cc5170894..50935f3ff 100644 --- a/src/content/docs/internals/language-support.mdx +++ b/src/content/docs/internals/language-support.mdx @@ -18,9 +18,9 @@ Legend: | JSON | ✅ | ✅ | ✅ | ✅ | | JSONC | ✅ | ✅ | ✅ | ✅ | | HTML* | ✅ | ✅ | ✅ | ✅ | -| [Vue](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | -| [Svelte](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | -| [Astro](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | +| Vue | 🟡 | 🟡 | 🟡 | 🟡 | +| Svelte | 🟡 | 🟡 | 🟡 | 🟡 | +| Astro | 🟡 | 🟡 | 🟡 | 🟡 | | CSS | ✅️ | ✅️ | ✅️ | ✅ | | SCSS | ⌛️ | ⌛️ | 🚫 | 🚫 | | [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | ⌛️ | 🚫 | 🚫 | @@ -28,7 +28,7 @@ Legend: | [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | ⌛️ | 🚫 | 🚫 | | GritQL | ✅️ | ✅️ | 🚫 | 🚫 | -*\* currently requires [explicit opt-in](https://biomejs.dev/reference/configuration/#html)* +*\* currently requires [explicit opt-in](/reference/configuration/#html)* ## JavaScript support @@ -56,7 +56,7 @@ This feature is still experimental and disabled by default. To enable this featu ## TypeScript support -Biome supports TypeScript version 5.6. +Biome supports TypeScript version 5.9. ## JSONC support @@ -82,32 +82,6 @@ In particular, as for `v2.3.0`, Biome doesn't do any particular parsing for lang Lint rules that work across embedded languages aren't supported yet. -### Linting HTML-ish languages - -If you **lint** `.svelte`, `.astro` or `.vue` files and `html.experimentalFullSupportEnabled` is `false`, it's advised to turn off a few additional rules to prevent false positive linting errors caused by our partial support. Use the option `overrides` for that: - -```json title=biome.json -{ - "overrides": [ - { - "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], - "linter": { - "rules": { - "style": { - "useConst": "off", - "useImportType": "off" - }, - "correctness": { - "noUnusedVariables": "off", - "noUnusedImports": "off" - } - } - } - } - ] -} -``` - ### Formatting with different settings With Biome, you can control the formatting of different languages. Now that Biome can process multiple languages in the same file, diff --git a/src/content/docs/ja/assist/index.mdx b/src/content/docs/ja/assist/index.mdx index d8f64e197..d6e950a8c 100644 --- a/src/content/docs/ja/assist/index.mdx +++ b/src/content/docs/ja/assist/index.mdx @@ -13,7 +13,7 @@ Biome Assistはコード品質と開発者体験を向上させるための一 アシストのコード修正は一般的に安全に適用できます。もしアシストの修正がコードを壊した場合、それはバグと見なされますので、バグ報告をお願いします。 -アシストはエディタやIDEで最も効果を発揮します。ただし、CLIでもアシストアクションの使用を強制することが可能です。アシストアクションはセマンティクスにおいて[LSPコードアクション](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#codeActionKind)に非常に近く、[グループ](#groups)に分けられています。 +アシストはエディタやIDEで最も効果を発揮します。ただし、CLIでもアシストアクションの使用を強制することが可能です。アシストアクションはセマンティクスにおいて[LSPコードアクション](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#codeActionKind)に非常に近く、[グループ](#グループ)に分けられています。 Biomeのアシストはデフォルトで有効になっており、いくつかのルールは推奨ルールセットに含まれています。以下の例は `useSortedKeys` アクションを有効にする方法を示しています： @@ -32,13 +32,13 @@ Biomeのアシストはデフォルトで有効になっており、いくつか ## IDEでアシストアクションを使用する -LSP互換のIDEを使用している場合、保存時に特定のアクションを実行するようにBiomeを設定できます。各アシストアクションには「コードアクション」と呼ばれる特定のコードがあります。大部分の名前は同じパターンに従っていますが、いくつかの例外がある場合があります（例：`organizeImports`）ので、関連するコードを知るには各アクションのドキュメントページを参照してください。 +LSP互換のIDEを使用している場合、保存時に特定のアクションを実行するようにBiomeを設定できます。各アシストアクションには「コードアクション」と呼ばれる特定のコードがあります。大部分の名前は同じパターンに従っていますが、いくつかの例外があります（例：`organizeImports`）ので、コードを知るには各アクションのドキュメントページを参照してください。 まず、保存時にすべての修正を適用するようにエディタを設定する必要があります。設定はエディタによって異なります。コードアクション名は `source.fixAll.biome` です： -次に、各アクションのコードを追加できます。たとえば、アクション [`useSortedKeys`](/assist/actions/use-sorted-keys) には `source.action.useSortedKeys.biome` というコードアクションがあります。VSCodeを使用している場合、このコードをコピーして `editor.codeActionsOnSave` セクションに配置すると、ドキュメントを保存したときにBiomeがそれを適用します： +次に、各アクションのコードを追加できます。たとえば、アクション [`useSortedKeys`](/assist/actions/use-sorted-keys) には `source.action.useSortedKeys.biome` というコードアクションがあります。VS Codeを使用している場合、こののコードをコピーして `editor.codeActionsOnSave` セクションに配置すると、ドキュメントを保存したときにBiomeがアクションを適用します： @@ -62,7 +62,7 @@ biome check --enforce-assist=false ## アシストアクションの抑制 -[抑制ページ](/analyzer/suppressions)を参照してください。 +[抑制のページ](/ja/analyzer/suppressions)を参照してください。 ## グループ diff --git a/src/content/docs/ja/formatter/index.mdx b/src/content/docs/ja/formatter/index.mdx index 0bfdbb881..4c1c4d551 100644 --- a/src/content/docs/ja/formatter/index.mdx +++ b/src/content/docs/ja/formatter/index.mdx @@ -5,10 +5,10 @@ description: Biomeのフォーマッタの使い方 import PackageManagerBiomeCommand from "@/components/PackageManagerBiomeCommand.astro"; -Biomeは[複数の言語をサポートする](/internals/language-support)、opinionatedなフォーマッタです。 +Biomeは[複数の言語をサポートする](/ja/internals/language-support)、opinionatedなフォーマッタです。 [Prettierと近い哲学](https://prettier.io/docs/en/option-philosophy.html)に従い、 スタイルに関する議論がBiomeのオプションに関する議論に発展するのを避けるために、いくつかのオプションのみをサポートしています。 -チーム内での[些細な議論](https://en.wikipedia.org/wiki/Law_of_triviality)を防ぎ、本当に重要なことに集中できるようにするために、[新しいオプションを意図的に追加しない](https://github.com/prettier/prettier/issues/40)ようにしています。 +チーム内での[些細な議論](https://ja.wikipedia.org/wiki/パーキンソンの凡俗法則)を防ぎ、本当に重要なことに集中できるようにするために、[新しいオプションを意図的に追加しない](https://github.com/prettier/prettier/issues/40)ようにしています。 ## CLI @@ -42,10 +42,10 @@ biome format ./src/**/*.test.{js,ts} Biomeは、フォーマッタの動作を調整するためのいくつかのオプションを提供しています。 他のツールとは異なり、Biomeは言語に依存しないオプションと言語固有のオプションを分離しています。 -フォーマッタオプションは、[CLI](/reference/cli/#biome-format)または[Biome設定ファイル](/guides/configure-biome)で設定できます。 +フォーマッタオプションは、[CLI](/reference/cli/#biome-format)または[Biome設定ファイル](/ja/guides/configure-biome)で設定できます。 v1.9以降、Biomeは `.editorconfig` ファイルの読み込みをサポートしています。 -[Biome設定ファイル](/guides/configure-biome)を使用して、Biome CLIとBiome LSPの両方が同じオプションを適用するようにすることをお勧めします。 +[Biome設定ファイル](/ja/guides/configure-biome)を使用して、Biome CLIとBiome LSPの両方に同じオプションが適用されるようにすることをお勧めします。 以下のデフォルト設定が適用されます： ```json title="biome.json" @@ -79,13 +79,13 @@ v1.9以降、Biomeは `.editorconfig` ファイルの読み込みをサポート } ``` -Biomeフォーマッタがサポートする主な言語に依存しないオプションは次のとおりです： +Biomeフォーマッタがサポートする、言語に依存しない主なオプションは次のとおりです： - インデントスタイル（デフォルト：`tab`）：インデントにスペースまたはタブを使用します。 - インデント幅（デフォルト：`2`）：インデントレベルごとのスペースの数です。 - 行幅（デフォルト：`80`）：Biomeがコードを折り返す列幅です。 -詳細については、[設定リファレンス](/reference/configuration#formatter)を参照してください。 +詳細については、[設定リファレンス](/ja/reference/configuration#formatter)を参照してください。 ## コードを無視する diff --git a/src/content/docs/ja/guides/configure-biome.mdx b/src/content/docs/ja/guides/configure-biome.mdx index 22799220f..9ed80b288 100644 --- a/src/content/docs/ja/guides/configure-biome.mdx +++ b/src/content/docs/ja/guides/configure-biome.mdx @@ -1,17 +1,20 @@ --- title: Biomeの設定 description: Biomeの設定がどのように機能するかを学びます。 +tableOfContents: + minHeadingLevel: 2 + maxHeadingLevel: 4 --- import { FileTree } from '@astrojs/starlight/components'; このガイドでは、Biomeの設定方法を理解するために役立ちます。 Biomeの設定ファイルの構成と、Biomeがどのように設定を解決するかを説明します。 -あなたがすでに設定方法について詳しい場合は、利用可能なすべてのオプションの詳細が記載された[設定リファレンス](/reference/configuration/)を参照してください。 +あなたがすでに設定方法について詳しい場合は、利用可能なすべてのオプションの詳細が記載された[設定リファレンス](/ja/reference/configuration/)を参照してください。 Biomeでは、CLIのオプションか `biome.json` または `biome.jsonc` の設定ファイルを使って動作をカスタマイズできます。 設定ファイルをそれぞれのプロジェクトに作成することを推奨しています。 -これにより、CLIおよびBiomeと連携したエディタにおいてチームのメンバが同じ設定を使うことを保証できます。 +これにより、CLIおよびBiomeと連携したエディターにおいて、チームのメンバーが同じ設定を使うことを保証できます。 設定ファイルで利用可能なオプションの多くはCLIでも利用できます。 ## 設定ファイルの構成 @@ -113,7 +116,7 @@ Biomeは次の順序で設定ファイルを検出しようとします： `app/frontend/biome.json` の設定ファイルを使います :::note -Biomeはネストされた `biome.json` ファイルをサポートしています。詳細については、[大規模プロジェクトでのBiomeの使用](/guides/big-projects#use-multiple-configuration-files)を参照してください。 +Biomeはネストされた `biome.json` ファイルをサポートしています。詳細については、[大規模プロジェクトでのBiomeの使用](/ja/guides/big-projects#複数の設定ファイルの使用)を参照してください。 ::: @@ -150,12 +153,12 @@ biome format file1.js src/ ### 設定ファイルでファイルを制御する Biomeの設定ファイルを使用して、処理するファイルを絞り込むことができます。 -[`files.includes` フィールド](/reference/configuration/#filesincludes)を使用して、処理するファイルを明示的に列挙できます。 -`files.includes` は `src/**/*.js` などの[globパターン](/reference/configuration/#glob-syntax-reference)を受け入れます。 -`!` で始まるnegatedパターンを使用してファイルを除外できます。 +[`files.includes` フィールド](/ja/reference/configuration/#filesincludes)を使用して、処理するファイルを明示的に列挙できます。 +`files.includes` は `src/**/*.js` などの[globパターン](/ja/reference/configuration/#Glob構文リファレンス)を受け入れます。 +`!` で始まる否定パターンを使用してファイルを除外できます。 Biomeの設定ファイル内のパスとglobは、設定ファイルがあるフォルダを基準に解決されます。 -例外は、設定ファイルが別の設定ファイルによって[継承](/reference/configuration/#extends)されている場合です。 +例外は、設定ファイルが別の設定ファイルによって[継承](/ja/reference/configuration/#extends)されている場合です。 `files.includes` はBiomeのすべてのツールに適用されます。つまり、ここで指定されたファイルは、特に指定しない限り、リンタ、フォーマッタ、アシストによって処理されます。 個々のツールについては、`.includes` を使用してマッチするファイルをさらに絞り込むことができます。 @@ -200,9 +203,9 @@ biome lint test/ #### 設定ファイルでファイルを除外する -Biomeによって処理されないファイルやフォルダを除外したい場合は、`files.includes` 設定を使用し、negatedパターンを使用できます： +Biomeによって処理されないファイルやフォルダを除外したい場合は、`files.includes` 設定を使用し、否定パターンを使用できます： - 先頭に `!` を使用してファイルをリント/フォーマットから除外する -- 二重の先頭 `!!` を使用してプロジェクト関連の操作からファイルを除外する +- 先頭に二重の `!!` を使用してプロジェクト関連の操作からファイルを除外する プロジェクト関連の操作には以下が含まれます： - 内部モジュールグラフの構築。[一部のプロジェクトルール](/linter/domains/#project)がインポートとエクスポートから情報を解決できるようにするためです。 @@ -210,7 +213,7 @@ Biomeによって処理されないファイルやフォルダを除外したい プロジェクト関連の操作の対象と見なされるファイルは**インデックス化**されます。 -negatedされたglobを列挙する前に、**それらの前に `**` パターンを付ける必要があります**。 +否定されたglobを列挙する前に、**それらの前に `**` パターンを付ける必要があります**。 次の例では、すべてのファイルを含めるようBiomeに指示しますが、以下を除外します： - `dist/` フォルダ。プロジェクト関連の操作から除外されるため、インデックス化されません。 @@ -228,12 +231,12 @@ negatedされたglobを列挙する前に、**それらの前に `**` パター } ``` -スキャナーとの相互作用、およびファイルのインデックス化方法の詳細については、[関連するリファレンスページ](/reference/configuration#interaction-with-the-scanner)を確認してください。 +スキャナーとの相互作用、およびファイルのインデックス化方法の詳細については、[関連するリファレンスページ](/ja/reference/configuration#スキャナーとの相互作用)を確認してください。 ### VCSでファイルを制御する -[VCSで無視されたファイルを無視する](/guides/integrate-in-vcs#use-the-ignore-file)こともできます。 +[VCSで無視されたファイルを無視する](/ja/guides/integrate-in-vcs#無視するファイルを設定する)こともできます。 ## 既知のファイル @@ -292,6 +295,6 @@ negatedされたglobを列挙する前に、**それらの前に `**` パター - `tsconfig.json` - `typedoc.json` - `typescript.json` -- `$PROJECT/.vscode/*` フォルダ配下および[ユーザーVSCode設定フォルダ](https://code.visualstudio.com/docs/configure/settings#_user-settingsjson-location)配下のすべての `.json` ファイル +- `$PROJECT/.vscode/*` フォルダ配下および[ユーザーVS Code設定フォルダ](https://code.visualstudio.com/docs/configure/settings#_user-settingsjson-location)配下のすべての `.json` ファイル - `$PROJECT/.zed/*` フォルダ配下および[ユーザーZed設定フォルダ](https://zed.dev/docs/configuring-zed#user-settings-file)配下のすべての `.json` ファイル - `$PROJECT/.cursor/*` フォルダ配下およびユーザーCursor設定フォルダ配下のすべての `.json` ファイル diff --git a/src/content/docs/ja/internals/language-support.mdx b/src/content/docs/ja/internals/language-support.mdx index 40d67ac06..aa3383730 100644 --- a/src/content/docs/ja/internals/language-support.mdx +++ b/src/content/docs/ja/internals/language-support.mdx @@ -9,26 +9,26 @@ description: Biomeがサポートする言語と機能。 - ⌛️: 進行中 - 🟡: 実験的 -| Language | Parsing | Formatting | Linting | Plugin Support | -|----------------------------------------------------------|------------------------------------------------------|------------------------------------------------------|---------------------------------------------------------|---------------------------------------------------------| -| [JavaScript](#javascriptのサポート) | ✅ | ✅ | ✅ | ✅ | -| [TypeScript](#typescriptのサポート) | ✅ | ✅ | ✅ | ✅ | -| JSX | ✅ | ✅ | ✅ | ✅ | -| TSX | ✅ | ✅ | ✅ | ✅ | -| JSON | ✅ | ✅ | ✅ | ✅ | -| JSONC | ✅ | ✅ | ✅ | ✅ | -| HTML* | ✅ | ✅ | ✅ | ✅ | -| [Vue](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | -| [Svelte](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | -| [Astro](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | -| CSS | ✅️ | ✅️ | ✅️ | ✅ | +| Language | Parsing | Formatting | Linting | Plugin Support | +|----------------------------------------------------------|----------------------------------------------|----------------------------------------------|-------------------------------------------------|-------------------------------------------------| +| [JavaScript](#javascriptのサポート) | ✅ | ✅ | ✅ | ✅ | +| [TypeScript](#typescriptのサポート) | ✅ | ✅ | ✅ | ✅ | +| JSX | ✅ | ✅ | ✅ | ✅ | +| TSX | ✅ | ✅ | ✅ | ✅ | +| JSON | ✅ | ✅ | ✅ | ✅ | +| JSONC | ✅ | ✅ | ✅ | ✅ | +| HTML* | ✅ | ✅ | ✅ | ✅ | +| Vue | 🟡 | 🟡 | 🟡 | 🟡 | +| Svelte | 🟡 | 🟡 | 🟡 | 🟡 | +| Astro | 🟡 | 🟡 | 🟡 | 🟡 | +| CSS | ✅️ | ✅️ | ✅️ | ✅ | | SCSS | ⌛️ | ⌛️ | 🚫 | 🚫 | | [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | ⌛️ | 🚫 | 🚫 | -| GraphQL | ✅️ | ✅️ | ✅️ | 🚫 | +| GraphQL | ✅️ | ✅️ | ✅️ | 🚫 | | [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | ⌛️ | 🚫 | 🚫 | -| GritQL | ✅️ | ✅️ | 🚫 | 🚫 | +| GritQL | ✅️ | ✅️ | 🚫 | 🚫 | -*\* 現在、[明示的なオプトイン](https://biomejs.dev/reference/configuration/#html)が必要です。* +*\* 現在、[明示的なオプトイン](/ja/reference/configuration/#html)が必要です。* ## JavaScriptのサポート @@ -56,7 +56,7 @@ BiomeはJavaScriptのテンプレートリテラル内に埋め込まれた以 ## TypeScriptのサポート -Biomeは、TypeScriptバージョン5.6をサポートしています。 +Biomeは、TypeScriptバージョン5.9をサポートしています。 ## JSONCサポート @@ -82,36 +82,9 @@ JSONCは「コメント付きJSON」の略です。この形式は、[VS Code](h 埋め込み言語をまたいで動作するリントルールはまだサポートされていません。 -### HTML系言語のリント - -`.svelte`、`.astro`、または `.vue` ファイルを**リント**し、`html.experimentalFullSupportEnabled` が `false` の場合、部分的なサポートによって引き起こされる誤検出のリントエラーを防ぐために、いくつかの追加ルールをオフにすることをお勧めします。そのために `overrides` オプションを使用します： - -```json title=biome.json -{ - "overrides": [ - { - "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], - "linter": { - "rules": { - "style": { - "useConst": "off", - "useImportType": "off" - }, - "correctness": { - "noUnusedVariables": "off", - "noUnusedImports": "off" - } - } - } - } - ] -} -``` - ### 異なる設定でのフォーマット -Biomeでは、異なる言語のフォーマットを制御できます。Biomeが同じファイル内で複数の言語を処理できるようになったため、 -設定によっては不整合が発生する可能性が高まります。 +Biomeでは、異なる言語のフォーマットを制御できます。Biomeが同じファイル内で複数の言語を処理できるようになったため、設定によっては不整合が発生する可能性が高まります。 例えば、完全サポートが有効になっていると仮定した場合、JavaScriptとCSSコードを含むHTML系ファイルをフォーマットする際に、次の例のようにタブとスペースが混在するファイルになるリスクがあります： diff --git a/src/content/docs/ja/linter/index.mdx b/src/content/docs/ja/linter/index.mdx index f62a795a3..da40b8274 100644 --- a/src/content/docs/ja/linter/index.mdx +++ b/src/content/docs/ja/linter/index.mdx @@ -52,19 +52,19 @@ biome lint biome check ``` -各リントルールにはデフォルトの[重大度](/reference/diagnostics#diagnostic-severity)があり、ルールのドキュメントを読むことで詳細を学ぶことができます。 +各リントルールにはデフォルトの[重大度](/ja/reference/diagnostics#診断の重要度)があり、ルールのドキュメントを読むことで詳細を学ぶことができます。 -ルールは[グループ](#linter-groups)に分けられています。たとえば、`noDebugger` ルールは [`suspicious` グループ](#suspicious)の一部です。 +ルールは[グループ](#リンタグループ)に分けられています。たとえば、`noDebugger` ルールは [`suspicious` グループ](#suspicious)の一部です。 Biomeは*言語に依存しないルール*をサポートしています。これらは複数の言語で機能するルールで、たとえば `noUselessEscapeInString` はJavaScriptとCSSの両方で無駄なエスケープシーケンスを報告できます。 -他のリンタとは異なり、Biomeはコードフォーマットをチェックするルールを提供していません。[Biomeフォーマッタ](/formatter/)がすべてのフォーマット決定を処理することを意図しています。 +他のリンタとは異なり、Biomeはコードフォーマットをチェックするルールを提供していません。[Biomeフォーマッタ](/ja/formatter/)がすべてのフォーマット決定を処理することを意図しています。 多くのルールは自動的に適用できる**コード修正**を提供しています。 -Biomeは[**安全な修正**](#safe-fixes)と[**安全でない修正**](#unsafe-fixes)を区別しており、これらは若干異なる動作をします。主な違いは、安全な修正はファイルの保存時に自動的に適用できますが、安全でない修正はできません。ただし、ユーザーはどの修正を安全と見なすかを上書きできます。 +Biomeは[**安全な修正**](#安全な修正-safe-fixes)と[**安全でない修正**](#安全でない修正-unsafe-fixes)を区別しており、これらは若干異なる動作をします。主な違いとして、安全な修正はファイルの保存時に自動的に適用できますが、安全でない修正はできません。ただし、ユーザーはどの修正を安全と見なすかを上書きできます。 -Biomeリンタには自動的に有効になる推奨ルールのセットが付属しており、言語によって異なります。 +Biomeのリンタには自動的に有効になる推奨ルールのセットが付属しており、言語によって異なります。 ### 安全な修正 (Safe fixes) @@ -76,9 +76,9 @@ CLIから_安全な修正_を適用するには、`--write` を使用します LSP互換エディタから、コードアクション `source.fixAll.biome` を使用して安全な修正を**保存時に**適用できます。 -適用方法については、エクステンションのドキュメントを参照してください。 +適用方法については、拡張機能のドキュメントを参照してください。 -### 安全でない修正 +### 安全でない修正 (Unsafe fixes) 安全でない修正は、プログラムのセマンティクスを変更する可能性があります。 したがって、変更を手動でレビューすることをお勧めします。 @@ -99,7 +99,7 @@ Biomeでは、ルールは情報を提供し、ルールがトリガーされた 3. ユーザーに何をすべきかを伝えます。一般的に、これはコードアクションを使用して実装されます。 コードアクションが適用できない場合、ノートでユーザーにエラーを修正するために何をすべきかを伝える必要があります。 -ルールがこれらの基本原則に従っていないと思う場合は、[イシューを開いてください](https://github.com/biomejs/biome/issues/new?assignees=&labels=S-To+triage&projects=&template=01_bug.yml&title=%F0%9F%90%9B+%3CTITLE%3E)。 +ルールがこれらの基本原則に従っていないと思う場合は、[イシューを作成してください](https://github.com/biomejs/biome/issues/new?assignees=&labels=S-To+triage&projects=&template=01_bug.yml&title=%F0%9F%90%9B+%3CTITLE%3E)。 ## リンタの設定 @@ -143,7 +143,7 @@ Biomeではリンタをカスタマイズでき、このセクションではそ Biomeのリントルールには独自のデフォルトの重大度が設定されています。デフォルトの重大度を適用したい場合は、`"on"` 設定を使用できます。 -たとえば、`noShoutyConstants` はデフォルトで推奨されておらず、トリガーされると情報重大度の診断を出力します。 +たとえば、`noShoutyConstants` はデフォルトで推奨されておらず、トリガーされると重大度が情報の診断を出力します。 このデフォルトに満足していて使用したい場合、設定は次のようになります： @@ -161,11 +161,11 @@ Biomeのリントルールには独自のデフォルトの重大度が設定さ デフォルトの重大度に満足していない場合、Biomeでは `"error"`、`"warn"`、`"info"` で変更できます。 -[`"error"`](/reference/diagnostics#error) の診断は常にCLIをエラーコードで終了させます。この重大度は、特定のルールに属する違反がある場合にCIをブロックしたい場合に役立ちます。 +[`"error"`](/ja/reference/diagnostics#エラーerror) の診断は常にCLIをエラーコードで終了させます。この重大度は、特定のルールに属する違反がある場合にCIをブロックしたい場合に役立ちます。 -[警告](/reference/diagnostics#warning)はエラーと似ていますが、`--error-on-warnings` フラグが使用されない限り、CLIをエラーコードで終了させません。`warn` 重大度の可能な使用法は、特定のルールに対する診断がまだある間にCIをパスさせたい場合です。 +[`"warn"`](/ja/reference/diagnostics#警告warning) はエラーと似ていますが、`--error-on-warnings` フラグが使用されない限り、CLIをエラーコードで終了させません。`warn` 重大度の可能な使用法は、特定のルールに対する診断がまだある間にCIをパスさせたい場合です。 -[`info`](/reference/diagnostics#information) 重大度は、`--error-on-warnings` が渡された場合でも、CLIの終了ステータスコードに影響しません。 +[`"info"`](/ja/reference/diagnostics#情報information) は、`--error-on-warnings` が渡された場合でも、CLIの終了ステータスコードに影響しません。 ### グループの重大度を変更する @@ -315,7 +315,7 @@ Biomeのリンタは、最も近い `package.json` で特定の依存関係を ## リントルールを抑制する -[抑制ページ](/analyzer/suppressions)を参照してください。 +[抑制のページ](/ja/analyzer/suppressions)を参照してください。 ## エディタとの統合 @@ -324,8 +324,8 @@ LSP互換エディタとのファーストクラスの統合により、Biomeの Biomeによって違反が検出されると、診断が任意の数のコードアクションとともにエディタに送信されます。これらのアクションは診断に対処することを目的としています。 これらのアクションは： - 可能なコード修正。このコード修正は、ルールが**コード修正を持つ**場合にのみ表示されます。コード修正は、安全か安全でないかに関係なく表示されます。 -- [インライン抑制](/analyzer/suppressions#inline-suppressions)で診断を抑制します。 -- [トップレベル抑制](/analyzer/suppressions#top-level-suppressions)で診断を抑制します。 +- [インライン抑制](/ja/analyzer/suppressions#インライン抑制)で診断を抑制します。 +- [トップレベル抑制](/ja/analyzer/suppressions#トップレベル抑制)で診断を抑制します。 通常、カーソルを診断の範囲に配置して特定のショートカット（エディタによって異なります）を入力すると、可能なコードアクションを含むツールチップが表示されます。 @@ -353,8 +353,8 @@ Biomeによって違反が検出されると、診断が任意の数のコード ## 他のリンタからの移行 Biomeのリントルールの多くは、他のリンタに触発されています。 -ESLintや `typescript-eslint` などの他のリンタから移行する場合は、[ルールソースページ](/linter/rules-sources)を確認してください。 -ESLintから移行する場合は、専用の[移行ガイド](/guides/migrate-eslint-prettier#migrate-from-eslint)があります。 +ESLintや `typescript-eslint` などの他のリンタから移行する場合は、[ルールソースのページ](/linter/rules-sources)を確認してください。 +ESLintから移行する場合は、専用の[移行ガイド](/ja/guides/migrate-eslint-prettier#eslintからの移行)があります。 @@ -364,9 +364,9 @@ ESLintから移行する場合は、専用の[移行ガイド](/guides/migrate-e ``` 2. 次のコマンドを使用して、Biomeによってキャッチされる可能性のある新しいルールを抑制してプロジェクトをリントします： ```shell - biome lint --write --unsafe --suppress="suppressed due to migration" + biome lint --write --unsafe --suppress="移行のために抑制" ``` - このコマンドは、Biomeが見つけたすべてのリント違反を、理由 `"suppressed due to migration"` を使用して抑制します。これでリンタはエラーを出さなくなり、後の段階で抑制コメントを削除することができます。 + このコマンドは、Biomeが見つけたすべてのリント違反を、理由 `"移行のために抑制"` を使用して抑制します。これでリンタはエラーを出さなくなり、後の段階で抑制コメントを削除することができます。 @@ -385,7 +385,13 @@ ESLintから移行する場合は、専用の[移行ガイド](/guides/migrate-e 不正確または役に立たないことが保証されているコードを検出するルール。 ### Nursery -まだ開発中の新しいルール。Nurseryルールは、まだバグやパフォーマンスの問題がある可能性があるため、安定版では設定による明示的なオプトインが必要です（推奨とマークされている場合でも）。ナイトリービルドではデフォルトで有効になっていますが、不安定であるため、最終的に安定化されたときに推奨されることを意図しているかどうかに応じて、診断重大度はエラーまたは警告に設定される場合があります。Nurseryルールは安定すると他のグループに昇格するか、削除される場合があります。このグループに属するルールはセマンティックバージョンの対象ではありません。 +まだ開発中の新しいルール。 + +Nurseryルールは、まだバグやパフォーマンスの問題がある可能性があるため、安定版では設定による明示的なオプトインが必要です（推奨とマークされている場合でも）。ナイトリービルドではデフォルトで有効になっていますが、不安定であるため、最終的に安定化されたときに推奨されることを意図しているかどうかに応じて、診断重大度はエラーまたは警告に設定される場合があります。Nurseryルールは安定すると他のグループに昇格するか、削除される場合があります。 + +:::caution +このグループに属するルールはセマンティックバージョンの対象ではありません。 +::: ### Performance コードをより高速に実行するため、または一般的により効率的にするための方法を検出するルール。 @@ -405,19 +411,19 @@ ESLintから移行する場合は、専用の[移行ガイド](/guides/migrate-e ### なぜルールXは*安全でない*修正を持っているのですか？安全に見えます Biomeチームが修正を安全でないとマークすることを決定する理由はさまざまですが、ほとんどの場合、次のことに要約されます： -- リントルールはまだ開発中であり、修正も同様です。 -- ルール修正はプログラムのセマンティクスを変更する可能性があるため、ユーザーが修正をオプトインする必要があります。 -- ルール修正は、入力中や保存中のDXを悪化させる可能性があります。例として `noUnusedVariables` があり、未使用の変数の名前に `_` を追加します。これは、入力中や保存中のプログラマーのDXを悪化させる可能性があります。この動作は[設定](/linter/#configure-the-code-fix)で変更できます。 +- リントルールやコード修正まだ開発中である。 +- ルールの修正はプログラムのセマンティクスを変更する可能性があるため、ユーザーが修正をオプトインする必要がある。 +- ルールの修正は、入力中や保存中のDXを悪化させることがある。例として、 `noUnusedVariables` は未使用の変数の名前に `_` を追加します。これは、入力中や保存中のプログラマーのDXを悪化させる可能性があります。この動作は[設定](#コード修正を設定する)で変更できます。 コード修正がこれら3つのガイドラインに従っていない場合、チームがルール修正を安全にすることを忘れた可能性があります。イシューを開くかPRを送信してください！ ### なぜBiomeリンタはv1と比べて遅いのですか？ -Biome v2以降、Scannerと呼ばれるツールでアーキテクチャを拡張しました。Scannerは、プロジェクトファイルをクロールし、モジュールグラフや推論された型などの重要な情報を作成する役割を担っています。 +Biome v2以降、スキャナーと呼ばれるツールでアーキテクチャを拡張しました。スキャナーは、プロジェクトファイルをクロールし、モジュールグラフや推論された型などの重要な情報を作成する役割を担っています。 -このような情報は、`noFloatingPromises`、`noUnresolvedImports`、`noImportCycles` などの一部のルールに**必要**であり、これらのルールはそうでなければ機能しません。一般的に、[projectドメイン](/linter/domains/#project)に属するルールの場合です。 +このような情報は、`noFloatingPromises`、`noUnresolvedImports`、`noImportCycles` などの一部のルールに**必要**であり、これらのルールはスキャナーなしに機能しません。一般的に、[projectドメイン](/linter/domains/#project)に属するルールの場合です。 -Scannerは**オプトイン**であり、[projectドメイン](/linter/domains#project-rules)に属するルールが有効になっている場合にのみトリガーされます。 +スキャナーは**オプトイン**であり、[projectドメイン](/linter/domains#project-rules)に属するルールが有効になっている場合にのみ起動されます。 テストに基づいて、おおよそ次の数値に気づきました： | | Scannerなし | Scannerあり | @@ -427,13 +433,13 @@ Scannerは**オプトイン**であり、[projectドメイン](/linter/domains#p また、**チームはこのパフォーマンスへの影響を認識しており**、ソフトウェアのこの部分のパフォーマンスを改善することを約束していることも言及する価値があります。 -低速化の調査と緩和に関するアドバイスについては、[低速化の調査ガイド](/guides/investigate-slowness)を参照してください。 +低速化の調査と緩和に関するアドバイスについては、[低速化の調査ガイド](/ja/guides/investigate-slowness)を参照してください。 メモリや時間に関して異常な数値に気づいた場合は、リポジトリへのリンクを含むイシューをファイルしてください。サポートいたします。 ### なぜBiomeはそんなに多くのメモリを使用しているのですか？ -Biomeを使用するエディタエクステンションを使用している場合、そのプロセスの1つが大量のメモリを使用する可能性があることに気づくかもしれません。 +Biomeを使用するエディタの拡張機能を使用している場合、そのプロセスの1つが大量のメモリを使用していることに気づくかもしれません。 これは通常、[projectドメイン](/linter/domains/#project)に属するルールの1つを有効にした場合に発生します。 diff --git a/src/content/docs/ja/reference/configuration.mdx b/src/content/docs/ja/reference/configuration.mdx index 145803fe4..66ac0ae7c 100644 --- a/src/content/docs/ja/reference/configuration.mdx +++ b/src/content/docs/ja/reference/configuration.mdx @@ -37,7 +37,7 @@ JSONスキーマファイルへのパスを指定できます。 拡張するパスの順序は、関連性の低いものから高いものへと進みます。 -v2以降、このオプションは値 `"//"` に一致する必要がある文字列を受け入れます。これは[モノレポ](/guides/big-projects#monorepo)を設定する際に使用できます。 +v2以降、このオプションは値 `"//"` に一致する必要がある文字列を受け入れます。これは[モノレポ](/ja/guides/big-projects#モノレポ)を設定する際に使用できます。 ## `root` @@ -105,7 +105,7 @@ Biomeには[スキャナー](/internals/architecture/#scanner)があり、ネス * プロジェクトドメインのルールが有効な場合、スキャナーはソースファイルとそのソースファイルの**依存関係をインデックス化**します。これは、`files.includes` の一部として無視されるファイルでも、それらのファイルをインポートする他の含まれるファイルがある限り、スキャナーによってインデックス化される可能性があることを意味します。また、これは `node_modules/` 内の `.d.ts` ファイルや `package.json` マニフェストもインデックス化される可能性があることを意味します。 スキャナーによって明示的に無視するファイルを強制したい場合は、 -いわゆる _force-ignore パターン_ を使用できます。force-ignoreパターンは通常のnegatedパターンのように見えますが、二重の感嘆符 (`!!`) で始まります。 +いわゆる _force-ignore パターン_ を使用できます。force-ignoreパターンは通常の否定パターンのように見えますが、二重の感嘆符 (`!!`) で始まります。 例えば、次の設定を使用して、Biomeに任意の `dist/` フォルダ内を決して見ないように指示できます： @@ -145,7 +145,7 @@ Biomeには[スキャナー](/internals/architecture/#scanner)があり、ネス :::caution このオプションは**非推奨**となり、将来のリリースで削除される可能性があります。 -代わりに `files.includes` で [_force-ignore 構文_](/reference/configuration/#interaction-with-the-scanner) を使用してください。 +代わりに `files.includes` で [_force-ignore 構文_](/ja/reference/configuration/#スキャナーとの相互作用) を使用してください。 ::: スキャナーがクロール中に無視すべきリテラルパスセグメントの配列です。無視されたファイルはインデックス化されません。つまり、これらのファイルはモジュールグラフの一部にならず、それらから型が推論されません。 @@ -191,7 +191,7 @@ Biomeのリンタを有効にします。 ### `linter.includes` -リントするファイルの[globパターン](#glob-syntax-reference)のリストです。 +リントするファイルの[globパターン](#glob構文リファレンス)のリストです。 次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルをリントします： @@ -204,9 +204,9 @@ Biomeのリンタを有効にします。 ``` `*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 -[glob構文リファレンス](#glob-syntax-reference)を参照してください。 +[glob構文リファレンス](#glob構文リファレンス)を参照してください。 -`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 +`includes` は、例外である否定パターンもサポートしています。これらは `!` で始まるパターンで、Biomeに否定パターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 例外は順番に処理されるため、例外の例外を指定できます。 @@ -330,7 +330,7 @@ Biomeのアシスト機能を有効にします。 ### `assist.includes` -解析するファイルの[globパターン](#glob-syntax-reference)のリストです。 +解析するファイルの[globパターン](#glob構文リファレンス)のリストです。 次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルを解析します： @@ -343,9 +343,9 @@ Biomeのアシスト機能を有効にします。 ``` `*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 -[glob構文リファレンス](#glob-syntax-reference)を参照してください。 +[glob構文リファレンス](#glob構文リファレンス)を参照してください。 -`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 +`includes` は、例外である否定パターンもサポートしています。これらは `!` で始まるパターンで、Biomeに否定パターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 例外は順番に処理されるため、例外の例外を指定できます。 @@ -449,7 +449,7 @@ Biomeのフォーマッタを有効にします。 `*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 [glob構文リファレンス](#glob-syntax-reference)を参照してください。 -`includes` は、例外であるnegatedパターンもサポートしています。これらは `!` で始まるパターンで、Biomeにnegatedパターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 +`includes` は、例外である否定パターンもサポートしています。これらは `!` で始まるパターンで、Biomeに否定パターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 例外は順番に処理されるため、例外の例外を指定できます。 @@ -1651,7 +1651,7 @@ globで次の構文をサポートしています： 文字の範囲も指定できます。Unicodeで順序付けられているため、例えば `[0-9]` は0から9までの任意の文字を指定します。 - `[!...]` は `[...]` の否定、つまり括弧内に**ない**任意の文字に一致します。 -- glob全体が `!` で始まる場合、いわゆるnegatedパターンです。この +- glob全体が `!` で始まる場合、いわゆる否定パターンです。この globは、パスがglobに一致_しない_場合にのみ一致します。Negatedパターンは 単独では使用できず、通常のglobの_例外_としてのみ使用できます。 - ファイルが含まれるかどうかを判断する際、Biomeは親フォルダも考慮します。これは、フォルダ内のすべてのファイルを_含める_場合、 diff --git a/src/content/docs/linter/index.mdx b/src/content/docs/linter/index.mdx index 265f3ec01..720bda9ef 100644 --- a/src/content/docs/linter/index.mdx +++ b/src/content/docs/linter/index.mdx @@ -163,9 +163,9 @@ If you aren't happy with the default severity, Biome allows you to change it wit Diagnostics with the [`"error"`](/reference/diagnostics#error) always cause the CLI to exit with an error code. This severity can be useful when you want to block the CI if there's a violation that belongs to a certain rule. -[Warnings](/reference/diagnostics#warning) are similar to errors, but they don't cause the CLI to exit with an error code, unless the `--error-on-warnings` flag is used. A possible use for the `warn` severity is when you want to make the CI pass while there are still diagnostics for a given rule. +[`"warn"`](/reference/diagnostics#warning) are similar to errors, but they don't cause the CLI to exit with an error code, unless the `--error-on-warnings` flag is used. A possible use for the `warn` severity is when you want to make the CI pass while there are still diagnostics for a given rule. -The [`info`](/reference/diagnostics#information) severity won't affect the exit status code of the CLI, even when `--error-on-warnings` is passed. +The [`"info"`](/reference/diagnostics#information) severity won't affect the exit status code of the CLI, even when `--error-on-warnings` is passed. ### Change group severity @@ -385,7 +385,13 @@ Rules that focus on inspecting complex code that could be simplified. Rules that detect code that is guaranteed to be incorrect or useless. ### Nursery -New rules that are still under development. Nursery rules require explicit opt-in via configuration on stable versions because they may still have bugs or performance problems (even if they are marked as recommended). They are enabled by default on nightly builds, but as they are unstable their diagnostic severity may be set to either error or warning, depending on whether we intend for the rule to be recommended or not when it eventually gets stabilized. Nursery rules get promoted to other groups once they become stable or may be removed. Rules that belong to this group are not subject to semantic version. +New rules that are still under development. + +Nursery rules require explicit opt-in via configuration on stable versions because they may still have bugs or performance problems (even if they are marked as recommended). They are enabled by default on nightly builds, but as they are unstable their diagnostic severity may be set to either error or warning, depending on whether we intend for the rule to be recommended or not when it eventually gets stabilized. Nursery rules get promoted to other groups once they become stable or may be removed. + +:::caution +Rules that belong to this group are not subject to semantic version. +::: ### Performance Rules catching ways your code could be written to run faster, or generally be more efficient. From faea54032cd5e666fbf055c42e5cc8645bc50371 Mon Sep 17 00:00:00 2001 From: Naoki Ikeguchi Date: Tue, 17 Feb 2026 02:08:26 +0900 Subject: [PATCH 3/5] fix(ja): apply feedback --- src/content/docs/ja/assist/index.mdx | 2 +- src/content/docs/ja/index.mdx | 4 ++-- src/content/docs/ja/linter/index.mdx | 12 ++++++------ src/content/docs/ja/reference/configuration.mdx | 6 +++--- src/content/docs/reference/configuration.mdx | 2 +- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/src/content/docs/ja/assist/index.mdx b/src/content/docs/ja/assist/index.mdx index d6e950a8c..679f89ee6 100644 --- a/src/content/docs/ja/assist/index.mdx +++ b/src/content/docs/ja/assist/index.mdx @@ -38,7 +38,7 @@ LSP互換のIDEを使用している場合、保存時に特定のアクショ -次に、各アクションのコードを追加できます。たとえば、アクション [`useSortedKeys`](/assist/actions/use-sorted-keys) には `source.action.useSortedKeys.biome` というコードアクションがあります。VS Codeを使用している場合、こののコードをコピーして `editor.codeActionsOnSave` セクションに配置すると、ドキュメントを保存したときにBiomeがアクションを適用します： +次に、各アクションのコードを追加できます。たとえば、アクション [`useSortedKeys`](/assist/actions/use-sorted-keys) には `source.action.useSortedKeys.biome` というコードアクションがあります。VS Codeを使用している場合、このコードをコピーして `editor.codeActionsOnSave` セクションに配置すると、ドキュメントを保存したときにBiomeがアクションを適用します： diff --git a/src/content/docs/ja/index.mdx b/src/content/docs/ja/index.mdx index 167383b92..b56a5e15f 100644 --- a/src/content/docs/ja/index.mdx +++ b/src/content/docs/ja/index.mdx @@ -103,7 +103,7 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro"

問題を修正し、ベストプラクティスを学ぶ

- **Biomeは _JavaScript_、_TypeScript_、_JSX_、_CSS_ そして _GraphQL_ のための[高性能なリンタ](https://github.com/biomejs/biome/tree/main/benchmark#linting)** であり、ESLint、TypeScript ESLint、[その他のソース](/linter/rules-sources/)に由来する **[個のルール](/linter/)** を備えています。 + **Biomeは _JavaScript_、_TypeScript_、_JSX_、_CSS_ そして _GraphQL_ のための[高性能なリンタ](https://github.com/biomejs/biome/tree/main/benchmark#linting)** であり、ESLint、TypeScript ESLint、[その他のソース](/linter/rules-sources/)に由来する **[個のルール](/ja/linter/)** を備えています。 **Biomeは、文脈を考慮した詳細な診断を出力**してくれるため、あなたがコードを改善してより優れたプログラマーになるのに役立ちます！ @@ -155,7 +155,7 @@ import FeaturedUsers from "@/components/FeaturedUsers.astro" 今日使用しているすべての言語機能をそのままサポートします。TypeScriptとJSXへのファーストクラスサポートを提供します。 - + コントリビューターのコミュニティを通じて、必要とする組織に商用サポートを提供しています。 diff --git a/src/content/docs/ja/linter/index.mdx b/src/content/docs/ja/linter/index.mdx index da40b8274..4aca19645 100644 --- a/src/content/docs/ja/linter/index.mdx +++ b/src/content/docs/ja/linter/index.mdx @@ -9,7 +9,7 @@ import { Steps } from '@astrojs/starlight/components'; import EditorAction from "@/components/EditorAction.astro"; Biomeのリンタはコードを静的に分析し、一般的なエラーを見つけて修正し、より優れた最新のコードを書くのに役立ちます。 -[複数の言語](/internals/language-support)をサポートし、全部で**個のルール**を提供しています。 +[複数の言語](/ja/internals/language-support)をサポートし、全部で **個のルール** を提供しています。 CLIを使用してBiomeリンタをすぐに試すことができます。次のコマンドは、プロジェクトのルートからすべてのファイルに対してリンタを実行します： @@ -71,7 +71,7 @@ Biomeのリンタには自動的に有効になる推奨ルールのセットが 安全な修正は、コードのセマンティクスを変更しないことが保証されています。 明示的なレビューなしに適用できます。 -CLIから_安全な修正_を適用するには、`--write` を使用します： +CLIから _安全な修正_ を適用するには、`--write` を使用します： @@ -83,7 +83,7 @@ LSP互換エディタから、コードアクション `source.fixAll.biome` を 安全でない修正は、プログラムのセマンティクスを変更する可能性があります。 したがって、変更を手動でレビューすることをお勧めします。 -CLIから_安全な修正_と_安全でない修正_の両方を適用するには、`--write --unsafe` を使用します： +CLIから _安全な修正_ と _安全でない修正_ の両方を適用するには、`--write --unsafe` を使用します： @@ -190,8 +190,8 @@ Biomeのリントルールには独自のデフォルトの重大度が設定さ コード修正は `fix` オプションを使用して設定できます。次の3つの値のいずれかを持つことができます： - `none`: ルールはコード修正を出力しません -- `safe`: ルールは[安全な修正](#safe-fixes)を出力します -- `unsafe`: ルールは[安全でない修正](#unsafe-fixes)を出力します +- `safe`: ルールは[安全な修正](#安全な修正-safe-fixes)を出力します +- `unsafe`: ルールは[安全でない修正](#安全でない修正-unsafe-fixes)を出力します ```json title="biome.jsonc" ins={7,13,17} { @@ -372,7 +372,7 @@ ESLintから移行する場合は、専用の[移行ガイド](/ja/guides/migrat ## リンタグループ -リンタはルールを_グループ_に分けます。グループは、ルールが属するある種のカテゴリを提供することを目的としています。この情報は、有効/無効にするルールを選択する際や、開発者が新しいリントルールを作成する際に役立ちます。 +リンタはルールを _グループ_ に分けます。グループは、ルールが属するある種のカテゴリを提供することを目的としています。この情報は、有効/無効にするルールを選択する際や、開発者が新しいリントルールを作成する際に役立ちます。 ### Accessibility diff --git a/src/content/docs/ja/reference/configuration.mdx b/src/content/docs/ja/reference/configuration.mdx index 66ac0ae7c..9be1e8e75 100644 --- a/src/content/docs/ja/reference/configuration.mdx +++ b/src/content/docs/ja/reference/configuration.mdx @@ -363,7 +363,7 @@ Biomeのアシスト機能を有効にします。 1. `**` パターンのおかげで、すべての（サブ）フォルダ内のすべてのファイルが解析されます。.. 2. ... ただし、それらのファイルが `.test.js` 拡張子を持つ場合は除きます。.. -3. ... しかし、ファイル `special.test.ts` は _まだ_ 解析されます。 +3. ... しかし、ファイル `special.test.js` は _まだ_ 解析されます。 つまり： @@ -434,7 +434,7 @@ Biomeのフォーマッタを有効にします。 ### `formatter.includes` -フォーマットするファイルの[globパターン](#glob-syntax-reference)のリストです。 +フォーマットするファイルの[globパターン](#glob構文リファレンス)のリストです。 次の例は、`src` フォルダ内の `.js` 拡張子を持つすべてのファイルをフォーマットします： @@ -447,7 +447,7 @@ Biomeのフォーマッタを有効にします。 ``` `*` は _フォルダ内のすべてのファイル_ に一致し、`**` は _フォルダ内のすべてのファイルとサブフォルダを再帰的に_ 一致させます。globの詳細については、 -[glob構文リファレンス](#glob-syntax-reference)を参照してください。 +[glob構文リファレンス](#glob構文リファレンス)を参照してください。 `includes` は、例外である否定パターンもサポートしています。これらは `!` で始まるパターンで、Biomeに否定パターンに一致するファイルを除く _すべて_ のファイルを処理するように指示するために使用できます。 diff --git a/src/content/docs/reference/configuration.mdx b/src/content/docs/reference/configuration.mdx index 674cfd4b8..1cf749a53 100644 --- a/src/content/docs/reference/configuration.mdx +++ b/src/content/docs/reference/configuration.mdx @@ -98,7 +98,7 @@ This example specifies that: 1. All files inside all (sub)folders are processed, thanks to the `**` pattern... 2. ... _except_ when those files have a `.test.js` extension... -3. ... but the file `special.test.ts` _is_ still processed... +3. ... but the file `special.test.js` _is_ still processed... 4. ... _except_ when it occurs in the folder named `test`, because _no_ files inside that folder are processed. From aa234492850c91b74c47361dff87e00d148cd0c4 Mon Sep 17 00:00:00 2001 From: Naoki Ikeguchi Date: Tue, 17 Feb 2026 22:07:22 +0900 Subject: [PATCH 4/5] fixup! feat(ja): revise translations --- .../docs/internals/language-support.mdx | 32 +++++++++++++++-- .../docs/ja/internals/language-support.mdx | 34 ++++++++++++++++--- 2 files changed, 59 insertions(+), 7 deletions(-) diff --git a/src/content/docs/internals/language-support.mdx b/src/content/docs/internals/language-support.mdx index 50935f3ff..d0056e909 100644 --- a/src/content/docs/internals/language-support.mdx +++ b/src/content/docs/internals/language-support.mdx @@ -18,9 +18,9 @@ Legend: | JSON | ✅ | ✅ | ✅ | ✅ | | JSONC | ✅ | ✅ | ✅ | ✅ | | HTML* | ✅ | ✅ | ✅ | ✅ | -| Vue | 🟡 | 🟡 | 🟡 | 🟡 | -| Svelte | 🟡 | 🟡 | 🟡 | 🟡 | -| Astro | 🟡 | 🟡 | 🟡 | 🟡 | +| [Vue](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Svelte](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Astro](#html-super-languages-support) | 🟡 | 🟡 | 🟡 | 🟡 | | CSS | ✅️ | ✅️ | ✅️ | ✅ | | SCSS | ⌛️ | ⌛️ | 🚫 | 🚫 | | [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | ⌛️ | 🚫 | 🚫 | @@ -82,6 +82,32 @@ In particular, as for `v2.3.0`, Biome doesn't do any particular parsing for lang Lint rules that work across embedded languages aren't supported yet. +### Linting HTML-ish languages + +If you **lint** `.svelte`, `.astro` or `.vue` files and `html.experimentalFullSupportEnabled` is `false`, it's advised to turn off a few additional rules to prevent false positive linting errors caused by our partial support. Use the option `overrides` for that: + +```json title=biome.json +{ + "overrides": [ + { + "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], + "linter": { + "rules": { + "style": { + "useConst": "off", + "useImportType": "off" + }, + "correctness": { + "noUnusedVariables": "off", + "noUnusedImports": "off" + } + } + } + } + ] +} +``` + ### Formatting with different settings With Biome, you can control the formatting of different languages. Now that Biome can process multiple languages in the same file, diff --git a/src/content/docs/ja/internals/language-support.mdx b/src/content/docs/ja/internals/language-support.mdx index aa3383730..4ef015aaa 100644 --- a/src/content/docs/ja/internals/language-support.mdx +++ b/src/content/docs/ja/internals/language-support.mdx @@ -18,9 +18,9 @@ description: Biomeがサポートする言語と機能。 | JSON | ✅ | ✅ | ✅ | ✅ | | JSONC | ✅ | ✅ | ✅ | ✅ | | HTML* | ✅ | ✅ | ✅ | ✅ | -| Vue | 🟡 | 🟡 | 🟡 | 🟡 | -| Svelte | 🟡 | 🟡 | 🟡 | 🟡 | -| Astro | 🟡 | 🟡 | 🟡 | 🟡 | +| [Vue](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Svelte](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | +| [Astro](#html拡張言語のサポート) | 🟡 | 🟡 | 🟡 | 🟡 | | CSS | ✅️ | ✅️ | ✅️ | ✅ | | SCSS | ⌛️ | ⌛️ | 🚫 | 🚫 | | [YAML](https://github.com/biomejs/biome/issues/2365) | ⌛️ | ⌛️ | 🚫 | 🚫 | @@ -28,7 +28,7 @@ description: Biomeがサポートする言語と機能。 | [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | ⌛️ | 🚫 | 🚫 | | GritQL | ✅️ | ✅️ | 🚫 | 🚫 | -*\* 現在、[明示的なオプトイン](/ja/reference/configuration/#html)が必要です。* +*\* 現在、[明示的なオプトイン](https://biomejs.dev/reference/configuration/#html)が必要です。* ## JavaScriptのサポート @@ -82,6 +82,32 @@ JSONCは「コメント付きJSON」の略です。この形式は、[VS Code](h 埋め込み言語をまたいで動作するリントルールはまだサポートされていません。 +### HTML系言語のリント + +`html.experimentalFullSupportEnabled` が `false` の場合に `.svelte`、`.astro`、または `.vue` ファイルを**リント**する際は、部分的なサポートによって引き起こされる誤検出のリントエラーを防ぐために、いくつかの追加ルールをオフにすることをお勧めします。そのために `overrides` オプションを使用します： + +```json title=biome.json +{ + "overrides": [ + { + "includes": ["**/*.svelte", "**/*.astro", "**/*.vue"], + "linter": { + "rules": { + "style": { + "useConst": "off", + "useImportType": "off" + }, + "correctness": { + "noUnusedVariables": "off", + "noUnusedImports": "off" + } + } + } + } + ] +} +``` + ### 異なる設定でのフォーマット Biomeでは、異なる言語のフォーマットを制御できます。Biomeが同じファイル内で複数の言語を処理できるようになったため、設定によっては不整合が発生する可能性が高まります。 From 5d11cf7f0f2107651f4d4cde00505442cdd62a10 Mon Sep 17 00:00:00 2001 From: Naoki Ikeguchi Date: Tue, 17 Feb 2026 22:11:29 +0900 Subject: [PATCH 5/5] fixup! feat(ja): revise translations --- src/content/docs/ja/internals/language-support.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/ja/internals/language-support.mdx b/src/content/docs/ja/internals/language-support.mdx index 4ef015aaa..4f71469f8 100644 --- a/src/content/docs/ja/internals/language-support.mdx +++ b/src/content/docs/ja/internals/language-support.mdx @@ -9,7 +9,7 @@ description: Biomeがサポートする言語と機能。 - ⌛️: 進行中 - 🟡: 実験的 -| Language | Parsing | Formatting | Linting | Plugin Support | +| 言語 | パース | フォーマット | リント | プラグインサポート | |----------------------------------------------------------|----------------------------------------------|----------------------------------------------|-------------------------------------------------|-------------------------------------------------| | [JavaScript](#javascriptのサポート) | ✅ | ✅ | ✅ | ✅ | | [TypeScript](#typescriptのサポート) | ✅ | ✅ | ✅ | ✅ | @@ -28,7 +28,7 @@ description: Biomeがサポートする言語と機能。 | [Markdown](https://github.com/biomejs/biome/issues/3718) | ⌛️ | ⌛️ | 🚫 | 🚫 | | GritQL | ✅️ | ✅️ | 🚫 | 🚫 | -*\* 現在、[明示的なオプトイン](https://biomejs.dev/reference/configuration/#html)が必要です。* +*\* 現在、[明示的なオプトイン](/ja/reference/configuration/#html)が必要です。* ## JavaScriptのサポート @@ -56,7 +56,7 @@ BiomeはJavaScriptのテンプレートリテラル内に埋め込まれた以 ## TypeScriptのサポート -Biomeは、TypeScriptバージョン5.9をサポートしています。 +Biomeは、TypeScriptバージョン5.6をサポートしています。 ## JSONCサポート