GitHub 上のリソースを正しく取得する方法を完全に理解します。-Git-php.cn

GitHub 上のリソースを正しく取得する方法を完全に理解します。

私が初心者のオープンソースコントリビューターだったとき、最大の課題の 1 つは、取り組むべき適切なプロジェクト/問題を見つけることでした。

私は長い間、インターネット上のさまざまなライターのリソースに依存していました (ちなみに、これらは素晴らしいものです)。しかし、私は常にこの問題の解決策、つまり自分のスキルセットに合ったプロジェクトを検索して追跡できる方法を見つけたいと考えていました。

1 つ同意しましょう。Google とは異なり、GitHub を検索するのは簡単ではありません。しかし、開発者としては、毎日 GitHub または Gitlab を操作する可能性が高くなります。

ここで問題となるのは、これらのバージョン管理システムを何に使用するかではなく、どのように使用するかです。 Google 検索スキルを習得することが平均的なインターネットユーザーにとって不可欠であるのと同様に、開発者にとって GitHub を効果的に検索する方法を学ぶことは不可欠であると私は考えています。

この記事では、GitHub を適切に検索する方法に関するさまざまなテクニックを説明します。次の検索方法を学びます:

問題とプルリクエスト
リポジトリ
ユーザー
トピック

## ＃もっと。はじめましょう。

GitHub 検索クエリ

オンラインで何かに関する詳細情報を見つけるには、適切な検索スキルが必要です。 GitHub についても同様です。詳細情報を見つけるには、一般的なフィルタリング、並べ替え、検索手法を使用して、特定のプロジェクトの特定の問題やプルリクエストを簡単に見つけることができます。

インターネット上にさまざまなプロジェクトの複数のリソースをリストしていますが、主な問題は、それらを自分で検索するときに発生します。どうやって始めるのか？適切な結果を見つけるにはどのキーワードを使用する必要がありますか?

ほとんどのメンテナーは自分のプロジェクトを問題としてラベル付けする傾向があるため、コントリビューターは適切なプロジェクトを見つけやすくなります。以下に、

GitHub を使用する際に役立つヒントをいくつか示します。

GitHub で課題を検索してプルリクエストを送信する方法

貢献するプロジェクトを見つける最も一般的な方法の 1 つは、課題と関連する PR を検索することです。信頼できる回答を簡単に見つけるために使用できるヒントをいくつか紹介します。

is:issue is:open label:beginner - この特定のクエリwill 開かれており、初心者の質問としてマークされているすべてのプロジェクトをリストします。
is:issue is:open label:easy - これには、easy としてマークされているすべての未解決の問題がリストされます。
is:issue is:open label:first-timers-only - これには、初めての方も歓迎される未解決の問題がすべてリストされています。
is:issue is:open label:good-first-bug - これは、解決プロジェクトに適しているとマークされた最初のものをリストします。間違った未解決の問題に取り組むよう寄稿者を惹きつけること。
is:issue is:open label:"good first issue" - これにより、「good first issue」というラベルが付いた未解決の問題がすべてリストされます。質問」ということは、初心者が始めるのに適した場所であることを意味します。
is:issue is:open label:starter - starter question というラベルが付いた未解決の問題をすべてリストします。
is:issue is:open label:up-for-grabs - 必要なスキルをお持ちの場合は、未解決の問題をすべてリストします。いつでも処理できます。
no:project type:issue is:open - 特定のプロジェクトに割り当てられていない未解決の問題をすべてリストします。
no:マイルストーンタイプ:問題は:open - 多くの場合、プロジェクトはマイルストーンを使用して追跡されます。ただし、追跡されていない問題を見つけたい場合は、この検索クエリでそれらの項目がリストされます。
no:label type:issue is:open - これにより、ラベルの付いていない未解決の問題がすべてリストされます。
is:issue is:open no:assignee - 誰かに割り当てられていない未解決の問題をすべてリストします。

リポジトリの検索方法

デフォルトでは、検索するには、検索バーにリポジトリ名を入力するだけです。いくつかの検索結果が表示されます。

しかし、希望どおりの買い戻しが得られる可能性は非常に低いです。

検索を絞り込むいくつかの方法を見てみましょう:

名前、説明/README で検索する方法

README の名前と説明で検索する場合の注意点ファイル重要なのは、検索フレーズが in 修飾子で始まる必要があるということです。これにより、探しているものの「内部」を検索することが可能になります。

例

in:nameを使用します。データサイエンスについて詳しく学ぶためのリソースを探しているとします。この場合、Data Science in:name コマンドを使用すると、リポジトリ名に Data Science が含まれるリポジトリが一覧表示されます。
in:descriptionを使用します。特定の説明を持つリポジトリを検索したい場合、たとえばリポジトリの説明に「freeCodeCamp」という単語が含まれている場合、検索は次のようになります: freecodecamp in:description
##in:readme を使用します。これを使用して、ファイルの README で特定の語句を検索します。 README に freecodecamp という単語が含まれるリポジトリを見つけたい場合、検索は次のようになります: freecodecamp in:readme.
Use
in:topic。これを使用して、トピック内で特定の語句または単語がタグ付けされているかどうかを確認します。たとえば、トピックに freecodecamp がリストされているすべてのリポジトリを見つけるには、検索は次のようになります: freecodecamp in:topic

複数の検索クエリを組み合わせて、検索をさらに絞り込みます。

スター、フォークに基づいて検索する方法

プロジェクトに含まれるスターとフォークの数に基づいてリポジトリを検索することもできます。これにより、商品の人気度が分かりやすくなります。

例

stars:nを使用します。 1000 個のスターを持つリポジトリを検索する場合、検索クエリは stars:1000 になります。これにより、1000 個のスターが付いたリポジトリがリストされます。
forks:n を使用します。これは、リポジトリに必要なフォークの数を指定します。フォークが 100 個未満のリポジトリを見つけたい場合は、検索は次のようになります: forks:<100。

幸いなことに、

<、>、<= などの関係演算子はいつでも使用できます。 >= および .. は、検索をさらに絞り込むのに役立ちます。

言語で検索する方法

GitHub で検索するもう 1 つの便利な方法は、言語で検索することです。これは、特定の言語のリポジトリをフィルターで除外するのに役立ちます。

例:

言語:LANGUAGE を使用します。たとえば、PHP で書かれたリポジトリを見つけたい場合、検索は次のようになります: 言語:PHP

組織名で検索する方法

特定の組織によって維持または作成されたリポジトリ/プロジェクトも検索します。これを行うには、キーワード

org:... に続けて組織名を入力して検索を開始する必要があります。

たとえば、

org:freecodecamp を検索すると、freeCodeCamp に一致するリポジトリが一覧表示されます。

日付で検索する方法

結果を特定の日付に基づいて表示したい場合は、次のキーワードのいずれかを使用して検索できます:

created、更新済み、マージ済み、およびクローズ済み。これらのキーワードは、YYYY-MM-DD の形式で日付とともに使用する必要があります。

例:

キーワード:YYYY-MM-DD を使用します。たとえば、2022 年 10 月 1 日以降に作成された freeCodeCamp という単語を含むすべてのリポジトリを検索したいとします。その場合、検索は次のようになります: freecodecamp created:>2022-10-01

<, > # を使用することもできます。 ##、>= および <= を使用して、指定した日付以降、前後の日付を検索します。範囲内で検索するには、.....ライセンスによる検索方法

#を使用して検索できます。プロジェクトにとってライセンスは非常に重要です。ライセンスが異なれば、寄稿者ができることとできないことに対して異なる権利が与えられます。

正しいライセンスを持つプロジェクトを見つけやすくするには、ライセンスについてよく理解する必要があります。詳細については、こちらをご覧ください。

例:

license:LICENSE_KEYWORD を使用します。これは、特定のライセンスを持つプロジェクトを検索するのに最適な方法です。たとえば、MIT ライセンスを持つプロジェクトを検索するには、license:MIT.

可視性による検索方法

## を使用します。 ## リポジトリの可視性に基づいて検索することもできます。この場合、パブリックまたはプライベートを使用できます。これにより、パブリックまたはプライベートリポジトリ内の課題と PR がそれぞれ照合されます。

例:

is:public を使用します。これにより、パブリックリポジトリのリストが表示されます。 freeCodCamp が所有するすべてのパブリックリポジトリを検索する例を見てみましょう。その場合、検索は is:public org:freecodecamp になります。
is:private を使用します。このクエリは、指定された検索クエリの下にあるすべてのプライベートリポジトリを一覧表示することを目的としています。

結論

ここでは多くの検索クエリを取り上げてきましたが、複数のパラメータを組み合わせることで、さらに検索を絞り込むことができます。

より多くのリソースとより多くの検索パラメータについては、

GitHub ドキュメントを確認するか、Advanced GitHub Search を使用してください。これらの方法は、より多くのフィルタリングオプションを提供するため、常に便利です。

さまざまな検索パラメーターを使用して、GitHub での日常のアクティビティを簡素化できます。このプラットフォームをより簡単かつ効果的に使用するのに役立つことを願っています。