Git Hub 英語版使い方をGoogle日本語訳した

GitHub(https://github.com/)の「10分読むだけガイド(https://guides.github.com/activities/hello-world/)」がありますが、こちら全て英語で書かれているので、Google翻訳等で日本語訳しないと読みにくいと思います。

今回、その手間を省くため、全て日本語訳したものを載せておきます。

こういった方へ向けた記事です
①GitHubの使い方が英語で読むのが面倒な方
②GitHubの使い方を日本語訳するのが面倒な方
③今すぐGitHubの使い方を確認したい方

Hello Worldプロジェクトは、コンピュータプログラミングにおける昔からの伝統です。 これは、何か新しいことを学ぶときに始める簡単な練習です。 GitHubから始めましょう!

次の方法を学習します。
・リポジトリを作成して使用する
・新しいブランチを開始して管理する
・ファイルを変更し、コミットとしてGitHubにプッシュします ・プルリクエストを開いてマージする

GitHubとは何ですか?
GitHubは、バージョン管理とコラボレーションのためのコードホスティングプラットフォームです。 どこからでもプロジェクトに参加できるようになります。 このチュートリアルでは、リポジトリ、ブランチ、コミット、プルリクエストなどのGitHubの基本事項を学習します。 独自のHello Worldリポジトリを作成し、GitHubのプルリクエストワークフローについて学習します。これは、コードを作成および確認する一般的な方法です。

コーディングは不要
このチュートリアルを完了するには、GitHub.comアカウントとインターネットアクセスが必要です。 コーディング方法、コマンドラインの使用方法、Gitのインストール方法(バージョン管理ソフトウェアGitHubが組み込まれている)を知る必要はありません。 ヒント:このガイドを別のブラウザーウィンドウ(またはタブ)で開いて、チュートリアルの手順を実行している間、このガイドを表示できます。

ステップ1.リポジトリを作成する
リポジトリは通常、単一のプロジェクトを編成するために使用されます。 リポジトリには、フォルダーとファイル、画像、ビデオ、スプレッドシート、データセットなど、プロジェクトに必要なものをすべて含めることができます。 README、またはプロジェクトに関する情報を含むファイルを含めることをお勧めします。 GitHubを使用すると、新しいリポジトリを作成するのと同時に簡単に追加できます。 ライセンスファイルなど、他の一般的なオプションも提供します。 hello-worldリポジトリは、アイデア、リソースを保存したり、他の人と物事を共有したり話し合ったりする場所にすることができます。

新しいリポジトリを作成するには
1.右上隅のアバターまたはIDアイコンの横にあるをクリックし、[新しいリポジトリ]を選択します。
2.リポジトリにhello-worldという名前を付けます。
3.短い説明を書きます。
4.READMEでこのリポジトリを初期化を選択します。

new-repo-form

ステップ2.ブランチを作成する

ブランチとは、リポジトリの異なるバージョンを同時に処理する方法です。

デフォルトでは、リポジトリにはmainという名前のブランチが1つあり、これが最も信頼できるブランチと見なされます。 ブランチを使用して、メインにコミットする前に実験と編集を行います。

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

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

・本店
・featureと呼ばれる新しいブランチ(このブランチで「機能作業」を行っているため)
・メインに統合される前に機能がたどる旅

a branch

ファイルの異なるバージョンを保存したことがありますか? 何かのようなもの:

・story.txt
・story-joe-edit.txt
・story-joe-edit-reviewed.txt

ブランチは、GitHubリポジトリで同様の目標を達成します。

ここGitHubでは、開発者、ライター、デザイナーがブランチを使用して、バグ修正と機能作業をメイン(本番)ブランチから分離しています。 変更の準備ができると、ブランチをメインにマージします。

新しいブランチを作成するには

1.新しいリポジトリhello-worldに移動します。
2.ファイルリストの上部にある、branch:mainというドロップダウンをクリックします。
3.新しいブランチのテキストボックスにブランチ名readme-editsを入力します。
4.青い[作成]ブランチボックスを選択するか、キーボードのEnterキーを押します。

branch gif


これで、mainとreadme-editsの2つのブランチができました。 それらはまったく同じに見えますが、長くはありません! 次に、新しいブランチに変更を追加します。

ステップ3.変更を加えてコミットする

ブラボー! これで、mainのコピーであるreadme-editsブランチのコードビューが表示されます。 いくつか編集してみましょう。

GitHubでは、保存された変更はコミットと呼ばれます。 各コミットには、関連するコミットメッセージがあります。これは、特定の変更が行われた理由を説明する説明です。 コミットメッセージは変更の履歴をキャプチャするため、他の寄稿者はあなたが何をしたのか、またその理由を理解できます。

変更を加えてコミットする

1.README.mdファイルをクリックします。
2.編集するファイルビューの右上隅にある鉛筆アイコンをクリックします。
3.エディターで、自分について少し書きます。
4.変更を説明するコミットメッセージを記述します。
5.[変更をコミット]ボタンをクリックします。

commit

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

ステップ4.プルリクエストを開く

素敵な編集! main以外のブランチに変更が加えられたので、プルリクエストを開くことができます。

プルリクエストは、GitHubでのコラボレーションの中心です。 プルリクエストを開くと、変更を提案し、誰かにコントリビューションをレビューしてプルし、ブランチにマージするように要求します。 プルリクエストは、両方のブランチからのコンテンツの差分、つまり違いを示します。 変更、追加、および減算は、緑と赤で表示されます。

コミットを行うとすぐに、コードが終了する前でも、プルリクエストを開いてディスカッションを開始できます。

プルリクエストメッセージでGitHubの@メンションシステムを使用することで、特定の人やチームがホールにいるのか、10タイムゾーン離れているのかをフィードバックすることができます。

自分のリポジトリでプルリクエストを開いて、自分でマージすることもできます。 これは、大規模なプロジェクトに取り組む前にGitHubフローを学ぶのに最適な方法です。

READMEへの変更のプルリクエストを開く

画像をクリックすると拡大されます

Click the  Pull Request tab, then from the Pull Request page, click the green New pull request button.

pr-tab

[プルリクエスト]タブをクリックし、[プルリクエスト]ページで緑色の[新しいプルリクエスト]ボタンをクリックします。

In the Example Comparisons box, select the branch you made, readme-edits, to compare with main (the original).

branch

「比較の例」ボックスで、作成したブランチreadme-editsを選択して、メイン(オリジナル)と比較します。

Look over your changes in the diffs on the Compare page, make sure they’re what you want to submit.

diff

「比較」ページで差分の変更を確認し、それらが送信したいものであることを確認してください。

When you’re satisfied that these are the changes you want to submit, click the big green Create Pull Request button.

送信したい変更が完了したら、大きな緑色の[プルリクエストを作成]ボタンをクリックします。

Give your pull request a title and write a brief description of your changes.

pr-form

プルリクエストにタイトルを付け、変更の簡単な説明を書きます。

メッセージが完了したら、[プルリクエストを作成]をクリックします。

ヒント:絵文字を使用して、画像やGIFをコメントやプルリクエストにドラッグアンドドロップできます。

ステップ5.プルリクエストをマージする

この最後のステップでは、変更をまとめます。readme-editsブランチをメインブランチにマージします。

1.緑色のプル要求のマージボタンをクリックして、変更をメインにマージします。
2.[マージの確認]をクリックします。
3.変更が組み込まれているので、紫色のボックスの[ブランチの削除]ボタンを使用して、ブランチを削除します。

祝う!

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

このチュートリアルで達成したことは次のとおりです。

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

GitHubプロファイルを確認すると、新しいコントリビューションスクエアが表示されます。

プルリクエストの機能の詳細については、GitHubフローガイドを読むことをお勧めします。 GitHub Exploreにアクセスして、オープンソースプロジェクトに参加することもできます。

ヒント:GitHubの使用を開始する方法について詳しくは、他のガイド、YouTubeチャンネル、オンデマンドトレーニングをご覧ください。

コメントを残す

以下に詳細を記入するか、アイコンをクリックしてログインしてください。

WordPress.com ロゴ

WordPress.com アカウントを使ってコメントしています。 ログアウト /  変更 )

Google フォト

Google アカウントを使ってコメントしています。 ログアウト /  変更 )

Twitter 画像

Twitter アカウントを使ってコメントしています。 ログアウト /  変更 )

Facebook の写真

Facebook アカウントを使ってコメントしています。 ログアウト /  変更 )

%s と連携中