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

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

GitHub Desktop を使って、コマンドラインを使用せずに Git リポジトリを作成および管理できます。

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

はじめに

GitHub Desktop は、コマンドライン上でテキストコマンドを使うのではなく、ビジュアルインターフェースを使って、あなたの GitHub.com ワークフローを拡張し簡略化します。 このガイドをとおして、GitHub Desktop を使用してリポジトリを作成し、リポジトリに変更を加え、最後に変更を GitHub に公開するところまでを行います。

GitHub Desktop をインストールし、GitHub または GitHub Enterprise にサインインした後、チュートリアルリポジトリを作成してクローンできます。 チュートリアルでは、テキストエディタのインストール、ブランチの作成、コミットの作成、GitHub.com へのプッシュ、プルリクエストの開始など、Gitと GitHub で作業するための基本をご紹介します。 チュートリアルは、GitHub Desktop にリポジトリが未作成の場合に利用できます。

チュートリアルを最後まで完了することをお勧めしますが、新しいリポジトリを作成することで GitHub Desktop を学ぶ場合は、このガイドで GitHub Desktop を使用して Git で作業する方法を説明します。

パート 1: GitHub Desktop をインストールしてアカウントを認証する

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

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

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

GitHub Desktop に関連付けられたリポジトリがない場合は、「Let's get started!」ビューが表示されます。ここでは、チュートリアルリポジトリの作成と複製、インターネットからの既存のリポジトリの複製、新しいリポジトリの作成、またはハードドライブからの既存のリポジトリの追加を選択できます。 さあ、始めましょう! screen

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

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

  1. [Create a tutorial repository and clone it] をクリックします。
    [Create and clone a tutorial repository] ボタン
  2. チュートリアルのプロンプトに従って、テキストエディタのインストール、ブランチの作成、ファイルの編集、コミットの作成、GitHub への公開、プルリクエストのオープンを行います。

新しいリポジトリの作成

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

  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 メニューバー

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

  • [Current repository] では、現在作業中のリポジトリ名が表示されます。 [Current repository] をクリックすると、GitHub Desktop の別のリポジトリに切り替えることができます。

  • [Current branch] では、作業中のブランチ名が表示されます。 [Current branch] をクリックすると、リポジトリ内のすべてのブランチの表示、別のブランチへの切り替え、新しいブランチの作成ができます。 リポジトリにプルリクエストを作成すると、[Current branch] をクリックしてプルリクエストを表示することもできます。

  • [Publish repository] が表示されるのは、まだリポジトリを GitHub に公開していないためです。これについては、次のステップで扱います。 バーのこのセクションは、現在のブランチとリポジトリのステータスに基づいて変更されます。 ローカルリポジトリとリモートリポジトリの間でデータを交換できるようにする、さまざまなコンテキスト依存のアクションが利用可能になります。

    GitHub Desktop を探索する

変更と履歴

左サイドバーには、[Changes] ビューと [History] ビューが表示されています。 [Changes] および [History] タブ

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

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

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

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

  1. メニューバーの [Publish repository] をクリックします。

    [Publish repository]

    • GitHub Desktop は、リポジトリの作成時に入力した情報を [Name] フィールドと [Description] フィールドに自動的に入力します。
    • [Keep this code private] を使用すると、プロジェクトを表示できるユーザを制御できます。 このオプションを選択していない場合、GitHub の他のユーザがあなたのコードを表示できるようになります。 このオプションを選択すると、コードは公開されなくなります。
    • [Organization] ドロップダウンメニューがある場合は、GitHub で所属している特定の Organization にリポジトリを公開できます。

    [Publish repository] のステップ

  2. Publish Repositoryボタンをクリックします。

  3. GitHub Desktop から GitHub.com のリポジトリにアクセスできます。 ファイルメニューで、[Repository] をクリックしてから [View on GitHub] をクリックしてください。 デフォルトブラウザで、リポジトリに直接移動します。

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

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

  1. GitHub Desktop 内から外部エディタを起動するには、[Repository] をクリックしてから [Open in EDITOR] をクリックします。 詳しい情報については、「デフォルトエディタを設定する」を参照してください。

    [Open in editor]

  2. 以前作成した README.md ファイルにいくつかの変更を加えます。 何を行うのか、なぜ役立つのかなど、プロジェクトを説明する情報を追加できます。 変更が完了したら、テキストエディタに保存します。

  3. GitHub Desktop で、[Changes] ビューに移動します。 ファイルのリストに、README.md が表示されているはずです。 README.md ファイルの左側にあるチェックマークは、ファイルに加えた変更がコミットの一部になることを示しています。 今後、複数のファイルに変更を行って、そのうちの一部のファイルのみの変更をコミットしたい場合があるかもしれません。 ファイルの横にあるチェックマークをクリックすると、そのファイルはコミットに含まれません。

    変更を表示する

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

    コミットメッセージ

  5. [Commit to BRANCH NAME] をクリックします。 コミットボタンには現在のブランチが表示されるので、必要なブランチに確実にコミットできます。

    ブランチへのコミット

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

    [Push origin]

  • [Push origin] ボタンは、リポジトリを GitHub に公開する際にクリックしたボタンと同じです。 このボタンは、Git ワークフローの現在の場所に基づいてコンテキストが変わります。 ボタンが Push origin に変わり、横に 1 と表示されます。これは、GitHub にプッシュされていないコミットが 1 つあることを示しています。
  • Push origin の「origin」は、origin というリモートに変更をプッシュしていることを示しています。この場合は、GitHub.com 上のプロジェクトのリポジトリです。 GitHub に何か新しいコミットをプッシュするまで、お手元のコンピューターにあるプロジェクトのリポジトリと、GitHub.com にあるプロジェクトのリポジトリには違いがあります。 これにより、ローカルで作業し、準備ができたときにのみ変更を GitHub.com にプッシュできます。
  1. [Changes] ビューの右側のウィンドウに、次に実行可能なアクションの提案が表示されます。 ブラウザで GitHub のリポジトリを開くには、[View on GitHub] をクリックします。
    利用可能なアクション
  2. ブラウザで、[2 commits] をクリックします。 GitHub にあるリポジトリの、コミットのリストが表示されます。 最初のコミットは、GitHub Desktop で行ったコミットである必要があります。
    2 つのコミットをクリック

おわりに

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

参考リンク

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.