はじめてのGitHub

紙ひこうきの作り方に材料を書き足したとします。前の作り方と書き足した材料の両方を見返せると便利です。GitHub(ギットハブ)では、作品のファイルと変更の記録をインターネット上にまとめて置けます。

作品と変更の記録を、GitHubへ届ける左のパソコンで工作ノートを作り、中央に変更の記録を残して、右のGitHubの作品箱に送る図。 自分のパソコン 変更の記録 GitHub 作品の箱 ネット上に置ける
自分のパソコン

作品を作って、
変更の記録を残す。

作品と記録を届ける
ネットのGitHub

作品の箱で、
記録も一緒に保管。

作品だけでなく、「いつ・何を変えたか」も一緒に。
最初のページを読むプログラミングを知らなくてもOK
目次から選ぶ

「前の作品、どこだっけ?」をなくす

まずは、GitHubがあるとうれしい理由から。

「工作ノート_最新.txt」を直して、次に「工作ノート_本当に最新.txt」を作ったとします。次の日にどちらを開けばよいか迷います。Gitを使うと、同じ名前のファイルに対して、いつ何を変えたかを記録できます。

ファイルを増やすと…工作ノート.txt工作ノート_最新.txt工作ノート_本当に最新.txt
変更の記録をつけると…工作ノート.txt
はじめの説明を書いた
材料を追加した
作り方をわかりやすくした
1つの作品に変更の記録を残す前の内容を開いたり、今の内容と見比べたりできます。このように、作品がどう変わったかを記録して扱うことをバージョン管理と呼びます。

Git(ギット)

変更を記録する道具

パソコンの中で、ファイルがどう変わったかを記録する道具。たとえば「材料に色えんぴつを足した」と記録を残せます。

GitHub(ギットハブ)

作品と記録を置くサービス

ファイルとGitの記録をネット上に置けるサービスです。見ることを許可した人も、同じ記録を見て相談できます。

参考:Gitについて(GitHub公式)。このノートの工作・箱・足あとは、理解のためのたとえです。

ブラウザーで使う準備

ブラウザーは、ChromeやEdgeなど、Webページを開くアプリです。

登録できる年齢を先に確認GitHubの利用者は13歳以上である必要があります。国によっては最低年齢がさらに高くなります。登録せずに試したいときは、履歴の練習や送る・受け取る練習に進めます。
  1. GitHubの登録ページを開く

    GitHubのアカウント作成ページを開こう。アカウントは、自分用の「利用者の名札」だよ。持っている人は Sign in(ログイン)でOK。

  2. 画面の案内にそって登録する

    メールアドレス・パスワード・ユーザー名などを入力する。ユーザー名は作品のURLにも使うので、本名や学校名を入れずに考えよう。GoogleやAppleで登録する方法もあるよ。

  3. メールを確認して、ログインする

    届いた確認メールや確認コードで、自分のメールアドレスだと確かめる。この教材の練習は、無料のアカウントで始められるよ。

作品の箱は、「誰に見せるか」を選べる

Public(公開)

インターネット上の誰でも見られる。作品をみんなに見せたいとき。

確認:アカウント作成 / 利用規約・年齢の条件 / 公開範囲(GitHub公式)

自分の「作品の箱」を作ろう

箱の名前は、リポジトリ。略して「リポ」と呼ぶ人もいるよ。

リポジトリは、1つの作品のファイルと変更の記録をまとめる場所です。紙ひこうきなら、作り方の文章や折り方の写真を一緒に入れられます。この練習では my-craft-note という名前にします。

  1. 右上の「+」から、新しい箱を作る

    New repository(新しいリポジトリ)を選ぶ。すぐに作成画面を開くなら、新しいリポジトリのページへ。

  2. 箱の名前と公開範囲を決める

    Repository name に my-craft-note と入力。公開範囲は Private にする。

  3. 説明書をつけて、作成する

    Add a README file を有効にして、Create repository を押す。ライセンスや .gitignore は、この練習では設定しなくて大丈夫。

my-craft-notePrivate
README(リードミー)は、作品の説明書。README.md というファイルに、「どんな作品か」「どう使うか」を書く。箱を開いた人に、最初に読んでもらいたい説明だよ。

手順:最初のリポジトリを作る(GitHub公式)。ここで示す画面は操作場所を学ぶための図です。実際の見た目や並びは変わることがあります。

直したら、「何を変えたか」を記録

コミットは、選んだ変更をGitの履歴に残す操作です。「材料に色えんぴつを足した」のように、何を変えたかも書けます。

さっきの説明書を、工作ノートにしてみよう。
ブラウザーで、次の順番に操作するよ。

  1. README.mdを開き、鉛筆のボタンを押す

    箱の Code 画面で README.md を選ぶ。鉛筆の形の Edit this file(このファイルを編集) を押そう。

  2. 説明を書きかえる

    編集欄を、下の文章にしてみよう。# は「見出し」、- は「箇条書き」のしるし。プログラムを書かなくても使えるよ。

    README.md / 入力する例
    # わたしの工作ノート
    
    紙ひこうきの作り方をまとめます。
    
    ## 材料
    - 折り紙を1枚
  3. コミットする

    Commit changes…(変更を記録) を押す。短い説明に「工作の説明と材料を書いた」と入力する。ここでは main を普段使うブランチ(変更の流れ)の名前とします。自分の練習用なので、Commit directly to the main branch を選んで main に記録します。最後に Commit changes を押します。

  4. もう一度直して、履歴を見る

    材料に - 色えんぴつ を1行追加して、「色えんぴつを追加した」とコミット。ファイルの History(履歴) から、前の記録や変更内容を見てみよう。

図で体験

前の記録を、開いてみよう

下のボタンで表示を切り替えられるよ。実際のファイルは変わりません。

README.md / 選んだ記録の中身
# わたしの工作ノート

紙ひこうきの作り方をまとめます。

## 材料
- 折り紙を1枚
- 色えんぴつ

記録2:色えんぴつを追加した。前の記録も残っています。

「見る」と「元に戻す」は、別の操作。古い記録を開くだけでは、今の作品は変わらないよ。前の内容に戻したいときは、必要な内容を今のファイルへ書き直して、もう一度コミットするとわかりやすい。
ここまでで、最初の一歩はできた!ブラウザーの編集画面でコミットすると、記録はGitHub上に作られる。ブラウザー編では、あとからPushする操作は必要ないよ。

手順:ファイルを編集する / ファイルと履歴を見る(GitHub公式)

パソコンの作品も、届けよう

ここからはWindows編。GitHub Desktopを使うよ。

いつものエディターで作品を作りたいなら、GitHub Desktop(ギットハブ・デスクトップ)が便利。Gitの操作をボタンで行えるアプリだよ。

  1. 公式サイトからインストールする

    GitHub Desktopの公式サイトでWindows用をダウンロードし、ファイルを開いてインストールする。この練習では、Gitを別に入れる手順は不要だよ。

  2. 自分のGitHubへログインする

    起動して Sign in to GitHub.com を選ぶ。ブラウザーで自分のアカウントを確認し、承認してアプリへ戻る。設定から行う場合は File → Options → Accounts を開く。

  3. 記録につける名前とメールを確認する

    Configure Git の案内にそって設定する。あとから確認する場所は File → Options → Git。この名前とメールアドレスは「誰が直したか」を記録するために使います。普段使うメールアドレスを公開したくない場合は、GitHubのメール設定にある公開用の代わりのアドレス(noreply)を選べます。

最初の1回は、箱をパソコンへ持ってくる

これを Clone(クローン) という。作品のファイルとGitの履歴を、パソコンにコピーする操作だよ。

File → Clone repository…

コピーする箱を選ぶ画面を開く。

GitHub.com

自分の my-craft-note を選ぶ。

Local path → Clone

保存先のフォルダーを選び、コピー。

保存先の例:C:\Users\自分の名前\Documents\GitHub\my-craft-note。ここで選んだフォルダーのファイルを編集しよう。

いつもの作業は、この4つ。作業を始める前に Fetch origin でネット側の更新を確認。Pull origin が出たら取り込んでから、次に進もう。
1直して保存

メモ帳などでファイルを直し、保存する。

2変更を確認

Desktopの Changes で、変えた内容を確認。

3Commit

Summary に説明を入れ、Commit to main。

4Push origin

記録をネットのGitHubへ送る。

パソコンでコミットしただけでは、まだ届かない。Commit = パソコンの中に記録。
Push = その記録をGitHubへ送る。
送ったあとは、ブラウザーで同じ箱を開き直して確認しよう。

手順:Desktopの導入 / クローン / コミット / Push / 記録に使うメール(GitHub公式)

ボタンを押して、違いを見てみよう

保存・Commit・Push・Pull。どこの箱が変わるかな?

パソコンの箱と、GitHubの箱。はじめは同じ内容だよ。
①から順に押して、「はさみ」と「のり」を追加してみよう。

このページだけの練習

工作ノートを、やり取りしよう

本物のGitHubやパソコンのファイルには影響しません。

v1=折り紙v2=+はさみv3=+のり
自分のパソコン

保存したファイル

v1:折り紙

コミット済みの記録

v1まで記録

ネットのGitHub

ネット側のファイル

v1:折り紙

ネット側の記録

v1まで記録

まずは①。パソコンで、材料を追加しよう。自分のパソコンもGitHubも、v1。両方の内容がそろっています。
Push(プッシュ)は、送る。家のパソコンで「材料にはさみを足した」とコミットしたら、Pushでその記録をGitHubへ送ります。
Pull(プル)は、受け取る。ブラウザーで「のり」を足してコミットしたら、Pullでその記録を自分のパソコンへ取り込みます。

Desktopでは、まず Fetch origin で新しい記録があるか確認し、必要な場合に Pull origin を押す。この練習の⑤は、その流れをひとつにまとめています。

参考:記録を送る / ブランチを同期する(GitHub公式)。練習では、同じ場所を別々に直していない、単純なやり取りを示しています。

今の作品を残したまま、別の案を試す

新しい折り方を試す例で、ブランチ、プルリクエスト、マージの順に見ていきます。

「紙ひこうきを、もっと遠くへ飛ばしたい!」
今の作り方をすぐに変えずに、お試し用の道で新しい折り方を考えよう。

ブランチで試して、mainへ合流するmainの記録からtry-wingsという試す道を分ける。新しい折り方をコミットし、プルリクエストで確認してから、マージでmainへ取り込む。main:ふだん使う道try-wings:新しい折り方を試す道PRで「確認してね」マージで合流前の折り方
main(メイン)は、この例の中心になるブランチの名前。試す道の変更は、合流させるまでmainには入らない。

Branch:試す道を分ける

元の作品を残しながら、別の案を作れる。途中で案をやめることもできるよ。

Pull request:変更の相談

「新しい折り方を本番の作り方に入れていい?」と提案する機能です。略してPRと呼びます。ほかの人は、変わった箇所を見て意見を書けます。

Merge:変更を取り込む

確認できたら、試した変更をmainへ合流させる。試す道を作っただけでは、合流しない。

ブラウザーで、この流れを試す手順
  1. 自分の箱で main の選択欄を開き、try-wings と入力して、新しいブランチを作る。
  2. try-wings を選んだままREADMEを編集し、そのブランチへコミットする。
  3. Pull requests → New pull request を開く。取り込み先の base を main、変更元の compare を try-wings にする。
  4. 違いを確かめ、Create pull request で提案を作る。
  5. 内容を確認し、取り込める状態なら Merge pull request → Confirm merge で合流する。mainに切り替えて結果を見よう。

自分の練習用の箱で試そう。チームの箱では、そのチームの確認手順にそって進めてね。

Pull と Pull request は、役割が違う。Pull は「記録を自分のパソコンへ取り込む操作」。
Pull request は「この変更を取り込んでほしい、という提案」。名前は似ているけれど、分けて覚えよう。

参考:ブランチ作成からプルリクエスト・マージまで(GitHub公式)

困ったら、このページを開こう

操作名を忘れたらミニ辞典を見て、思い出せたかクイズで確かめましょう。

ことばのミニ辞典

Repository / リポジトリ
作品のファイルと変更の記録をまとめる箱。
README / リードミー
「どんな作品か」を伝える説明書。
Commit / コミット
何を変えたか、説明をつけて残す記録。
Clone / クローン
作品とGitの履歴をパソコンへコピーすること。
Push / プッシュ
パソコンでコミットした記録をネットへ送ること。
Fetch / フェッチ
ネットの記録を受け取って調べること。作業中のブランチへの取り込みは、Pullなどで行う。
Pull / プル
ネットの新しい記録を、自分のブランチへ取り込むこと。
Branch / ブランチ
別の案を試せる、記録の分かれ道。
Pull request / PR
変更を取り込もう、と確認・相談する提案。
Merge / マージ
別の道の変更を、目的の道に取り込むこと。
手元にある画像や文章も入れられる?

入れられるよ。自分の箱の Code 画面で Add file → Upload files を選び、ファイルを追加してコミットする。Desktopなら、クローンしたフォルダーへファイルを入れて、Commit → Push。

ブラウザーの通常アップロードは1ファイル25 MiBまで。大きな動画などには別の方法が必要になるよ。

ファイルの追加(GitHub公式)

ZIPをダウンロードするのと、Cloneは同じ?

ZIP は、そのときの作品ファイルをまとめてもらう方法。Gitの変更履歴や、Push・Pullするための設定は入っていない。

Clone は、作品とGitの履歴をコピーする方法。GitHubとのやり取りを続けたいならCloneが便利だよ。

ソースコードのアーカイブ / リポジトリをクローン(GitHub公式)

ほかの人の作品を、自分の箱で試したい

Fork(フォーク) は、元の作品をもとに、自分のGitHubに別のリポジトリを作ること。Cloneはパソコンへのコピー、ForkはGitHub上で自分用の箱を作る、と覚えよう。

他人の作品の利用・配布は、その作品のライセンスを確認してね。Publicだから何にでも自由に使える、という意味ではないよ。

Forkについて / ライセンス(GitHub公式)

GitHubを使えば、全部が自動で保存される?

パソコンで直した内容を記録するには、ファイル保存とCommitが必要。ネットへ届けるには、さらにPushが必要だよ。ファイルを置いただけでは、自動ですべての変更が送られるわけではない。

送る前に、パスワード・APIキー・住所などが入っていないか確かめよう。Privateの箱でも、秘密の鍵は入れない。もし送ってしまったら、その鍵を無効にして作り直す。今のファイルから消すだけでは、履歴に残る場合があるよ。

秘密情報を送ってしまったとき(GitHub公式)

Pushできない・「Conflict」と出たら?

まず、正しいアカウント・箱・ブランチを選んでいるか、ネットにつながっているかを確かめよう。ネット側に新しい記録があるなら、Fetchして状況を確認する。

Conflict(コンフリクト) は、「同じ場所を別々に直したので、どちらの内容にするか決めてほしい」という合図。両方の変更を見て、残す内容を決めてから続ける。大事な作業なら、内容を控えて詳しい人と確認しよう。

コンフリクトについて(GitHub公式)

不具合や、やりたいことをメモしたい

Issue(イシュー) は、作品についての「やることメモ・相談の場所」。箱の Issues → New issue から、起きたことや、してほしいことを書ける。Issueを作るだけでは、作品のファイルは変わらないよ。

Issueの作成(GitHub公式)

3問だけ、確認

ちゃんと届くのは、どのとき?

答えを選んで、下の「答え合わせ」を押してね。

1. DesktopでCommitした直後。記録はどこにある?
2. GitHubに増えた記録を、自分のブランチへ取り込みたい。
3. 今の作り方を残して、別の折り方を試したい。

明日使うときは、この順番。

Fetch・必要ならPull直して保存CommitPush

「作品の箱」と「足あとの記録」。
この2つがわかれば、もう最初の一歩を踏み出せるよ。