ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

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

GitHub Desktop を使って、コマンドラインを使わずに素早く Git リポジトリで作業できます。

ここには以下の内容があります:

はじめに

このガイドは、GitHub Desktop を使って Git リポジトリで作業する手順を一通り案内します。 GitHub Desktop は、コマンドライン上でテキストコマンドを使うのではなく、ビジュアルインターフェースを使って、あなたの GitHub.com ワークフローを拡張し簡略化します。 このガイドが終わるまでに、GitHub Desktop でリポジトリを作成し、リポジトリで変更を行い、GitHub.com または GitHub Enterprise Server に変更を公開することになります。

GitHub Desktop をダウンロードし、GitHub または GitHub Enterprise にサインインした後は、チュートリアルリポジトリを作成およびクローンできます。 チュートリアルは、エディタのインストール、コミットの作成、GitHub.com へのプッシュ、プルリクエストの作成など、Git および GitHub で作業するための基本を紹介します。 チュートリアルは、GitHub Desktop にリポジトリが存在しない状態である限り利用できます。

ステップ 1. GitHub Desktop のインストールとサインイン

  1. https://desktop.github.com/ から GitHub Desktop をダウンロードします。 GitHub Desktop は、 Windows および macOS の最新バージョンをサポートしています。 お手持ちのオペレーティングシステムにインストールする具体的な方法の詳細は「Installing GitHub Desktop をインストールする」を参照してください。

  2. GitHub Desktop を起動し、画面に表示される手順に従って GitHub アカウントにサインインします。 [Configure Git] ステップが表示されるので、そこで名前とメールアドレスを設定してください。 コミットが GitHub アカウントに確実に関連付けられるようにするため、あなたの GitHub アカウントに関連付けられたメールアドレスを使います。 コミットの属性付けに関する詳細は「コミットメールアドレスを設定する」を参照してください。

ステップ 2. 新しいリポジトリの作成

[Let's get started!] ビューが表示され、チュートリアルリポジトリの作成とクローン、既存のリポジトリをクローン、新しいリポジトリの作成、既存のリポジトリの追加を選択できます。

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

  1. [Create a tutorial repository and clone it] をクリックします。
    [Create and clone a tutorial repository] ボタン
  2. チュートリアルのプロンプトに従います。

新しいリポジトリの作成

  1. [Create a New Repository on your Hard Drive...] をクリックします。
    新しいリポジトリの作成
  2. 新しいリポジトリを作成するには、以下のフィールドに入力します:

    リポジトリの作成オプション

    • [Name] は、ローカルと GitHub の両方で使う、リポジトリの名前を定義します。
    • [Description] はオプションのフィールドで、リポジトリの目的に関する情報を提供するために使うことができます。
    • [Local path] は、お手元のコンピューターにおけるリポジトリの場所を設定します。 デフォルトでは、GitHub Desktop は Documents フォルダの中にGitHub フォルダを作成して、そこにリポジトリを保存しますが、保存するフォルダは任意の場所に設定可能です。 新しいリポジトリは、選択した場所の中のフォルダになります。 たとえば、リポジトリに Tutorial と名付けた場合、選択したローカルパスのフォルダの中に Tutorial という名前のフォルダが作成されます。 GitHub Desktop は、次に新しいリポジトリをクローンするか作成するときに、選択した場所を記憶します。
    • [Initialize this repository with a README] は、最初のコミットを README.md ファイル付きで作成します。 README は、人々がプロジェクトの目的を理解するために役立つので、これを選択して、README に役立つ情報を記載することをおすすめします。 GitHub でリポジトリにアクセスした人は、まず README を読んで、そのプロジェクトについて知ります。 詳細は「README について」を参照してください。
    • [Git ignore] ドロップダウンメニューは、バージョン管理で保存したくない、ローカルリポジトリ内で無視するファイルを指定するためのカスタムファイルを追加します。 特定の言語やフレームワークを使っている場合、利用できるリストからオプションを選択できます。 まだ始めたばかりの場合は、この選択について無視して構いません。 詳細は「ファイルを無視する」を参照してください。
    • [License] ドロップダウンメニューは、リポジトリの LICENSE ファイルにオープンソースライセンスを追加します。 ライセンスをすぐに追加する必要はありません。 利用可能なオープンソースライセンスと、それらをリポジトリに追加する方法についての詳細は「リポジトリのライセンス」を参照してください。
  3. [Create repository] をクリックします。

ステップ 3. GitHub Desktop を探索する

リポジトリを作成したので、画面上部にファイルメニューが表示されます。 この画面で、GitHub Desktop の設定や実行可能なアクションにアクセスできます。 作業の効率化のため、ほとんどのアクションにはキーボードショートカットも設定されています。 キーボードショートカットの一覧は「GitHub Desktop のキーボードショートカット」を参照してください。

  1. 以下のメニューは、GitHub Desktop におけるリポジトリの現在の状態を示すバーです:

    • [Current repository] では、現在作業中のリポジトリ名が表示されます。 [Current repository] をクリックすると、GitHub Desktop の別のリポジトリに切り替えることができます。
    • [Current branch] では、作業中のブランチ名が表示されます。 [Current branch] をクリックすると、リポジトリ内のすべてのブランチの表示、別のブランチへの切り替え、新しいブランチの作成ができます。 リポジトリにプルリクエストを作成すると、[Current branch] をクリックしてプルリクエストを表示することもできます。
    • [Publish repository] が表示されるのは、まだリポジトリを GitHub に公開していないためです。これについては、次のステップで扱います。

    GitHub Desktop を探索する

  2. 左サイドバーには、[Changes] ビューと [History] ビューが表示されています。

    • [Changes] ビューは、現在のブランチで変更を行い、まだローカルリポジトリにコミットしていないファイルが表示されます。 ビューの下部には、[Summary] および [Description] テキストボックスと、[Commit to master] ボタンもあります。 これが、新しい変更をコミットする場所です。 [Commit] ボタンは、変更をどのブランチにコミットしようとしているのかを知らせます。

      コミットエリア

    • [History] ビューには、リポジトリの現在のブランチにおける以前のコミットが表示されます。 リポジトリを作成したときに、GitHub Desktop によって作成された「最初のコミット」が表示されているはずです。 そのコミットの右側に、リポジトリを作成したときのオプションによっては、.gitattributes.gitignoreLICENSEREADME ファイルが表示されているかもしれません。 各ファイルをクリックすると、そのファイルの diff が表示できます。これは、コミットでファイルに行った変更を示すものです。 diff には、ファイル全体の内容ではなく、変更を行った部分のみが表示されます。

      [History] ビュー

ステップ 4. リポジトリの GitHub へのプッシュ

現在のところ、あなたのリポジトリはお手元のコンピューターにのみ存在しており、そのリポジトリにアクセスできるのはあなただけです。 リポジトリを GitHub に公開することで、同じプロジェクトに属する複数のコンピューターやチームメンバー間で同期を保つことができます。 リポジトリを公開するには、GitHub にプッシュします。そうすると、GitHub.com でも利用できるようになります。

  1. [Publish repository] をクリックします。

    [Publish repository]

    • おなじみのフィールドがいくつか表示されます。 [Name] と [Description] は、リポジトリを作成したときに入力したものと一致します。
    • [Keep this code private] というオプションが表示されます。 GitHub の他のユーザに、コードを公にしたくない場合はこのオプションを選択します。
    • [Organization] ドロップダウンメニューが表示されている場合があります。これは、GitHub であなたが所属する特定の Organization にリポジトリを公開するためのものです。 まだ Organization のメンバーでない場合も、何の問題もありません。
      [Publish repository] のステップ
  2. [Publish repository] をクリックします。
  3. GitHub Desktop から GitHub.com のリポジトリにアクセスできます。 ファイルメニューで、[Repository] をクリックしてから [View on GitHub] をクリックしてください。 デフォルトブラウザで、リポジトリに直接移動します。

これでリポジトリが公開されました。GitHub Desktop に戻って、ローカルリポジトリにもっと変更を行いましょう。 まず、デフォルトのテキストエディタを設定する方法を説明します。

ステップ 5. テキストエディタの設定

開発環境の設定にかける時間を節約するために、GitHub Desktop から直接、多くのテキストエディタと統合開発環境 (IDE) を起動できます。 GitHub Desktop のリポジトリから、お好みのテキストエディタでプロジェクトフォルダをシームレスに開けます。

  1. [File] をクリックし、[Options] をクリックしてから、[Advanced] をクリックします。
  2. [External editor] ドロップダウンメニューで、リストからテキストエディタを選択します。 インストール済みの全てのテキストエディタがリストに表示されるはずです。 エディタが何も表示されない場合、 Atom などのサポートされているエディタをインストールしてください。 サポートされているエディタの一覧については、GitHub Desktop リポジトリの[Open External Editor] の統合を参照してください。
    外部エディタ
  3. 新しくエディタをインストールした際は、[External editor] ドロップダウンメニューでエディタを使えるようにするため、GitHub Desktop を再起動します。

ステップ 6. 変更、変更のコミット、変更のプッシュ

デフォルトのエディタが設定でき、いよいよ準備が整いました。それではプロジェクトに変更を行って、リポジトリに最初のコミットを作成しましょう。

  1. GitHub Desktop で外部エディタを起動するには、[Repository] をクリックしてから[Open in EDITOR] をクリックします。

    [Open in editor]

  2. 事前に作成した README.md ファイルに変更を行うことから始めましょう。 何をするのか、なぜ役立つのかなどの、プロジェクトに関する情報を追加します。 これが、プロジェクトに参加する人との最初のやりとりに使われるものであることを念頭におきましょう。 これで最初のコミットを行う準備ができました。

  3. テキストエディタから GitHub Desktop に戻り、[Changes] タブに移動します。 ファイルのリストに、README.md が表示されているはずです。 README.md ファイルの隣についているチェックマークは、ファイルに行った変更が、コミットの一部になることを示しています。 今後、複数のファイルに変更を行って、そのうちの一部のファイルのみの変更をコミットしたい場合があるかもしれません。 GitHub Desktop では、コミットしたい特定の変更を選ぶことができます。

    変更を表示する

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

    コミットメッセージ

  5. [Commit to master] をクリックします。 コミットのボタンは、現在のブランチを表示します。現在の例では master になり、コミットしたいブランチにコミットすることができます。

    [Commit to master]

  6. 変更を GitHub のリモートリポジトリにプッシュするには、[Push origin] をクリックします。

    [Push origin]

    • GitHub にリポジトリを公開したときに使った [Publish] ボタンを覚えていますか。 そのボタンが [Push origin] に変わって、右に 1 と表示されているはずです。これは、GitHub にプッシュしていないコミットが 1 つあることを示しています。
    • [Push origin] の「origin」とは、origin というリモートに変更をプッシュしようとしていることを示しています。この例では、GitHub.com にあるプロジェクトのリポジトリです。 GitHub に何か新しいコミットをプッシュするまで、お手元のコンピューターにあるプロジェクトのリポジトリと、GitHub.com にあるプロジェクトのリポジトリには違いがあります。 これにより、作業はローカルで行って、準備ができた場合にのみ GitHub.com に作業をプッシュすることができます。
  7. [Changes] タブの隣にあるオープンなスペースに、次に行うことについての提案が表示されてています。 GitHub にあるリポジトリをブラウザで開くには、[View on GitHub] をクリックします。

    [View on GitHub]

  8. ブラウザで、[2 commits] をクリックします。 GitHub にあるリポジトリの、コミットのリストが表示されます。 最初のコミットは、つい先ほど GitHub Desktop で行ったコミットのはずです。

    2 つのコミットをクリック

おわりに

おめでとうございます。 ここまでで、リポジトリを作成し、そのリポジトリを GitHub に公開し、コミットを行い、変更をプッシュしました。 ここまで行ってきたことは、GitHub および GitHub Desktop でできるあらゆることのうち、ごく基本的なことだけです。 この練習が、今後のさらなる探求につながれば幸いです。

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください