Git(ギット)
変更を記録する道具パソコンの中で、ファイルがどう変わったかを記録する道具。たとえば「材料に色えんぴつを足した」と記録を残せます。
紙ひこうきの作り方に材料を書き足したとします。前の作り方と書き足した材料の両方を見返せると便利です。GitHub(ギットハブ)では、作品のファイルと変更の記録をインターネット上にまとめて置けます。
作品を作って、
変更の記録を残す。
作品の箱で、
記録も一緒に保管。
まずは、GitHubがあるとうれしい理由から。
「工作ノート_最新.txt」を直して、次に「工作ノート_本当に最新.txt」を作ったとします。次の日にどちらを開けばよいか迷います。Gitを使うと、同じ名前のファイルに対して、いつ何を変えたかを記録できます。
パソコンの中で、ファイルがどう変わったかを記録する道具。たとえば「材料に色えんぴつを足した」と記録を残せます。
ファイルとGitの記録をネット上に置けるサービスです。見ることを許可した人も、同じ記録を見て相談できます。
参考:Gitについて(GitHub公式)。このノートの工作・箱・足あとは、理解のためのたとえです。
ブラウザーは、ChromeやEdgeなど、Webページを開くアプリです。
GitHubのアカウント作成ページを開こう。アカウントは、自分用の「利用者の名札」だよ。持っている人は Sign in(ログイン)でOK。
メールアドレス・パスワード・ユーザー名などを入力する。ユーザー名は作品のURLにも使うので、本名や学校名を入れずに考えよう。GoogleやAppleで登録する方法もあるよ。
届いた確認メールや確認コードで、自分のメールアドレスだと確かめる。この教材の練習は、無料のアカウントで始められるよ。
インターネット上の誰でも見られる。作品をみんなに見せたいとき。
自分や、アクセスを許可した人が見られる。最初の練習は、こちらにしよう。
確認:アカウント作成 / 利用規約・年齢の条件 / 公開範囲(GitHub公式)
箱の名前は、リポジトリ。略して「リポ」と呼ぶ人もいるよ。
リポジトリは、1つの作品のファイルと変更の記録をまとめる場所です。紙ひこうきなら、作り方の文章や折り方の写真を一緒に入れられます。この練習では my-craft-note という名前にします。
my-craft-noteREADMEの項目は、スイッチで表示される場合もあります。
New repository(新しいリポジトリ)を選ぶ。すぐに作成画面を開くなら、新しいリポジトリのページへ。
Repository name に my-craft-note と入力。公開範囲は Private にする。
Add a README file を有効にして、Create repository を押す。ライセンスや .gitignore は、この練習では設定しなくて大丈夫。
README.md というファイルに、「どんな作品か」「どう使うか」を書く。箱を開いた人に、最初に読んでもらいたい説明だよ。手順:最初のリポジトリを作る(GitHub公式)。ここで示す画面は操作場所を学ぶための図です。実際の見た目や並びは変わることがあります。
コミットは、選んだ変更をGitの履歴に残す操作です。「材料に色えんぴつを足した」のように、何を変えたかも書けます。
さっきの説明書を、工作ノートにしてみよう。
ブラウザーで、次の順番に操作するよ。
箱の Code 画面で README.md を選ぶ。鉛筆の形の Edit this file(このファイルを編集) を押そう。
編集欄を、下の文章にしてみよう。# は「見出し」、- は「箇条書き」のしるし。プログラムを書かなくても使えるよ。
# わたしの工作ノート
紙ひこうきの作り方をまとめます。
## 材料
- 折り紙を1枚Commit changes…(変更を記録) を押す。短い説明に「工作の説明と材料を書いた」と入力する。ここでは main を普段使うブランチ(変更の流れ)の名前とします。自分の練習用なので、Commit directly to the main branch を選んで main に記録します。最後に Commit changes を押します。
材料に - 色えんぴつ を1行追加して、「色えんぴつを追加した」とコミット。ファイルの History(履歴) から、前の記録や変更内容を見てみよう。
下のボタンで表示を切り替えられるよ。実際のファイルは変わりません。
# わたしの工作ノート 紙ひこうきの作り方をまとめます。 ## 材料 - 折り紙を1枚 - 色えんぴつ
記録2:色えんぴつを追加した。前の記録も残っています。
手順:ファイルを編集する / ファイルと履歴を見る(GitHub公式)
ここからはWindows編。GitHub Desktopを使うよ。
いつものエディターで作品を作りたいなら、GitHub Desktop(ギットハブ・デスクトップ)が便利。Gitの操作をボタンで行えるアプリだよ。
GitHub Desktopの公式サイトでWindows用をダウンロードし、ファイルを開いてインストールする。この練習では、Gitを別に入れる手順は不要だよ。
起動して Sign in to GitHub.com を選ぶ。ブラウザーで自分のアカウントを確認し、承認してアプリへ戻る。設定から行う場合は File → Options → Accounts を開く。
Configure Git の案内にそって設定する。あとから確認する場所は File → Options → Git。この名前とメールアドレスは「誰が直したか」を記録するために使います。普段使うメールアドレスを公開したくない場合は、GitHubのメール設定にある公開用の代わりのアドレス(noreply)を選べます。
これを Clone(クローン) という。作品のファイルとGitの履歴を、パソコンにコピーする操作だよ。
コピーする箱を選ぶ画面を開く。
自分の my-craft-note を選ぶ。
保存先のフォルダーを選び、コピー。
保存先の例:C:\Users\自分の名前\Documents\GitHub\my-craft-note。ここで選んだフォルダーのファイルを編集しよう。
メモ帳などでファイルを直し、保存する。
Desktopの Changes で、変えた内容を確認。
Summary に説明を入れ、Commit to main。
記録をネットのGitHubへ送る。
☑ README.md
何が変わったかを見よう
「+」や緑色の行は、追加した部分。
手順:Desktopの導入 / クローン / コミット / Push / 記録に使うメール(GitHub公式)
保存・Commit・Push・Pull。どこの箱が変わるかな?
パソコンの箱と、GitHubの箱。はじめは同じ内容だよ。
①から順に押して、「はさみ」と「のり」を追加してみよう。
本物のGitHubやパソコンのファイルには影響しません。
保存したファイル
v1:折り紙
コミット済みの記録
v1まで記録
ネット側のファイル
v1:折り紙
ネット側の記録
v1まで記録
Desktopでは、まず Fetch origin で新しい記録があるか確認し、必要な場合に Pull origin を押す。この練習の⑤は、その流れをひとつにまとめています。
参考:記録を送る / ブランチを同期する(GitHub公式)。練習では、同じ場所を別々に直していない、単純なやり取りを示しています。
新しい折り方を試す例で、ブランチ、プルリクエスト、マージの順に見ていきます。
「紙ひこうきを、もっと遠くへ飛ばしたい!」
今の作り方をすぐに変えずに、お試し用の道で新しい折り方を考えよう。
元の作品を残しながら、別の案を作れる。途中で案をやめることもできるよ。
「新しい折り方を本番の作り方に入れていい?」と提案する機能です。略してPRと呼びます。ほかの人は、変わった箇所を見て意見を書けます。
確認できたら、試した変更をmainへ合流させる。試す道を作っただけでは、合流しない。
try-wings と入力して、新しいブランチを作る。try-wings を選んだままREADMEを編集し、そのブランチへコミットする。main、変更元の compare を try-wings にする。自分の練習用の箱で試そう。チームの箱では、そのチームの確認手順にそって進めてね。
操作名を忘れたらミニ辞典を見て、思い出せたかクイズで確かめましょう。
入れられるよ。自分の箱の Code 画面で Add file → Upload files を選び、ファイルを追加してコミットする。Desktopなら、クローンしたフォルダーへファイルを入れて、Commit → Push。
ブラウザーの通常アップロードは1ファイル25 MiBまで。大きな動画などには別の方法が必要になるよ。
ZIP は、そのときの作品ファイルをまとめてもらう方法。Gitの変更履歴や、Push・Pullするための設定は入っていない。
Clone は、作品とGitの履歴をコピーする方法。GitHubとのやり取りを続けたいならCloneが便利だよ。
Fork(フォーク) は、元の作品をもとに、自分のGitHubに別のリポジトリを作ること。Cloneはパソコンへのコピー、ForkはGitHub上で自分用の箱を作る、と覚えよう。
他人の作品の利用・配布は、その作品のライセンスを確認してね。Publicだから何にでも自由に使える、という意味ではないよ。
パソコンで直した内容を記録するには、ファイル保存とCommitが必要。ネットへ届けるには、さらにPushが必要だよ。ファイルを置いただけでは、自動ですべての変更が送られるわけではない。
送る前に、パスワード・APIキー・住所などが入っていないか確かめよう。Privateの箱でも、秘密の鍵は入れない。もし送ってしまったら、その鍵を無効にして作り直す。今のファイルから消すだけでは、履歴に残る場合があるよ。
まず、正しいアカウント・箱・ブランチを選んでいるか、ネットにつながっているかを確かめよう。ネット側に新しい記録があるなら、Fetchして状況を確認する。
Conflict(コンフリクト) は、「同じ場所を別々に直したので、どちらの内容にするか決めてほしい」という合図。両方の変更を見て、残す内容を決めてから続ける。大事な作業なら、内容を控えて詳しい人と確認しよう。
Issue(イシュー) は、作品についての「やることメモ・相談の場所」。箱の Issues → New issue から、起きたことや、してほしいことを書ける。Issueを作るだけでは、作品のファイルは変わらないよ。
「作品の箱」と「足あとの記録」。
この2つがわかれば、もう最初の一歩を踏み出せるよ。