プル リクエストの diff からファイルを除外
除外ファイル フィルタは新しいプル リクエスト エクスペリエンスでのみ利用できます。また、差分ビューから除外するファイルはリポジトリ管理者のみが追加できます。
プルリクエスト ビューは、プル リクエストで変更された各ファイルを表示します。 [除外ファイル] リポジトリ設定ページでパターンを指定することで、プル リクエストの差分ビューに表示されないようにファイルを除外できます。
特定のファイルをプル リクエストでの表示から除外する手順:
- プル リクエストを含むリポジトリの [プル リクエスト] セクションで [設定] > [Excluded files] の順にクリックします。
- [パターン] フィールドに、プル リクエストの差分ビューから除外するパターンを入力します。
- 保存をクリックします。
[パターン] フィールドに追加するそれぞれの行が除外するパターンの指定に対応します。
次のパターンを使用できます。
- ファイル名 (例: index.min.js)。
- リポジトリ ルートに対する相対パス (例:
/minified/index.min.js)。 - ワイルドカード (例:
*.min.jsまたは/minified/**) を含むパターン。
入力したパターンと一致するファイルは引き続き、ファイル ツリーおよびプル リクエストで変更されたファイルの一覧に表示されますが、これらの除外ファイルの変更済みコンテンツは差分ビューには表示されません。
除外ファイルのパターン形式
リポジトリ設定での除外ファイルの形式は .gitignore のパターン形式と似ています。ただし、次の 2 つの例外にご注意ください。
- 末尾にスペースを使用することはできません。
- 特定のパターンを否定する方法はありません。
重要事項
- 照合は大文字と小文字を区別しません。
- ディレクトリはフォワード スラッシュ "
/" で示されます。 - バック スラッシュ "
\" は特殊文字をエスケープするために使用します。 非 ASCII 文字はサポートされません。UTF-8 エンコーディングが想定されます。
# package manager lock files (at the repository root)
/Gemfile.lock
/package-lock.json
# minified JS and CSS (anywhere in the repository)
*.min.js
*.min.css
# third-party libraries
/vendor/**
# generated XML (inside any my-code-generator/ directory)
my-code-generator/*.xml
# text files from November 2017
notes/2017-11-[0-3][0-9].txt
空白行とコメント
空白行とコメントを使用してファイル パターンを整理できます。空白ではない各行に、パターンまたはコメント (両方は不可) を含めることができます。
| パターン | 次と一致 | 注意 |
|---|---|---|
| なし | 空白行は区切り記号として使用できます。 |
| なし | # で始まる行は無視されます。 |
ファイル名
ファイルをファイル名で除外できます。ファイル名に特殊文字が含まれる場合、これらの文字をバックスラッシュでエスケープする必要があります。
- 特定の 1 つのファイルを除外するには、パターンの最初に、リポジトリのルートに対する相対一致を返す "
/" を付けます。 - ファイル名に一致するすべてのファイルを除外する場合、先頭に "
/" を付けないでください。
| パターン | 次と一致 | 注意 |
|---|---|---|
/package-lock.json |
| リポジトリのルートにある、package-lock.json という名前の 1 つのファイル。 |
package-lock.json |
| リポジトリ内の任意の場所にある、package-lock.json という名前のすべてのファイル。 |
/lib/foo.lib |
| リポジトリのルートにある lib という名前のディレクトリ内の、foo.lib という名前の 1 つのファイル。 |
lib/foo.lib |
| リポジトリ内の任意の場所にある lib という名前のディレクトリ内の、foo.lib という名前の任意のファイル。 |
file\[version\ 2\].js |
|
|
ディレクトリ名
末尾に "/" が付くパターンは、そのディレクトリに含まれるファイルに一致します。
| パターン | 次と一致 | 注意 |
|---|---|---|
/minified/ |
| リポジトリのルートにある minified という名前のディレクトリにある任意のファイル。 |
minified/ |
| リポジトリ内の任意の場所にある |
minified/js/ |
| リポジトリ内の任意の場所にある minified という名前のディレクトリ内の、js という名前の任意のファイル。 |
ワイルドカード
[] ワイルドカード
[] ワイルドカードは選択した範囲または文字クラス内の 1 つの文字に一致します。
| パターン | 次と一致 | 注意 |
|---|---|---|
file_[xyz].c |
| [] には特定の文字の一覧を含めることができます。 |
file_[a-z].c |
| [] を - と併用することで文字の範囲を指定できます。 |
file_[0-9][0-9].c |
| [0-9] は 1 桁の数字と一致します。 |
file_[]-].c |
|
]" は通常、文字クラスの最後をマークします。一覧の最初に表示されている場合、文字クラスに含まれます。 |
file_[高雄].c |
| 非 ASCII 文字はサポートされません。 |
? ワイルドカード
? ワイルドカードは "/" を除く任意の 1 文字と一致します。
| パターン | 次と一致 | 注意 |
|---|---|---|
file_?.c |
| 非 ASCII 文字はサポートされません。 |
* ワイルドカード
* ワイルドカードは "/" を除くすべてと一致します。
| パターン | 次と一致 | 注意 |
|---|---|---|
*.min.js |
| |
file_*.c |
| * は空の文字列を照合することができます。 |
dir*/file.c |
|
** ワイルドカード
** ワイルドカードはネストされたディレクトリを含む、パス名のあらゆる文字列と一致します。** を 2 つ以上連続して使用すると、一致する結果がない無効なパターンになります。
| パターン | 次と一致 | 注意 |
|---|---|---|
| **/*.min.js |
| *.min.js と同じ。 |
my/path/** |
| 末尾の /** は最後に名前が設定されたディレクトリ内のすべてと一致します。 |
my/path/**/*.min.js |
| |
/lib/**/py/ |
| /**/ は 0 以上のディレクトリと一致します。 |