Github 経由で貢献する

前提条件

プルリクエスト経由で貢献できるようにするには、いくつかの前提条件があります。

最小限の Git の使用方法を知っている
Github アカウントを持っている
貢献したいプロジェクトのフォークを持っている

詳細に入る前に、語彙について少し説明しておく必要があります。 Git/Github で常に使用する単語の小さな用語集を次に示します。

・レポ：「レポジトリ」の略。この単語は、Git でバージョン管理された一連のファイルを示すために使用します。

ブランチ: Git プロジェクトのブランチです。ブランチを使用すると、履歴のある時点でコードの並列バージョンを作成できます。
master: リポジトリのメインブランチを指定します。
origin: リモートリポジトリを指定します。たとえば、Github でホストされています。

・プルリクエスト：Github上のプロジェクトにコード修正を提案できる操作です。

フォーク: これは、別のレポのコピーであるレポです。これにより、既存のプロジェクトから開始して、変更、改善、修正、またはその他の処理を行うことができます。
アップストリーム: フォークの場合、フォークの元のレポを指定します。
fetch: これは、リモートからローカルにデータを取得する操作です。
プッシュ: これは、ローカルデータをリモートに送信できるようにする操作です。

構成

フォーク

最初に行うことは、Github にアクセスして、貢献したいプロジェクトの フォーク を作成することです。

たとえば、Leek Wars クライアントに貢献するには、Leek Wars Client にアクセスしてください。

次に、右上の「フォーク」ボタンをクリックします。

プロジェクトを「フォーク」することで、Github はあなたのアカウントに新しいレポを作成します。これは元のプロジェクトのコピーになります。

次に、URL アドレスを使用するか、緑色の [クローンまたはダウンロード] ボタンをクリックして、github リポジトリのアドレスを取得します。

ローカル リポジトリ を配置する場所に移動し、次のコマンドを使用します。 git clone \ "\" を置き換えることを忘れないでください。

それで。プロジェクトの フォーク を作成し、マシン上でローカルに取得しました。しかし、今後も安心して使い続けるためには、もう一つやるべきことがあります。

上流

次に、アップストリームを構成する必要があります。これにより、プロジェクトのリポジトリからリポジトリを更新できるようになります。

git remote -v コマンドを使用すると、構成されたリモートアドレスを一覧表示できます。

オリジン https://github.com/YOUR_USERNAME/YOUR_FORK.git (フェッチ) オリジン https://github.com/YOUR_USERNAME/YOUR_FORK.git (プッシュ)

今のところ、origin として構成された 2 つのアドレスが表示されます。 1 つは fetch です。新しい機能を リモート (Github でホストされているリポジトリ) から戻す必要があります。もう 1 つは プッシュ で、逆に、ローカルニュースをリモートのレポに送信できます。

これに、upstream を追加します。これを行うには、フォークしたばかりのプロジェクトのアドレスを取得します。常に URL または [複製またはダウンロード] ボタンを使用します。

upstream を追加するコマンドは次のとおりです: git remote add アップストリーム \

git remote -v コマンドを再度実行すると、4 つのエントリが表示されるはずです。 オリジン用に 2 つ、アップストリーム用に 2 つ。それぞれが fetch と push に複製されます。

オリジン https://github.com/YOUR_USERNAME/YOUR_FORK.git (フェッチ) オリジン https://github.com/YOUR_USERNAME/YOUR_FORK.git (プッシュ) アップストリーム https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (フェッチ) アップストリーム https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (プッシュ)

あなたは今すぐ貢献する準備ができています!