The Challenge:
フォークしたリポジトリの上でブランチを作り、貢献の準備をしよう
ブランチ
Git リポジトリは必要に応じてブランチを使って隔離された作業環境を作ることができます。プロジェクトで作業するとき、または他の人と作業をするときにブランチ(branch)を作って変更を保存しておくというのはよくやることです。こうすることによって、メインのブランチ(通常は'master'という名前ですが)を安全な状態に保ちつつ(壊したり消したりしないで、ということです)作業をすることができます。作業が終わって準備が整ったら、ブランチを 'master'にマージすればいいのです。

ブランチがどんな風に役に立つのかについては、次を見てみてください。 GitHub Guide: guides.github.com/overviews/flow
GitHub Pages
GitHubは'gh-pages'という名前のブランチにあるファイルを自動的に静的なWebサイトとしてホストしてくれる機能があります。あなたがフォークしたプロジェクトはWebサイトを作るためのものでした、ですので、メインブランチ名が'master'の代わりに'gh-pages'になっています。こういうタイプのサイトは、次のようなパターンのURLになっています。:
http://githubusername.github.io/repositoryname
Step: ブランチを作ろう
ブランチを作ると、Gitは今いるブランチのものをすべてコピーして、新しく作ったブランチに持ってきてくれます。
git status
と入力して、いま自分がなんという名前のブランチにいるか確認しましょう。('gh-pages'になっているはずです)
ブランチを作って、名前を"add-<username>"にしてみましょう。 'username' をあなたのユーザー名で入れ替えてください。たとえば、"add-jlord"みたいに。 ブランチ名は大文字小文字を区別します。ですので、GitHubのユーザー名と正確に同じ名称になるようにつけてください。.
$ git branch <BRANCHNAME>
これで'gh-pages'と全く同じ内容だけど名前の違うブランチを作ることができました。
このブランチに行ってその上で作業をするためには、ターミナルで使ったcd
コマンドに似た物を使います。checkout というコマンドを使って、新しいブランチに行きましょう。:
$ git checkout <BRANCHNAME>
Step: 新しいファイルを作ろう
テキストエディタに戻って:
- "add-<USERNAME>.txt"という名前のファイルを作りましょう。'username'はあなたのユーザー名です。たとえば"add-jlord.txt"みたいな。
- そうしたら、その中にあなた自身の GitHub ユーザー名を書き込んでください。たとえば、 わたしなら、'jlord'と書きます。
- このファイルをPatchworkリポジトリの中の'contributors'フォルダに保存してください。: Patchwork/contributors/add-yourusername.txt
- 次に変更をチェックインしましょう。
Step: チェックイン
プロジェクトに変更をチェックインするために次の手順を実行してください。:
$ git status
$ git add <FILENAME>
$ git commit -m "<commit message>"
次にこの変更をGitHub上のあなたのリポジトリにPushしましょう。:
$ git push origin <BRANCHNAME>
うまくいかない?
ファイルがcontributorsの中にない
あなたが作ったファイルは、Patchworkリポジトリの'contributors'フォルダの中にないといけません。もし他のところに置いてしまっていたら、FinderかWindows Explorerを使ってファイルを'contributors'フォルダに移動しましょう。その後git status
コマンドでもう一回確認してみてください。変更が見えるはずです。この変更をすべてAddして(-A)Commitするには、次のコマンドが使えます。
$ git add -A
$ git commit -m "move file into contributors folder"
Branch name expected: _____
ブランチ名はあなたのユーザー名と完全に一致していないといけません。ブランチ名を変更するには:
$ git branch -M <NEWBRANCHNAME>
うまくできたら、もう一回 verify してみましょう!
Tips
- ブランチを作るのと同時にブランチを切り替えすることが一行でできる:
$ git checkout -b <BRANCHNAME>
- ブランチの新規作成:
$ git branch <BRANCHNAME>
- ブランチの切り替え:
$ git checkout <BRANCHNAME>
- ブランチを一覧する:
$ git branch
- いまいるブランチの名前を変更する:
$ git branch -m <NEWBRANCHNAME>
- いまいるブランチを確認する
$ git status