GitHub Desktop を使った最初のリポジトリ作成方法

はじめに

GitHub Desktopは、GitHubやその他の Git ホスティング サービスでホストされているコードを操作するのに役立つ無料のオープンソース アプリケーションです。 GitHub Desktopを使用すると、コマンド ラインを使用するのではなく、グラフィカル ユーザー インターフェイスで変更のコミットやプッシュなどの Git コマンドを実行できます。 詳しくは、「GitHub Desktop について」をご覧ください。

このガイドの終わりまでに、 GitHub Desktop を使用してリポジトリを作成し、リポジトリに変更を加え、変更を GitHub に発行します。

GitHub Desktopをインストールし、GitHubまたはGitHub Enterpriseにサインインしたら、チュートリアル リポジトリを作成して複製できます。 このチュートリアルでは、テキスト エディターのインストール、ブランチの作成、コミット、GitHubへのプッシュ、pull request のオープンなど、Git とGitHubの操作の基本について説明します。 このチュートリアルは、 GitHub Desktop にリポジトリがまだない場合に使用できます。

チュートリアルを完了することをお勧めしますが、新しいリポジトリを作成して GitHub Desktop を調べる場合は、 GitHub Desktop を使用して Git リポジトリを操作する方法について説明します。

パート 1: GitHub Desktop のインストールとアカウントの認証

サポートされている任意のオペレーティング システムに GitHub Desktop をインストールできます。 アプリをインストールしたら、チュートリアル リポジトリを作成して複製する前に、 GitHub または GitHub Enterprise でサインインしてアカウントを認証する必要があります。

インストールと認証について詳しくは、「GitHub Desktopの設定方法」をご覧ください。

パート 2: 新しいリポジトリを作成する

GitHub Desktopに関連付けられているリポジトリがない場合は、"始めましょう" というメッセージが表示されます。 表示され、チュートリアル リポジトリの作成と複製、インターネットからの既存のリポジトリの複製、新しいリポジトリの作成、またはハード ドライブからの既存のリポジトリの追加を選択できます。

チュートリアルリポジトリの作成とクローン

GitHub Desktopの使用を練習する最初のプロジェクトとして、チュートリアル リポジトリを作成して複製することをお勧めします。

1. [Create a Tutorial Repository] (チュートリアル リポジトリの作成) をクリックします。
2. チュートリアルの指示に従って、テキスト エディターのインストール、ブランチの作成、ファイルの編集、コミット、 GitHubへの発行、pull request のオープンを行います。

新しいリポジトリの作成

チュートリアルリポジトリを作成してクローンしない場合は、新しいリポジトリを作成できます。

1. [Create a New Repository on your Hard Drive] (ハード ドライブに新しいリポジトリを作成する) をクリックします。
2. [Create a New Repository] (新しいリポジトリの作成) ウィンドウのフィールドに入力し、任意のオプションを選びます。
   • "Name" は、ローカルと GitHubの両方でリポジトリの名前を定義します。
   • [Description] はオプションのフィールドで、リポジトリの目的に関する情報を提供するために使うことができます。
   • [Local path] は、お手元のコンピューターにおけるリポジトリの場所を設定します。 既定では、GitHub Desktopは 、リポジトリ_を格納するために Documents フォルダー内に_GitHub フォルダーを作成しますが、コンピューター上の任意の場所を選択できます。 新しいリポジトリは、選択した場所の中のフォルダになります。 たとえば、リポジトリに Tutorial という名前を付けた場合、ローカル パスで選択したフォルダー内に Tutorial という名前のフォルダーが作成されます。 GitHub Desktop は、次回新しいリポジトリを作成または複製するときに選択した場所を記憶します。
   • README を使用してこのリポジトリを初期化すると、README.md ファイルを使用して初期コミットが作成されます。 README は、人々がプロジェクトの目的を理解するために役立つので、これを選択して、README に役立つ情報を記載することをおすすめします。 誰かが GitHubでリポジトリにアクセスすると、プロジェクトについて学習するときに README が最初に表示されます。 詳しくは、「リポジトリの README ファイルについて」をご覧ください。
   • [Git 無視] ドロップダウン メニューでは、バージョン コントロールで保存したくない、ローカル リポジトリ内で無視するファイルを指定するためのカスタム ファイルを追加できます。 特定の言語またはフレームワークを使用する場合、利用できるリストからオプションを選択できます。 まだ始めたばかりの場合は、この選択について無視して構いません。 詳しくは、「ファイルを無視する」をご覧ください。
   • [ライセンス] ドロップダウン メニューを使用すると、リポジトリ内の LICENSE ファイルにオープンソース ライセンスを追加できます。 ライセンスをすぐに追加する必要はありません。 使用可能なオープンソース ライセンスと、それらをリポジトリに追加する方法について詳しくは、「リポジトリのライセンス」をご覧ください。
3. [Create repository] (リポジトリの作成) をクリックします。

パート 3: 探索 GitHub Desktop

画面の上部にあるファイル メニューで、 GitHub Desktopで実行できる設定とアクションにアクセスできます。 作業の効率化のため、ほとんどのアクションにはキーボードショートカットも設定されています。 すべてのキーボード ショートカットの一覧については、「GitHub Desktop キーボード ショートカット」をご覧ください。

GitHub Desktop リポジトリ バー

GitHub Desktop アプリの上部に、リポジトリの現在の状態を示すバーが表示されます。

• Current repository には、作業中のリポジトリの名前が表示されます。 [ 現在のリポジトリ ] をクリックすると、 GitHub Desktop内の別のリポジトリに切り替えることができます。
• [Current Branch] には、作業中のブランチの名前が表示されます。 [Current Branch] をクリックすると、リポジトリ内のすべてのブランチの表示、別のブランチへの切り替え、新しいブランチの作成を行うことができます。 リポジトリに pull request を作成したら、 [Current Branch] をクリックして表示することもできます。
• リポジトリ をまだ GitHub に発行していないため、リポジトリの発行が表示されます。これは、後で次の手順で行います。 バーのこのセクションは、現在のブランチとリポジトリのステータスに基づいて変更されます。 ローカルリポジトリとリモートリポジトリの間でデータを交換できるようにする、さまざまなコンテキスト依存のアクションが利用可能になります。

変更と履歴

左側のサイドバーには、 [変更] ビューと [履歴] ビューがあります。

• [変更] ビューは、現在のブランチで変更を行い、まだローカル リポジトリにコミットしていないファイルが表示されます。 下部には、[概要] テキスト ボックスと [説明] テキスト ボックスと [Commit to BRANCH](BRANCH へのコミット) ボタンが表示されたボックスがあります。 これが、新しい変更をコミットする場所です。 [Commit to BRANCH](BRANCH へのコミット) ボタンは動的であり、変更をコミットするブランチが表示されます。
• [履歴] ビューには、リポジトリの現在のブランチにおける以前のコミットが表示されます。 リポジトリの作成時に GitHub Desktop によって作成された "初期コミット" が表示されます。 コミットの右側には、リポジトリの作成時に選んだオプションに応じて、 .gitattributes、 .gitignore、LICENSE、または README ファイルが表示される場合があります。 各ファイルをクリックすると、そのファイルの diff が表示できます。これは、コミットでファイルに行った変更を示すものです。 差分には、ファイル全体の内容ではなく、変更を行った部分のみが表示されます

パート4: リポジトリをGitHubに公開する

新しいリポジトリを作成する場合、そのリポジトリはコンピュータ上にのみ存在し、自分だけがアクセスできます。 リポジトリを GitHub に発行して、複数のコンピューター間で同期を維持し、他のユーザーがアクセスできるようにすることができます。 リポジトリを発行するには、ローカルの変更を GitHubにプッシュします。

1. リポジトリ バーの [リポジトリの発行] をクリックします。

1. [リポジトリの発行] ウィンドウで、新しいリポジトリの詳細を入力します。
   • GitHub Desktop では、リポジトリの作成時に入力した情報が [名前] フィールドと [説明] フィールドに自動的に入力されます。
   • [このコードを非公開のままにする] では、プロジェクトを表示できるユーザーを制御できます。 このオプションをオフのままにすると、 GitHub の他のユーザーがコードを表示できるようになります。 このオプションを選択すると、コードは公開されなくなります。
   • [組織] ドロップダウン メニューがある場合は、GitHubに属している特定の組織にリポジトリを発行できます。
   1. [リポジトリの発行] をクリックします。
   2. GitHub内からGitHub Desktop上のリポジトリにアクセスできます。 ファイル メニューの [リポジトリ] をクリックし、 [GitHub 上で表示] をクリックします。 デフォルトブラウザで、リポジトリに直接移動します。

パート 5: 変更の作成、コミット、プッシュ

これまでの手順でリポジトリを作成して公開したら、プロジェクトに変更を加えて、リポジトリへの最初のコミットを作成することができます。

1. GitHub Desktop内から外部エディターを起動するには、[GitHub Desktop] メニュー バーで [リポジトリ] を選択し、[エディターで開く] をクリックします。 詳しくは、「GitHub Desktop での既定のエディターの構成」をご覧ください。

1. 以前に作成した README.md ファイルに変更を加えます。 何を行うのか、なぜ役立つのかなど、プロジェクトを説明する情報を追加できます。 変更が完了したら、テキストエディタに保存します。
2. GitHub Desktopで、[変更] ビューに移動します。 ファイル リストに、README.md が表示されます。 README.md ファイルの左側にあるチェックボックスは、ファイルに加えた変更がコミットの一部になることを示しています。 今後、複数のファイルに変更を行って、そのうちの一部のファイルのみの変更をコミットしたい場合があるかもしれません。 ファイルの横にあるチェックボックスをクリックすると、そのファイルはコミットに含まれません。

1. [変更] リストの下部に、コミット メッセージを入力します。 プロフィール画像の右側で、コミットについて簡潔な説明を入力します。 ここでは README.md ファイルを変更するので、「プロジェクトの目的に関する情報を追加する」などがコミットの概要として良いかもしれません。 概要の下に、コミットの変更詳しい説明を入力できる [Description] テキストフィールドが表示されます。これは、プロジェクトの履歴を振り返ったり、変更理由を確認するときに役立ちます。 今は README.md ファイルの基本的な更新を行っているところなので、この内容は飛ばしてもかまいません。

1. コミット メッセージの下にある [Commit to BRANCH NAME] (<ブランチ名> にコミット) をクリックします。 コミットボタンには現在のブランチが表示されるので、必要なブランチに確実にコミットできます。
2. 変更を GitHub 上のリモートリポジトリにプッシュするには、origin へプッシュ をクリックします。

• [プッシュ配信元] ボタンは、リポジトリをGitHubに発行するためにクリックしたボタンと同じです。 このボタンは、Git ワークフローの現在の場所に基づいてコンテキストが変わります。 Push origin と、その横に 1 が表示されるはずです。これは、GitHub にまだプッシュされていないコミットが 1 つあることを示しています。
• origin へプッシュの「origin」は、origin という名前のリモートに変更をプッシュしていることを意味します。この場合、そのリモートは GitHub 上にあるあなたのプロジェクトのリポジトリです。 新しいコミットを GitHubにプッシュするまで、コンピューター上のプロジェクトのリポジトリと、 GitHub上のプロジェクトのリポジトリに違いがあります。 これにより、ローカルで作業し、準備ができたら変更を GitHub にのみプッシュできます。

1. [変更] ビューの右側のウィンドウに、次に実行できるアクションの候補が表示されます。 ブラウザーでGitHubでリポジトリを開くには、GitHubの [表示] をクリックします。

1. ブラウザーで、2 件のコミット をクリックします。 GitHubに、このリポジトリ内のコミットの一覧が表示されます。 最初のコミットは、 GitHub Desktopで行ったコミットである必要があります。

まとめ

これで、リポジトリを作成し、リポジトリを GitHubに発行し、コミットを行い、変更を GitHubにプッシュしました。 作成やコラボレーションを行う他のプロジェクトに貢献するときに、これと同じワークフローを使用することができます。

参考資料

• Git の基礎
• GitHubについて学習する
• GitHubドキュメントの始め方