プロジェクトを GitHub にアップロードする

プロジェクトのファイルを GitHub にアップロードする方法について説明します。

この記事の内容

はじめに

このチュートリアルでは、ファイルのグループを GitHub リポジトリにアップロードする方法について説明します。

ファイルを GitHub リポジトリにアップロードすることで、次のことができます。

  • ファイルを編集するときにバージョン管理を適用して、プロジェクトの履歴を保護して管理できます。
  • ファイルがクラウドに保管されるようになるため、作業をバックアップできます。
  • リポジトリを個人プロフィールにピン留めして、他のユーザーがあなたの作品を確認できます。
  • 公開または非公開で作業を共有し、他のユーザーと検討できます。

Git を既に理解していて、ローカルに格納された Git リポジトリを GitHub にアップロードする方法をお求めの場合は、「ローカルでホストされているコードを GitHub に追加する」を参照してください。

前提条件

  • GitHub アカウントを所持している必要があります。 詳細については、「GitHub でのアカウントの作成」を参照してください。
  • アップロードするファイルのグループが必要です。

手順 1: プロジェクトの新しいリポジトリを作成する

作業している個々のプロジェクトごとに新しいリポジトリを作成することをお勧めします。 ソフトウェア プロジェクトを作成する場合は、関連するすべてのファイルを新しいリポジトリにグループ化すると、時間の経過とメインコードベースを簡単に保持および管理できます。

  1. ページの右上隅で を選択し、 [新しいリポジトリ] をクリックします。

    新しいアイテムを作成するオプションを示す GitHub ドロップダウン メニューのスクリーンショット。 [新しいリポジトリ] というメニュー項目が濃いオレンジ色の枠線で囲まれています。

  2. [リポジトリ名] ボックスに、プロジェクトの名前を入力します。 たとえば、「my-first-project」と入力します。

  3. [説明] ボックスに簡単な説明を入力します。 たとえば、「GitHub の最初のプロジェクト」と入力します。

  4. リポジトリが [パブリック] か [プライベート] かを選択します。 他のユーザーがプロジェクトを表示できるようにする場合は、[パブリック] を選択します。

  5. [README ファイルを追加する] を選択します。 このファイルは、後の手順で編集します。

  6. [Create repository] (リポジトリの作成) をクリックします。

手順 2: プロジェクトのリポジトリにファイルをアップロードする

ここまでは、リポジトリに表示される README.md ファイルは 1 つだけです。それは、リポジトリを初期化したときに作成したファイルです。 次に、独自のファイルを数点アップロードします。

  1. ページの右側にある [ファイルの追加] ドロップダウン メニューを選択します。
  2. ドロップダウン メニューの [ファイルのアップロード] をクリックします。
  3. お使いのコンピューターで作業内容を含むフォルダーを開き、すべてのファイルとフォルダーをブラウザーにドラッグ アンド ドロップします。
  4. ページの下部にある [変更のコミット] で、[main ブランチに変更を直接コミットする] を選択後、[変更のコミット] をクリックします。

手順 3: プロジェクトのリポジトリの README ファイルを編集する

通常、リポジトリの README ファイルは、リポジトリにアクセスしたときに誰かが表示する最初の項目です。 通常、プロジェクトの内容と、プロジェクトが役立つ理由に関する情報が含まれています。

「Hello World」チュートリアルで学んだように、README ファイル (README.md) は Markdown 構文で記述されています。 Markdown は、プレーンテキストを書式設定するための読みやすく書きやすい言語です。

この手順では、Markdown を使用してプロジェクトの README.md を編集し、プロジェクトに関する基本情報を記述します。

  1. ファイルの一覧から、README.md をクリックしてファイルを表示します。

  2. ファイル ビューの右上隅にある をクリックしてファイル エディターを開きます。

    • プロジェクトに関するいくつかの情報が事前に入力されています。 たとえば、手順 1 で完了したリポジトリ名とリポジトリの説明が 1 行目と 2 行目に表示されます。

  3. # 以外の既存のテキストを削除し、プロジェクトの適切なタイトルを入力します。

    • 例: # About my first project on GitHub。

  4. 次に、プロジェクトの目的やメイン機能の説明など、プロジェクトに関する情報を追加します。

    Note

    何を書けばいいかわからない場合は、GitHub の他のリポジトリを見て、他のユーザーがプロジェクトをどのように記述しているかを確認してください。

    画像、リンク、脚注の追加など、より高度な書式設定を適用するには、「基本的な書き方とフォーマットの構文」を参照してください。

  5. 新しい内容の上にある [プレビュー] をクリックします。

    編集モードのファイルのスクリーンショット。 ファイルの内容の上の [プレビュー] というラベルのタブが、濃いオレンジ色の枠線で囲まれています。

  6. 変更を保存した後にファイルがどのようにレンダリングされるかを確認したら、[編集] に戻ります。

  7. README の内容に問題がなければ、テキストの編集とプレビューを続行します。

  8. 右上の [変更のコミット] をクリックします。

  9. 開いたダイアログ ボックスでは、コミット メッセージが事前に入力されており ("update README.md")、既定では [main ブランチに直接コミットする] オプションが選択されています。 これらのオプションはそのままにして、[変更のコミット] をクリックします。

まとめ

ここまでに、新しいリポジトリを作成し、それにいくつかのファイルをアップロードし、プロジェクトの README を追加しました。

リポジトリの可視性を [パブリック] に設定すると、リポジトリが個人プロフィールに表示され、リポジトリの URL を他のユーザーと共有できます。

ブラウザーで GitHub のファイルを直接追加、編集、または削除すると、GitHub はこれらの変更 ("コミット") を追跡するため、プロジェクトの履歴と進化の管理を開始できるようになります。

変更を行うときは、リポジトリのブランチから main 新しいブランチを作成できるため、ファイルのメインコピーに影響を与えずに実験できます。 その後、一連の変更に満足したら、プル要求を開いて変更をブランチに main マージします。 これを行う方法のリマインダーについては、「Hello World」を参照してください。

次のステップ

  • ほとんどのユーザーは、ファイルをローカル (自身のコンピューター) で継続的に操作した後に、それらのローカルで行った変更をこの、GitHub の「リモート」(クラウド内で) リポジトリで継続的に同期したいと考えています。 GitHub Desktop など、これを行うために使用できるツールは多数あります。 開始するには、以下が必要です。

  • GitHub でホストされているリポジトリを操作するために使用できる他のツールの詳細については、「GitHub への接続」を参照してください。

参考資料