githubで自分のコードを公開する手順

githubにリポジトリを作成し、自分のコードを公開してみたので、その手順をメモ。　

環境はWindows7です。
　
2012/12/05 続編を執筆しました。 github 既存のリポジトリにファイルを追加する手順

github アカウント作成

---

githubでアカウントを作成します。
Plans, Pricing and Signup から次のページに進みます。

　
　
無料アカウントのCreate a free acountをクリックします。



　
　
Username、Email Address、Passwordを記入します。



　
　
以上でアカウント作成完了です。
トップページにユーザ名が表示されています。
　
下記は私のアカウントloftkunでログインした場合の画像です。
　
独自のサムネイルを設定するには、Gravatarにアカウントを作成するとよいようです。
私は既にWordPressへのアバター表示用にアカウントを作成していたので、この時点でgithubにもサムネイルが自動で表示されました(びっくり)。
　



　
　

リポジトリ作成

---

ソースを追加するリポジトリを作成します。
New repositoryをクリックします。



　
　
Project Nameを記入します。
Description、Homepage URLは任意のようです。
無料アカウントでは、Anyone (learn more about public repos)しか選べないようです、強制的に公開されるみたいですね。
　
記入したら、Create repositoryを押します。



　
　
以下はtestというリポジトリを作成した場合の画面です。
何やらgitのコマンドが並んでいますが、これらは、リポジトリを使用するために必要なコマンドです。
実行すべきコマンドを教えてくれているのですね。
　
ローカルマシンでgitのコマンドが動くようにする必要があります。
次に、Windows環境でgitのコマンドを使用可能にする方法をご紹介します。



　
　

msysgitのインストール

---

msysgitをインストールすると、gitコマンドをWindows環境で使用できるようになります。
http://code.google.com/p/msysgit/downloads/listより、
Git-1.7.9-previewxxxxxxxx.exeをダウンロードし、実行します。
(本稿執筆時は、Git-1.7.9-preview20120201.exeでした。)
　



　
　

Use Git Bash Onlyを選択


　
　

改行コード変換です。変換なし(Checkout as-is, commit as-is)を選択。


　
　

SSH鍵の設定

---

ローカルマシンからネットワーク越しにgithubのリポジトリを操作するために必要なSSHの設定を行います。
スタートメニュー＞全てのプログラム＞Gitから、Git Bashを起動します。
(またはデスクトップにGit Bashのショートカットができていると思いますのでそちらからも起動できます。)
　
以下は私のローカルマシンで起動した場合です。



　
　
以下コマンドでSSHの鍵を作成します。

ssh-keygen -C "your_email_address@hoge.com" -t rsa

　
Enter file in which to save the key と聞かれますが、何ももせずにEnterします。
　
Enter passphrase (empty for no passphrase):と聞かれるので、パスワードを入力します。
Enter same passphrase again:と聞かれるので、同じパスワードを入力します。
　
パスワードは今後リポジトリにアクセスする場合に必要となるので覚えておいてください。
　
　
.sshというディレクトリができ、その中にid_rsa.pubというファイルが出力されます。



　
　
このファイルをテキストエディタで開き、全文をクリップボードにコピーして下さい。



　
　
SSH Keys – GitHubのページで、Add New SSH Keyをクリックします。



　
　
Titleは適当で良いです。
Keyに、先ほどコピーしたid_rsa.pubの全文を貼り付け、Add Keyを押します。
これでSSH鍵の設定は完了です。



　
　

Gitの初期設定

作成したリポジトリのページに戻ります。
(例：https://github.com/loftkun/test)
Global setup: Set up git のコマンドが初期設定のためのコマンドです。
そのままコピペして、Git Bushに打ち込んで下さい。

  git config --global user.name "your_user_name"
  git config --global user.email your_email_address@hoge.com

　
　
うまく設定できていたら以下コマンドで確認できます。

git config --get user.name
git config --get user.email

名前とメアドが表示されたら設定できています。
これでGitの初期設定は完了です。
　
　

リポジトリにファイルを追加

---

いよいよ、リポジトリにファイルを追加します。

Next steps:がファイルを追加するコマンドになります。

  mkdir test
  cd test
  git init
  touch README
  git add README
  git commit -m 'first commit'
  git remote add origin git@github.com:your_user_name/test.git
  git push -u origin master

そのまま打ち込むと、READMEファイルを新規作成して追加するコマンド実行となります。
READMEファイルを追加すると、リポジトリのトップページに自動的に表示されるので、概要等を書いておくとよいでしょう。
　
READMEの書き方には、ちょっとした文法があるようです。
https://github.com/github/markupのREADME.mdの中身を参考に改造すればよいかと思います。
http://github-preview.herokuapp.com/で動的に表示を確認できます。
　
別のファイルを追加するには、git add、comiit、pushすればOKです。
　
comiitの-mは、変更内容のコメント入力です。コメントは必須のようです。
(-mを省略すると、コメント入力用のvimが起動します、vimの操作に慣れていないとびっくりです。)
　
以上、githubで自分のコードを公開する手順でした。