Skip to main content

リポジトリのクイック スタート

新しいリポジトリを作成し、最初の変更を 5 分でコミットする方法について説明します。

Tool navigation

リポジトリを作成する

さまざまなプロジェクトを GitHub リポジトリに保存できます。 このガイドでは、リポジトリを作成し、最初の変更をコミットします。

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

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

  2. 短くて覚えやすいリポジトリ名を入力します。 たとえば、"hello-world" といった名前です。

    GitHub リポジトリを作成するときの最初の手順のスクリーンショット。 [リポジトリ名] フィールドにはテキスト "hello-world" が表示され、濃いオレンジ色の枠線で囲まれています。

  3. 必要に応じて、リポジトリの説明を追加します。 たとえば、「GitHub の最初のリポジトリ」などです。

  4. リポジトリの可視性を選択してください。 詳しくは、「リポジトリについて」を参照してください。

  5. [Initialize this repository with a README] (このレポジトリを README で初期化する) を選択します。

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

おめでとうございます。 最初のリポジトリの作成に成功し、README ファイルで初期化しました。

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

  1. コマンド ラインで、新しいプロジェクトのローカル クローンを作成するディレクトリに移動します。
  2. プロジェクトのリポジトリを作成するには、gh repo create サブコマンドを使用します。 メッセージが表示されたら、 [GitHub に新しいリポジトリを最初から作成する] を選択し、新しいプロジェクトの名前を入力します。 プロジェクトが個人アカウントではなく Organization に属するようにしたい場合は、organization-name/project-name を使って Organization の名前とプロジェクト名を指定します。
  3. 対話型のプロンプトに従います。 リポジトリをローカルに複製するには、リモート プロジェクト ディレクトリを複製するかどうかを確認するメッセージが表示されたら [はい] を選択します。
  4. または、プロンプトをスキップするには、リポジトリ名と可視性フラグ (--public--private、または --internal) を指定します。 たとえば、gh repo create project-name --public のようにします。 リポジトリをローカルに複製するには、--clone フラグを渡します。 使用できる引数の詳細については、GitHub CLI のマニュアルを参照してください。

最初の変更をコミットする

" コミット " とは、特定の時点におけるプロジェクト内のすべてのファイルのスナップショットのようなものです。

新しいリポジトリを作成したので、README ファイルを使って初期化します。 README ファイルは、プロジェクトの詳細を説明し、プロジェクトのインストール方法や使い方などのドキュメントを追加するために適した場所です。 README ファイルの内容は、リポジトリのフロント ページに自動的に表示されます。

README ファイルに変更をコミットしてみましょう。

  1. リポジトリのファイルの一覧で、README.md を選びます。

    リポジトリ内のファイルの一覧のスクリーンショット。 "README.md" というファイル名がオレンジ色の枠線で強調表示されています。

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

ファイルのスクリーンショット。 ヘッダーにある鉛筆アイコンのラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

  1. テキスト ボックスに、ご自分に関する情報をいくつか入力してください。

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

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

  3. ファイルに加えた変更を確認します。 [Diff の表示] を選んだ場合は、新しいコンテンツが緑色で表示されます。

    ファイルの [プレビュー] ビューのスクリーンショット。 [Diff の表示] というラベルの付いたチェックボックスがオンになっており、ファイルへの追加が緑色の行マーカーで示されます。 両方ともオレンジ色の枠線で囲まれています。

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

  5. [コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」を参照してください。

  6. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」を参照してください。

    GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選ばれています。

  7. [変更のコミット] または [変更の提案] をクリックします。

プロジェクトを作成したら、変更のコミットを開始できます。

README ファイルは、プロジェクトの詳細を説明し、プロジェクトのインストール方法や使い方などのドキュメントを追加するために適した場所です。 README ファイルの内容は、リポジトリのフロント ページに自動的に表示されます。 README ファイルを追加するには、次の手順に従います。

  1. コマンド ラインで新しいプロジェクトのルート ディレクトリに移動します。 (このディレクトリは、gh repo create コマンドを実行したときに作成されました。)

  2. プロジェクトに関する情報を含む README ファイルを作成します。

    echo "info about this project" >> README.md
    
  3. git status」と入力します。 追跡されていない README.md ファイルが表示されます。

    $ git status
    
    Untracked files:
      (use "git add <file>..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
    
  4. ファイルをステージングしてコミットします。

    git add README.md && git commit -m "Add README"
    
  5. ブランチに変更をプッシュします。

    git push --set-upstream origin HEAD
    

次の手順

README ファイルを含む新しいリポジトリを作成し、GitHub.com に最初のコミットを作成しました。

  • これで、GitHub リポジトリを複製して、コンピューター上にローカル コピーを作成できるようになりました。 ローカル リポジトリからコミットし、pull request を作成して上流リポジトリで変更を更新できます。 詳細については、「リポジトリをクローンする」および「Git のセットアップ」を参照してください。
  • GitHub で興味深いプロジェクトとリポジトリを見つけ、リポジトリのフォークを作成して変更を加えることができます。 リポジトリをフォークすると、元のリポジトリに影響を与えることなく、別のリポジトリに変更を加えることができるようになります。 詳しくは、「リポジトリをフォークする」を参照してください。

  • GitHub の各リポジトリは、個人または組織が所有しています。 GitHub に接続してフォローすることで、ユーザー、リポジトリ、および組織と対話できます。 詳しくは、「GitHub でのインスピレーションの発見」を参照してください。

  • GitHub には素晴らしいサポート コミュニティがあり、助けを求め、世界中の人々と話すことができます。 GitHub Community で会話に参加してください。