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

はじめに

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

このガイドを通して、 Desktop を使ってリポジトリを作成し、リポジトリに変更を加え、最後に変更を に公開するところまでを行います。

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

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

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

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

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

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

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

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

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

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

新しいリポジトリの作成

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

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

パート 3: Desktop に触れる

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

Desktop リポジトリ バー

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

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

変更と履歴

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

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

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

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

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

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

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

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

   

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

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

   

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

   

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

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

   
   • [Push origin] ボタンは、リポジトリを に公開する際にクリックしたボタンと同じです。 このボタンは、Git ワークフローの現在の場所に基づいてコンテキストが変わります。 これで、Push origin の横に 1 と表示されるようになりました。これは、 にプッシュされていないコミットが 1 つあることを示します。
   • [オリジンのプッシュ] の「オリジン」とは、origin というリモートに変更をプッシュしていることを指しています。この場合、 のプロジェクトのリポジトリになります。 新しいコミットを にプッシュするまでは、コンピューター上のプロジェクトのリポジトリと 上のプロジェクトのリポジトリの間に差異が生じます。 ローカルで作業し、準備ができたときにのみ変更を にプッシュできるようになります。

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

   

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

   

まとめ

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

参考資料

• Git の基礎
• について学ぶ
• の概要に関するドキュメント