diff --git a/packages/tsconfig-reference/copy/ja/categories/Project_Files_0.md b/packages/tsconfig-reference/copy/ja/categories/Project_Files_0.md new file mode 100644 index 000000000000..7968bdcdc2c5 --- /dev/null +++ b/packages/tsconfig-reference/copy/ja/categories/Project_Files_0.md @@ -0,0 +1,5 @@ +--- +display: "ファイルインクルージョン" +--- + +これらの設定はTypeScriptが適切なファイルを確実に選択できるようにします。 diff --git a/packages/tsconfig-reference/copy/ja/options/exclude.md b/packages/tsconfig-reference/copy/ja/options/exclude.md new file mode 100644 index 000000000000..216b38df6543 --- /dev/null +++ b/packages/tsconfig-reference/copy/ja/options/exclude.md @@ -0,0 +1,11 @@ +--- +display: "Exclude" +oneline: "Files or patterns to be skipped from the include option" +--- + +`include`の解決時にスキップさせるファイル名やパターンのリストを指定します。 + +**重要**: `exclude`は`include`の結果として、どのファイルが含まれるべきか_のみ_に影響を与えます。 +`exclude`に指定されたファイルは、コードでの`import`や`types`でのインクルード、`/// + +``` +. +├── scripts ⨯ +│ ├── lint.ts ⨯ +│ ├── update_deps.ts ⨯ +│ └── utils.ts ⨯ +├── src ✓ +│ ├── client ✓ +│ │ ├── index.ts ✓ +│ │ └── utils.ts ✓ +│ ├── server ✓ +│ │ └── index.ts ✓ +├── tests ✓ +│ ├── app.test.ts ✓ +│ ├── utils.ts ✓ +│ └── tests.d.ts ✓ +├── package.json +├── tsconfig.json +└── yarn.lock +``` + +`include`と`exclude`はグロブパターンのためのワイルドカードをサポートしています: + +- `*` ゼロ個以上の文字列にマッチ(ディレクトリセパレータは除く) +- `?` 任意の1文字にマッチ(ディレクトリセパレータは除く) +- `**/` 任意階層の任意ディレクトリにマッチ + +グロブパターンがファイルの拡張子を含まない場合、サポートされる拡張子のみが含まれるようになります(例:`.ts`、`.tsx`と`.d.ts`はデフォルトでインクルードされ、`.js`と`.jsx`は`allowJs`が設定された場合のみインクルードされます)。 diff --git a/packages/tsconfig-reference/copy/ja/options/references.md b/packages/tsconfig-reference/copy/ja/options/references.md new file mode 100644 index 000000000000..1990184e0d1d --- /dev/null +++ b/packages/tsconfig-reference/copy/ja/options/references.md @@ -0,0 +1,9 @@ +--- +display: "References" +oneline: "Provide a structure for composite projects" +--- + +プロジェクト参照はTypeScriptのプログラムを小さい断片に分けて構造化するための手法です。 +プロジェクト参照を用いると、ビルド時間やエディターとのインタラクションに必要な時間が大幅に改善され、コンポーネント間の論理分割が強制により、より洗練された方法でコードを整理できます。 + +プロジェクト参照がどのように動作するかについては、このハンドブックの[Project References](/docs/handbook/project-references.html)を読んでください。 diff --git a/packages/tsconfig-reference/copy/ja/options/typeAcquisition.md b/packages/tsconfig-reference/copy/ja/options/typeAcquisition.md new file mode 100644 index 000000000000..a31129f60c72 --- /dev/null +++ b/packages/tsconfig-reference/copy/ja/options/typeAcquisition.md @@ -0,0 +1,37 @@ +--- +display: "Type Acquisition" +oneline: "Sets of options for Automatic Type Acquisition in JavaScript" +--- + +エディターにJavaScriptプロジェクトが存在する場合、TypeScriptは`@types`で定義されるDefinitelyTypedから提供されるファイルを用いて、`node_modules`のための型ファイルを自動で提供します。 +これは自動型取得と呼ばれており、また設定の`typeAcquisition`を使ってカスタマイズできます。 + +この機能を無効化したりカスタマイズする場合、プロジェクトのルートに`jsconfig.json`ファイルを作成してください: + +```json +{ + "typeAcquisition": { + "enable": false + } +} +``` + +プロジェクトに含めるべき特定のモジュールがある場合(それが`node_modules`には存在しない場合): + +```json +{ + "typeAcquisition": { + "include": ["jest"] + } +} +``` + +モジュールが自動で取得されるべきでない場合。例えば、そのライブラリが`node_modules`に含まれてはいるが、チームでこのライブラリを利用しないことを合意している場合: + +```json +{ + "typeAcquisition": { + "exclude": ["jquery"] + } +} +```