Hello World

はじめに

このチュートリアルでは、リポジトリ、ブランチ、コミット、プル要求などの重要な GitHub について説明します。 独自のHello World リポジトリを作成し、コードを作成してレビューする一般的な方法であるGitHubの pull request ワークフローについて学習します。

このクイックスタート ガイドでは、次の操作を行います。

• リポジトリを作成して使用する。
• 新しいブランチの開始および管理。
• ファイルに変更を加え、コミットとして GitHub にプッシュします。
• プル リクエストを開いてマージします。

前提条件

• GitHub アカウントが必要です。 詳細については、 AUTOTITLE を参照してください。

• コードの作成、コマンド ラインの使用、Git ( GitHub が構築されているバージョン管理ソフトウェア) のインストール方法を知る必要はありません。

手順 1: リポジトリを作成する

まず、リポジトリを作成します。 リポジトリは、ファイル、画像、ビデオ、その他のフォルダーなど、関連する項目を含むフォルダーであると考えることができます。 リポジトリは通常、同じ "プロジェクト" に属する項目、または作業中のものをグループ化します。

多くの場合、リポジトリには README ファイル (プロジェクトに関する情報を含むファイル) が含まれます。 Markdown で書かれた README ファイルは、プレーンテキストを書式設定するための読みやすく書きやすい言語です。 Markdown ファイルと README ファイルの詳細については、 AUTOTITLE と AUTOTITLE を参照 してください。

GitHub では、新しいリポジトリを作成すると同時に README ファイルを追加できます。 GitHub には、ライセンス ファイルなどの他の一般的なオプションも用意されていますが、現在はいずれかを選択する必要はありません。

hello-world リポジトリは、アイデアやリソースを格納し、他のユーザーと共有し話し合う場所にすることができます。

1. ページの右上隅で を選択し、 [新しいリポジトリ] をクリックします。

   

2. [リポジトリ名] ボックスに「hello-world」と入力します。

3. [説明] ボックスに簡単な説明を入力します。 たとえば、「このリポジトリは、 GitHub フローを実践するためのリポジトリです」と入力します。

4. リポジトリが [パブリック] か [プライベート] かを選択します。

5. [README ファイルを追加する] を選択します。

6. [Create repository] (リポジトリの作成) をクリックします。

手順 2: ブランチを作成する

ブランチを使用すると、一度に異なるバージョンのリポジトリを使用できます。

既定では、リポジトリには、決定版ブランチと見なされる main という名前のブランチが 1 つ存在します。 リポジトリで main の追加のブランチを作成できます。

ブランチは、コードのメインのソースを変更せずに新しい機能をプロジェクトに追加する場合に役立ちます。 異なるブランチで行われた作業は、マージするまでメインのブランチには表示されません。これについてはこのガイドで後ほど説明します。 ブランチを使用すると、main にコミットする前に実験や編集を行うことができます。

main ブランチからブランチを作成すると、main のその時点のコピー (スナップショット) が作成されます。 作業中に他のユーザーが main ブランチに変更を加えた場合に、それらの更新を取り込むことができます。

この図は次のことを示しています。

• main ブランチ
• feature という名前の新しいブランチ
• feature が、main にマージされる前に、"変更のコミット"、"pull request の送信"、"提案された変更のディスカッション" の各ステージを経る過程

ブランチの作成

1. コード タブを hello-world リポジトリでクリックします。

2. ファイル リストの上で、main と表示されているドロップダウン メニューをクリックします。

   

3. テキスト ボックスにブランチ名の「readme-edits」を入力します。

4. 「ブランチを作成：main から readme-edits」をクリックします。

   

これで main と readme-edits の 2 つのブランチを作成しました。 今のところ、この 2 つはまったく同じように見えます。 次に、新しい readme-edits ブランチに変更を追加します。

手順 3: 変更を行いコミットする

前の手順で新しいブランチを作成したときに、 GitHub 新しい readme-edits ブランチのコード ページ ( mainのコピー) に移動しました。

リポジトリ内のファイルに変更を加えて保存できます。 GitHubでは、保存された変更はコミットと呼ばれます。 各コミットには、特定の変更が行われた理由を説明するコミット メッセージが関連付けられています。 コミット メッセージでは、行ったこととその理由を他の共同作成者が理解できるように、変更内容の履歴がキャプチャされます。

1. 作成した readme-edits ブランチで README.md ファイルをクリックします。
2. ファイルを編集するには、[ ] をクリックします。
3. エディターで簡単な自己紹介文を書きます。
4. [変更をコミットする] をクリックします。
5. [変更のコミット] ボックスに、変更について説明するコミット メッセージを書き込みます。
6. [変更をコミットする] をクリックします。

これらの変更は readme-edits ブランチ上の README ファイルにのみ行われるため、このブランチに main とは異なるコンテンツが含まれるようになりました。

手順 4: Pull request を開く

main とは別のブランチに変更が加わったため、pull request を開くことができます。

プル要求は、 GitHubのコラボレーションの中心です。 pull request を開くと、変更を提案し、誰かにコントリビューションをレビューしてプルし、ブランチにマージするよう要求できます。 pull request では、両方のブランチのコンテンツの相違点 (差分) が表示されます。 変更、追加、差分は異なる色で表示されます。

コミットしたらすぐに、コードが完成していなくても、pull request を開き、ディスカッションを開始できます。

この手順では、独自のリポジトリで pull request を開き、その後自身でマージを行います。 大規模なプロジェクトに取り組む前に、 GitHub フローを練習するのに最適な方法です。

1. プルリクエストタブをhello-worldでクリックします。

2. [新しい pull request] をクリックします。

3. [比較例] ボックスで、作成したブランチの readme-edits を選択して、main (元のブランチ) と比較します。

4. あなたの変更を[比較]ページで差分として見直し、提出したい内容であることを確認してください。

   

5. [Pull request の作成] をクリックします。

6. pull request にタイトルを付け、変更内容の簡単な説明を記述します。 絵文字を含め、画像や gif をドラッグ アンド ドロップできます。

7. [Pull request の作成] をクリックします。

プルリクエストのレビュー

他のユーザーと共同作業を開始する場合は、ここでレビューを依頼します。 これにより、変更を main ブランチにマージする前に、コラボレーターが pull request にコメントしたり、変更を提案できます。

このチュートリアルでは pull request のレビューについては取り上げませんが、詳細については「プルリクエストのレビュー」を参照してください。 または、GitHub Skills「プル リクエストのレビュー」コースをお試しください。

手順 5: pull request をマージする

この最後の手順では、readme-edits ブランチを main ブランチにマージします。 pull request をマージすると、readme-edits ブランチの変更が main に組み込まれます。

場合によっては、pull request によって、main の既存のコードと競合するコードが変更される場合があります。 競合がある場合、 GitHub は競合するコードについて警告し、競合が解決されるまでマージを防ぎます。 競合を解決するコミットを行うか、pull request のコメントを使用して、チーム メンバーと競合について話し合うことができます。

この手順では、競合は発生しないため、ブランチをメインブランチにマージする準備ができています。

1. pull request の下部にある [Pull request のマージ] をクリックして、変更を main にマージします。
2. [マージの確認] をクリックします。 要求が正常にマージされ、要求が閉じられたことを示すメッセージが表示されます。
3. [ブランチの削除] をクリックします。 pull request がマージされ、変更が main に反映されたため、readme-edits ブランチを安全に削除できます。 プロジェクトをさらに変更する場合は、いつでも新しいブランチを作成し、このプロセスを繰り返すことができます。
4. ** リポジトリ** の hello-world タブにクリックして戻り、main でリリースされた変更を確認します。

Conclusion

このチュートリアルを完了することで、プロジェクトを作成し、 GitHubでプル要求を行う方法を学習しました。

その一環として、次の方法を学習しました。

• リポジトリの作成。
• 新しいブランチの開始および管理。
• ファイルを変更し、それらの変更を GitHubにコミットします。
• プル リクエストを開いてマージします。

次のステップ

• GitHub あなたのプロフィールを見ると、自分の作業がコントリビューショングラフに反映されているのがわかります。
• このチュートリアルで学習したスキルをもう一度練習する場合は、「GitHub Skillsの概要」コース試してみてください。
• プロファイルをカスタマイズし、 GitHubで記述するための基本的な Markdown 構文については、 AUTOTITLE を参照してください。

詳細については、次を参照してください。

• GitHub フロー