2014-04-13 21:30:13 +09:00
# GitHubカンニング・ペーパー
これはGitやGitHubの隠された機能やよく知られていない機能の一覧だ。[Zach Holman ](https://github.com/holman )によるAloha Ruby Conference 2012での[Git and GitHub Secrets ](https://github.com/tiimgreen/github-cheat-sheet )（ スライド ](https://github.com/tiimgreen/github-cheat-sheet )） More Git and GitHub Secrets ](https://vimeo.com/72955426 )（ スライド ](https://speakerdeck.com/holman/more-git-and-github-secrets )）の二つのトークを元にしている。
2014-04-28 21:12:10 +08:00
*Read this in other languages: [English ](README.md ), [한국어 ](README.ko.md ), [日本語 ](README.ja.md ), [简体中文 ](README.zh-cn.md ).*
2014-04-24 10:44:43 +09:00
2014-04-13 21:30:13 +09:00
# 目次
- [GitHub ](#github )
- [空白の無視 ](#%E7%A9%BA%E7%99%BD%E3%81%AE%E7%84%A1%E8%A6%96 )
- [タブ幅の調節 ](#%E3%82%BF%E3%83%96%E5%B9%85%E3%81%AE%E8%AA%BF%E7%AF%80 )
- [特定のユーザーによるコミット履歴 ](#%E7%89%B9%E5%AE%9A%E3%81%AE%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AB%E3%82%88%E3%82%8B%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E5%B1%A5%E6%AD%B4 )
- [リポジトリのクローン ](#%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E3%82%AF%E3%83%AD%E3%83%BC%E3%83%B3 )
2014-05-09 04:22:01 +09:00
- [全ブランチを別のブランチと比較 ](#%E5%85%A8%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81%E3%82%92%E5%88%A5%E3%81%AE%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81%E3%81%A8%E6%AF%94%E8%BC%83 )
2014-04-13 21:30:13 +09:00
- [ブランチ同士の比較 ](#%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81%E5%90%8C%E5%A3%AB%E3%81%AE%E6%AF%94%E8%BC%83 )
- [フォークされたリポジトリ間でのブランチ比較 ](#%E3%83%95%E3%82%A9%E3%83%BC%E3%82%AF%E3%81%95%E3%82%8C%E3%81%9F%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E9%96%93%E3%81%A7%E3%81%AE%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81%E6%AF%94%E8%BC%83 )
- [Gists ](#gists )
- [Git.io ](#gitio )
- [キーボード・ショートカット ](#%E3%82%AD%E3%83%BC%E3%83%9C%E3%83%BC%E3%83%89%E3%82%B7%E3%83%A7%E3%83%BC%E3%83%88%E3%82%AB%E3%83%83%E3%83%88 )
- [コードの指定行の強調 ](#%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AE%E6%8C%87%E5%AE%9A%E8%A1%8C%E3%81%AE%E5%BC%B7%E8%AA%BF )
- [コミットからイシューを閉じる ](#%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E3%81%8B%E3%82%89%E3%82%A4%E3%82%B7%E3%83%A5%E3%83%BC%E3%82%92%E9%96%89%E3%81%98%E3%82%8B )
- [イシューの相互リンク ](#%E3%82%A4%E3%82%B7%E3%83%A5%E3%83%BC%E3%81%AE%E7%9B%B8%E4%BA%92%E3%83%AA%E3%83%B3%E3%82%AF )
- [プルリクエストでのCI結果の表示 ](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%A7%E3%81%AEci%E7%B5%90%E6%9E%9C%E3%81%AE%E8%A1%A8%E7%A4%BA )
- [Markdownファイルでの構文強調 ](#markdown%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%A7%E3%81%AE%E6%A7%8B%E6%96%87%E5%BC%B7%E8%AA%BF )
- [Emoji ](#emoji )
- [画像及びアニメーションGIF ](#%E7%94%BB%E5%83%8F%E5%8F%8A%E3%81%B3%E3%82%A2%E3%83%8B%E3%83%A1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3gif )
- [GitHub Wikiへの画像の添付 ](#github-wiki%E3%81%B8%E3%81%AE%E7%94%BB%E5%83%8F%E3%81%AE%E6%B7%BB%E4%BB%98 )
- [素早く引用 ](#%E7%B4%A0%E6%97%A9%E3%81%8F%E5%BC%95%E7%94%A8 )
- [設定済みライセンスの追加 ](#%E8%A8%AD%E5%AE%9A%E6%B8%88%E3%81%BF%E3%83%A9%E3%82%A4%E3%82%BB%E3%83%B3%E3%82%B9%E3%81%AE%E8%BF%BD%E5%8A%A0 )
- [タスクリスト ](#%E3%82%BF%E3%82%B9%E3%82%AF%E3%83%AA%E3%82%B9%E3%83%88 )
2014-04-29 13:18:30 +09:00
- [Markdownファイルでのタスクリスト ](#markdown%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%A7%E3%81%AE%E3%82%BF%E3%82%B9%E3%82%AF%E3%83%AA%E3%82%B9%E3%83%88 )
2014-04-13 21:30:13 +09:00
- [相対リンク ](#%E7%9B%B8%E5%AF%BE%E3%83%AA%E3%83%B3%E3%82%AF )
- [GitHub Pagesでのメタデータとプラグインのサポート ](#github-pages%E3%81%A7%E3%81%AE%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF%E3%81%A8%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88 )
- [文書内のYAMLメタデータ ](#%E6%96%87%E6%9B%B8%E5%86%85%E3%81%AEyaml%E3%83%A1%E3%82%BF%E3%83%87%E3%83%BC%E3%82%BF )
- [表形式のデータ表示 ](#%E8%A1%A8%E5%BD%A2%E5%BC%8F%E3%81%AE%E3%83%87%E3%83%BC%E3%82%BF%E8%A1%A8%E7%A4%BA )
- [差分の表示 ](#%E5%B7%AE%E5%88%86%E3%81%AE%E8%A1%A8%E7%A4%BA )
- [レンダリング済みの差分 ](#%E3%83%AC%E3%83%B3%E3%83%80%E3%83%AA%E3%83%B3%E3%82%B0%E6%B8%88%E3%81%BF%E3%81%AE%E5%B7%AE%E5%88%86 )
- [マップ差分の可視化 ](#%E3%83%9E%E3%83%83%E3%83%97%E5%B7%AE%E5%88%86%E3%81%AE%E5%8F%AF%E8%A6%96%E5%8C%96 )
- [差分表示の前後を表示 ](#%E5%B7%AE%E5%88%86%E8%A1%A8%E7%A4%BA%E3%81%AE%E5%89%8D%E5%BE%8C%E3%82%92%E8%A1%A8%E7%A4%BA )
- [プルリクエストの内容をDIFFまたはPATCH形式で取得 ](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E5%86%85%E5%AE%B9%E3%82%92diff%E3%81%BE%E3%81%9F%E3%81%AFpatch%E5%BD%A2%E5%BC%8F%E3%81%A7%E5%8F%96%E5%BE%97 )
- [Hub ](#hub )
- [共同開発者との摩擦の軽減 ](#%E5%85%B1%E5%90%8C%E9%96%8B%E7%99%BA%E8%80%85%E3%81%A8%E3%81%AE%E6%91%A9%E6%93%A6%E3%81%AE%E8%BB%BD%E6%B8%9B )
- [開発参加のガイドライン ](#%E9%96%8B%E7%99%BA%E5%8F%82%E5%8A%A0%E3%81%AE%E3%82%AC%E3%82%A4%E3%83%89%E3%83%A9%E3%82%A4%E3%83%B3 )
- [GitHub情報 ](#github%E6%83%85%E5%A0%B1 )
- [GitHub Talks ](#github-talks )
- [Git ](#git )
- [直前のブランチ ](#%E7%9B%B4%E5%89%8D%E3%81%AE%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81 )
- [空白の削除 ](#%E7%A9%BA%E7%99%BD%E3%81%AE%E5%89%8A%E9%99%A4 )
- [プルリクエストのチェックアウト ](#%E3%83%97%E3%83%AB%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%82%A2%E3%82%A6%E3%83%88 )
- [空のコミット :trollface: ](#%E7%A9%BA%E3%81%AE%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88-trollface )
- [Gitステータスのスタイリング ](#git%E3%82%B9%E3%83%86%E3%83%BC%E3%82%BF%E3%82%B9%E3%81%AE%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AA%E3%83%B3%E3%82%B0 )
- [Gitログのスタイリング ](#git%E3%83%AD%E3%82%B0%E3%81%AE%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AA%E3%83%B3%E3%82%B0 )
- [コミットログの検索 ](#%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E3%83%AD%E3%82%B0%E3%81%AE%E6%A4%9C%E7%B4%A2 )
- [マージ済みブランチ ](#%E3%83%9E%E3%83%BC%E3%82%B8%E6%B8%88%E3%81%BF%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81 )
- [ローカル・リポジトリを参照するウェブサーバー ](#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%82%92%E5%8F%82%E7%85%A7%E3%81%99%E3%82%8B%E3%82%A6%E3%82%A7%E3%83%96%E3%82%B5%E3%83%BC%E3%83%90%E3%83%BC )
- [Gitの設定 ](#git%E3%81%AE%E8%A8%AD%E5%AE%9A )
- [エイリアス ](#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9 )
- [コマンドの自動修正 ](#%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E8%87%AA%E5%8B%95%E4%BF%AE%E6%AD%A3 )
- [色設定 ](#%E8%89%B2%E8%A8%AD%E5%AE%9A )
- [Git情報 ](#git%E6%83%85%E5%A0%B1 )
- [Git Books ](#git-books )
- [訳注 ](#%E8%A8%B3%E6%B3%A8 )
## GitHub
### 空白の無視
GitHub上で差分ページを表示している時、そのURLに`?w=1` を加えると、空白の変化によるできた差分は表示されなくなり、コード上の変化だけを参照することができる。
[*GitHubの秘密についてもっと詳しく* ](https://github.com/blog/967-github-secrets )
### タブ幅の調節
差分やファイルを表示している時、URLに`?ts=4` を追加するとタブを空白4つの幅で表示する。デフォルトは8つだ。`ts` に指定した数で表示されるということだ。これはGistやrawファイルを表示している時には効果を発揮しない。
例えば[Goのソースファイル ](https://github.com/pengwynn/flint/blob/master/flint/flint.go )を表示している時、`?ts=4` を追加する前はこのように表示されるが:
`?ts=4` を[追加すると ](https://github.com/pengwynn/flint/blob/master/flint/flint.go?ts=4 )このように表示される:
### 特定のユーザーによるコミット履歴
特定のユーザーによるあるリポジトリへのコミット履歴のみを参照したい場合は、`?author=username` をURLの末尾に付ける。
```
https://github.com/rails/rails/commits/master?author=dhh
```
[*コミット・ビューの違いについてもっと詳しく* ](https://help.github.com/articles/differences-between-commit-views )
### リポジトリのクローン
リポジトリをクローンする時、URLの末尾の`.git` は無くても構わない。
```bash
$ git clone https://github.com/tiimgreen/github-cheat-sheet
```
[*Gitの`clone`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-clone )
2014-05-09 04:22:01 +09:00
### 全ブランチを別のブランチと比較
コミット一覧ボタンの隣から[ブランチ一覧 ](https://github.com/tiimgreen/github-cheat-sheet/branches )ページに行くと:
```
https://github.com/{user}/{repo}/branches
```
メイン・ブランチにマージされていないブランチの一覧が表示される。
このページからボタンをクリックしてブランチ比較ページへ移動したりブランチを削除することができる。
しかしながら`master` 以外(例えば`development` )のブランチと比較したい場合もあるだろう。その場合、以下のようにURLの最後にそのブランチ名を追加すれば良い:
```
https://github.com/{user}/{repo}/branches/{branch}
```
マージ済みのブランチを表示するには`?merged=1` をURLに追加する。
このビューでは、コマンドラインを使うことなく簡単にページ上でブランチを削除することができるだろう。
2014-04-13 21:30:13 +09:00
### ブランチ同士の比較
GitHubのブランチ比較は以下のようなURLで提供されている:
```
https://github.com/user/repo/compare/{range}
```
`{range}` を`master...4-1-stable` に変更する。
例えば:
```
https://github.com/rails/rails/compare/master...4-1-stable
```
`{range}` には以下のように変更することもできる:
```
https://github.com/rails/rails/compare/master@{1.day.ago}...master
https://github.com/rails/rails/compare/master@{2014-10-04}...master
```
*日付の形式は`YYYY-DD-MM` だ。*
するとmasterブランチと特定の期間または日時との比較が行えるだろう。
[*時間を指定してのブランチ比較についてもっと詳しく* ](https://help.github.com/articles/comparing-commits-across-time )
### フォークされたリポジトリ間でのブランチ比較
GitHubでフォークされたリポジトリ同士でブランチを比較する場合、以下のようなURLを変更する:
```
https://github.com/user/repo/compare/{foreign-user}:{branch}...{own-branch}
```
例:
```
https://github.com/rails/rails/compare/byroot:master...master
```
### Gists
[Gists ](https://gist.github.com/ )は少量のコード群を管理する最適な手段だ。ちゃんとしたリポジトリをいちいち作成する必要はない。
GistのURLの最後に`.pibb` を付ける([例 ](https://gist.github.com/hail2u/9477708.pibb ))と*HTMLのみ*のバージョンが表示されるので、そのソースは他のウェブサイトに貼り付けるにはもってこいだろう。
簡単なものとはいえ、完全なGitリポジトリとして機能するため、以下のようにすれば普通のGitリポジトリと同じようにクローンすることができる:
```bash
$ git clone https://gist.github.com/tiimgreen/10545817
```
[*Gistの作成についてもっと詳しく* ](https://help.github.com/articles/creating-gists )
### Git.io
[Git.io ](http://git.io )はGitHubの提供するGitHub専用のシンプルな短縮URLサービスだ。
cURLを使って利用することができる:
```bash
$ curl -i http://git.io -F "url=https://github.com/..."
HTTP/1.1 201 Created
Location: http://git.io/abc123
$ curl -i http://git.io/abc123
HTTP/1.1 302 Found
Location: https://github.com/...
```
[*Git.ioについてもっと詳しく* ](https://github.com/blog/985-git-io-github-url-shortener )
### キーボード・ショートカット
リポジトリをブラウザーで開いている時は、ショートカットを利用して様々な機能ヘ簡単にアクセスできるようになっている。
- `t` を押すとファイルの検索インターフェイスが起動する。
- `w` を押すとブランチ選択インターフェイスが起動する。
- `s` を押すとコマンド・バーにフォーカスが当たる。
- イシュー画面で`l` を押すとラベルの編集インターフェイスが開かれる。
- __ファイルを参照している時__（ `https://github.com/tiimgreen/github-cheat-sheet/blob/master/README.md` )に`y` を押すと、参照している時の状態で固定されるURLに変更される。つまりそのファイルのコードが後に変化したとしても、そのURLでは今とまったく同じ状態で表示されるということだ。
`?` を押すとそのページで使える全ショートカットが表示されるだろう。
[*コマンドバーについてもっと詳しく* ](https://help.github.com/articles/using-the-command-bar )
### コードの指定行の強調
コードのURLの末尾に`#L52` と付けるか行番号をクリックすると、その行が強調表示される。
これは範囲指定も可能だ（例: `#L53-L60` ）。こういった範囲を選択するには`shift` を押しながら二つの行をクリックしても良い:
```
https://github.com/rails/rails/blob/master/activemodel/lib/active_model.rb#L53 -L60
```
### コミットからイシューを閉じる
あるコミットでイシューを解決した場合、コミットメッセージで`fix/fixes/fixed` や`close/closes/closed` 、`resolve/resolves/resolved` に続けてイシュー番号を指定すると、そのコミットがmasterブランチにpushされると同時に指定イシューが閉じられるだろう。
```bash
$ git commit -m "Fix screwup, fixes #12 "
```
こうするとイシュー#12が閉じられ 、閉じたイシューにはそのコミットへの参照が自動的に追加される。
[*コミット・メッセージからイシューを閉じる方法についてもっと詳しく* ](https://help.github.com/articles/closing-issues-via-commit-messages )
### イシューの相互リンク
同じリポジトリの違うイシューへリンクを張り参照させたい場合、`#` に続けてイシュー番号を指定する。そうすると自動的にリンクが作成されるだろう。
別のリポジトリのイシューの場合は`user_name/repo_name#ISSUE_NUMBER` とすれば良い（例: `tiimgreen/toc#12` ）。
### プルリクエストでのCI結果の表示
適切に設定を行えばプルリクエストを受け取るたびに、通常のコミットと同じように[Travis CI ](https://travis-ci.org/ )がそのプルリクエストをビルドするだろう。どう設定するかは[Travis CI: Getting started ](http://docs.travis-ci.com/user/getting-started/ )を読むと良い。
2014-05-01 19:19:47 -04:00
[](https://github.com/octokit/octokit.rb/pull/452)
2014-04-13 21:30:13 +09:00
[*コミット・ステータスAPIについてもっと詳しく* ](https://github.com/blog/1227-commit-status-api )
### Markdownファイルでの構文強調
例えばMarkdownファイルでRubyのコードを構文強調したいならば以下のようにする:
```ruby
require 'tabbit'
table = Tabbit.new('Name', 'Email')
table.add_row('Tim Green', 'tiimgreen@gmail .com')
puts table.to_s
```
こうすると以下のように表示されることになる:
```ruby
require 'tabbit'
table = Tabbit.new('Name', 'Email')
table.add_row('Tim Green', 'tiimgreen@gmail .com')
puts table.to_s
```
GitHubでは[Linguist ](https://github.com/github/linguist )を使って言語を判別し構文強調を行っている。構文強調がサポートされている言語の一覧は[言語定義YAMLファイル ](https://github.com/github/linguist/blob/master/lib/linguist/languages.yml )を参照すればわかるだろう。
[*GitHub Flavored Markdownについてもっと詳しく* ](https://help.github.com/articles/github-flavored-markdown )
### Emoji
Emojiはプルリクエストやイシュー、READMEなどで`:name_of_emoji:` と書くと利用できる:
```
:smile:
```
こう書くと以下のように表示される:
:smile:
GitHubでサポートされているEmojiの完全なリストは[Emoji cheat sheet for Campfire and GitHub ](http://www.emoji-cheat-sheet.com/ )か[All-Github-Emoji-Icons ](https://github.com/scotch-io/All-Github-Emoji-Icons )で確認できる。
GitHubで使われているEmojiのトップ5は以下の通りだ:
1. :shipit: - `:shipit:`
2. :sparkles: - `:sparkles:`
3. :-1: - `:-1:`
4. :+1: - `:+1:`
5. :clap: - `:clap:`
### 画像及びアニメーションGIF
画像やアニメーションGIFはコミットのコメントやREADMEなどで利用できる:
```
```
あらゆる画像はGitHubでキャッシュされるので、画像のホスティング先が落ちていたとしても変わらず表示されるだろう。
#### GitHub Wikiへの画像の添付
GitHub Wikiで画像を追加する方法がいくつかある。通常のMarkdown記法（ ）
```markdown
[[ http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif | height = 100px ]]
```
こうすると以下のようになる:
### 素早く引用
イシューのスレッドで他の人のコメントを引用してコメントしたい場合、引用したい文章を選択した状態で`r` を押すと、ブロック引用の記法を使ってテキストエリアにコピーされる。
[*素早く引用する方法についてもっと詳しく* ](https://github.com/blog/1399-quick-quotes )
### 設定済みライセンスの追加
GitHub上でリポジトリを作成する時、あらかじめ設定されているライセンスを追加することもできる:
既に存在するリポジトリであってもウェブ上のインターフェイスからファイルを作成することで追加できる。`LICENSE` というファイル名にした場合、ライセンスを選択するオプションが表示されるのだ:
`.gitignore` も同じように作成時に追加することも、後で追加することもできる。
[*オープンソース・ライセンスについてもっと詳しく* ](https://help.github.com/articles/open-source-licensing )
### タスクリスト
イシューやプルリクエストでは以下のように（空白に注意）書くとチェックボックスを作成することができる:
```
- [ ] Be awesome
- [ ] Do stuff
- [ ] Sleep
```
これらチェックボックスにチェックが入れられると、同時にMarkdownソースも更新される:
```
- [x] Be awesome
- [x] Do stuff
- [ ] Sleep
```
[*タスク・リストについてもっと詳しく* ](https://github.com/blog/1375%0A-task-lists-in-gfm-issues-pulls-comments )
2014-04-29 13:18:30 +09:00
#### Markdownファイルでのタスクリスト
通常のMarkdownファイルでも**読み取り専用**のチェックリストを以下のような記法で追加することができる:
```
- [ ] Mercury
- [x] Venus
- [x] Earth
- [x] Mars
- [ ] Jupiter
```
- [ ] Mercury
- [x] Venus
- [x] Earth
- [x] Mars
- [ ] Jupiter
[*Markdownファイルでのタスクリストについてもっと詳しく* ](https://github.com/blog/1825-task-lists-in-all-markdown-documents )
2014-04-13 21:30:13 +09:00
### 相対リンク
Markdownファイルでリポジトリ内のコンテンツへ張る場合、相対リンクを利用することが推奨されている。
```markdown
[Link to a header ](#awesome-section )
[Link to a file ](docs/readme )
```
絶対リンクはURLの変更（
[*相対リンクについてもっと詳しく* ](https://help.github.com/articles/relative-links-in-readmes )
### GitHub Pagesでのメタデータとプラグインのサポート
Jekyllのページや投稿ではリポジトリの情報が`site.github` という名前空間に格納されており、例えば`{{ site.github.project_title }}` などと書けば表示することができる。
また、Jemojiとjekyll-mentionsというプラグインがインストールされているので、[Emoji ](#emoji )や[@mentions ](https://github.com/blog/821 )はJekyllの投稿やページでGitHub.com上と同じように動作する。
[*GitHub Pageでのメタデータとプラグインのサポートについてもっと詳しく* ](https://github.com/blog/1797-repository-metadata-and-plugin-support-for-github-pages )
### 文書内のYAMLメタデータ
[Jekyll ](http://jekyllrb.com/ )を[GitHub Pages ](http://pages.github.com/ )で利用している場合など、多くのブログではYAML形式のメタデータをその記事の先頭に書く必要がある。GitHubではこういったメタデータを読みやすいように表として表示してくれる:
[*文書内のYAMLメタデータの表示についてもっと詳しく* ](https://github.com/blog/1647-viewing-yaml-metadata-in-your-documents )
### 表形式のデータ表示
GitHubでは`.csv` （カンマ区切り）と`.tsv` （タブ区切り）の形式で書かれた表を整形して表示する機能をサポートしている。
[*表形式のデーター表示についてもっと詳しく* ](https://github.com/blog/1601-see-your-csvs )
### 差分の表示
#### レンダリング済みの差分表示
コミットやプルリクエストにGitHubでレンダリングされて表示されるもの（ ）
レンダリングされた状態での差分を表示したい場合は「Rendered」ボタンをクリックする。レンダリング済みの差分表示では文章の追加や削除、編集がよりわかりやすい:
[*レンダリング済みの差分表示についてもっと詳しく* ](https://github.com/blog/1784-rendered-prose-diffs )
#### マップ差分の可視化
コミットやプルリクエストにジオデータの変更が含まれている場合はいつも、GitHubではそのジオデータの変化を可視化してくれるだろう。
[](https://github.com/benbalter/congressional-districts/commit/2233c76ca5bb059582d796f053775d8859198ec5)
[*マップ差分の可視化についてもっと詳しく* ](https://github.com/blog/1772-diffable-more-customizable-maps )
#### 差分表示の前後を表示
差分表示の行番号付近にある*展開*ボタンを使うと、その前後の行をクリックして表示させることができる。*展開*ボタンを押し続けることによってファイル全体を表示することもできるし、またこの機能はあらゆるGitHubの差分表示ビューに用意されている。
[*差分表示の前後を表示についてもっと詳しく* ](https://github.com/blog/1705-expanding-context-in-diffs )
#### プルリクエストの内容をDIFFまたはPATCH形式で取得
プルリクエストによる差分はそのURLの末尾に`.diff` または`.patch` を追加すると、それぞれの形式で取得することができる。例えば:
```
https://github.com/tiimgreen/github-cheat-sheet/pull/15
https://github.com/tiimgreen/github-cheat-sheet/pull/15.diff
https://github.com/tiimgreen/github-cheat-sheet/pull/15.patch
```
拡張子`.diff` を追加した場合、このようなプレーンテキストで表示されるだろう:
```
diff --git a/README.md b/README.md
index 88fcf69..8614873 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@ All the hidden and not hidden features of Git and GitHub. This cheat sheet was i
- [Merged Branches ](#merged-branches )
- [Quick Licensing ](#quick-licensing )
- [TODO Lists ](#todo-lists )
+- [Relative Links ](#relative-links )
- [.gitconfig Recommendations ](#gitconfig-recommendations )
- [Aliases ](#aliases )
- [Auto-correct ](#auto-correct )
@@ -381,6 +382,19 @@ When they are clicked, they will be updated in the pure Markdown:
- [ ] Sleep
(...)
```
### Hub
[Hub ](https://github.com/github/hub )はGitのラッパーとして機能するコマンドライン・ツールで、これを利用するとGitHubをコマンドラインからとても簡単に扱えるようになる。
例えば以下のようにしてリポジトリのクローンが行える:
```bash
$ hub clone tiimgreen/toc
```
これが以下のコマンドの代わりというわけだ:
```bash
$ git clone https://github.com/tiimgreen/toc.git
```
[*Hubが提供する便利な機能についてもっと詳しく* ](https://github.com/github/hub#commands )
### 共同開発者との摩擦の軽減
もし誰かに自分のプロジェクトの利用またはその開発に参加してもらいたい場合、まずはよくある質問に答えることから始めなければならないだろう。このプロジェクトはどういうものなのか？どうやって使うのか？どのように使っても良いのか？どうやれば開発に参加できるのか？どうやれば開発環境を用意できるのか？どうやって自分の加えた機能が既存の機能を破壊しないことが確認できるのか？
[Friction ](https://github.com/rafalchmiel/friction )はこういった[一般的な質問に対しての答え ](https://github.com/rafalchmiel/friction/wiki )が用意されているかをチェックしてくれるコマンドライン・ツールだ。例えば以下のような出力を得られる:
[](https://github.com/rafalchmiel/friction)
### 開発参加のガイドライン
リポジトリのルートに`CONTRIBUTING` という名前のファイルを置くと、イシューやプルリクエストを作成しようとした時にそれへのリンクが表示されるようになる。
[*開発参加のガイドラインについてもっと詳しく* ](https://github.com/blog/1184-contributing-guidelines )
### GitHub Resources
| Title | Link |
| ----- | ---- |
| GitHub Explore | https://github.com/explore |
| GitHub Blog | https://github.com/blog |
| GitHub Help | https://help.github.com/ |
| GitHub Training | http://training.github.com/ |
| GitHub Developer | https://developer.github.com/ |
#### GitHub Talks
| Title | Link |
| ----- | ---- |
| How GitHub Uses GitHub to Build GitHub | https://www.youtube.com/watch?v=qyz3jkOBbQY |
| Introduction to Git with Scott Chacon of GitHub | https://www.youtube.com/watch?v=ZDR433b0HJY |
| How GitHub No Longer Works | https://www.youtube.com/watch?v=gXD1ITW7iZI |
| Git and GitHub Secrets | https://www.youtube.com/watch?v=Foz9yvMkvlA |
| More Git and GitHub Secrets | https://www.youtube.com/watch?v=p50xsL-iVgU |
## Git
### 直前のブランチ
Gitで直前のブランチへ移動するには:
```bash
$ git checkout -
# Switched to branch 'master'
$ git checkout -
# Switched to branch 'next'
$ git checkout -
# Switched to branch 'master'
```
[*Gitのブランチ操作についてもっと詳しく* ](http://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging )
### 空白の削除
Gitの`stripspace` コマンドは以下の作業を行う:
- 行末の空白文字の削除
- 空白行の取りまとめ
- ファイル末尾への改行の追加
このコマンドを呼ぶ時はファイルを渡さねばならない。例:
```bash
$ git stripspace < README.md
```
[*Gitの`stripspace`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-stripspace )
### プルリクエストのチェックアウト
2014-05-18 10:28:28 +09:00
プルリクエストはGitHubのリポジトリでは特別なブランチであり、様々な方法でローカルに取り込むことができる:
2014-04-13 21:30:13 +09:00
2014-05-18 10:28:28 +09:00
特定のプルリクエストを取り込み、一時的に`FETCH_HEAD` として保存すると、素早く差分を確認してマージすることが可能だ:
2014-04-13 21:30:13 +09:00
```bash
2014-05-18 10:28:28 +09:00
git fetch origin refs/pull/[PR-Number]
2014-04-13 21:30:13 +09:00
```
2014-05-18 10:28:28 +09:00
参照仕様を使うとすべてのプルリクエストをローカル・ブランチとして取り込むことができる:
2014-04-13 21:30:13 +09:00
```bash
$ git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*'
```
2014-05-18 10:28:28 +09:00
リポジトリの`.git/config` に以下の行を追加すれば自動的にプルリクエストを落とすようにもできるだろう:
2014-04-13 21:30:13 +09:00
```
[remote "origin"]
fetch = +refs/heads/*:refs/remotes/origin/*
url = git@github .com:tiimgreen/github-cheat-sheet.git
```
```
[remote "origin"]
fetch = +refs/heads/*:refs/remotes/origin/*
url = git@github .com:tiimgreen/github-cheat-sheet.git
fetch = +refs/pull/*/head:refs/remotes/origin/pr/*
```
2014-05-18 10:28:28 +09:00
フォークされてから送られてきたプルリクエストに対しては、そのプルリクエストを参照するリモート・ブランチから直接ローカル・ブランチとしてチェックアウトすると便利だろう:
```bash
$ git checkout pr/42 pr-42
```
2014-04-13 21:30:13 +09:00
[*プルリクエストのチェックアウトについてもっと詳しく* ](https://help.github.com/articles/checking-out-pull-requests-locally )
### 空のコミット :trollface:
`--allow-empty` オプションを付けると、コードの変化がなくてもコミットを作成することができる:
```bash
$ git commit -m "Big-ass commit" --allow-empty
```
この機能の使い方（便利なもの）としては以下のようなものが挙げられる:
- 新たな機能や大きな変更を事前に通知する時
- コード上に現れないような変更をプロジェクトに加えた時
- リポジトリを利用して誰かと連絡を取りたい時
- リポジトリへの最初のコミットをやり直しできるようにしたい時: `git commit -m "init repo" --allow-empty` .
### Gitステータスのスタイリング
普通に実行すると:
```bash
$ git status
```
このように表示されるが:
`-sb` を追加することによって:
```bash
$ git status -sb
```
このように表示することもできる:
[*Gitの`status`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-status )
### Gitログのスタイリング
以下のように実行すると:
```bash
2014-04-29 13:18:30 +09:00
$ git log --all --graph --pretty=format:'%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)< %an>%Creset' --abbrev-commit --date=relative
2014-04-13 21:30:13 +09:00
```
このように表示される:
2014-04-29 13:18:30 +09:00
2014-04-13 21:30:13 +09:00
この設定は[Palesz ](http://stackoverflow.com/users/88355/palesz )が考えたものだ。
*これは[後述の手順 ](#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9 )に従ってエイリアスへ追加することもできる。*
[*Gitの`log`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-log )
### コミットログの検索
指定した文字列を今までのコミット・メッセージから検索して、もっとも新しいものを表示することができる。
```bash
$ git show :/query
```
`query` を検索したい文字列（大文字と小文字を区別する）で置き換えると、最新のコミットがそのコミットにおける差分と同時に表示される。
```bash
$ git show :/typo
```
注: 終了するには`q` を押す。
### マージ済みブランチ
以下のように実行すると:
```bash
$ git branch --merged
```
現在のブランチに既にマージされたブランチの一覧が表示される。
逆に:
```bash
$ git branch --no-merged
```
こうするとまだマージされていないブランチが表示されるだろう。
[*Gitの`branch`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-branch )
### ローカル・リポジトリを参照するウェブサーバー
Gitの`instaweb` コマンドを利用すると、自分の作業リポジトリを`gitweb` で参照することができる。このコマンドは`gitweb` とウェブサーバーをセットアップしてローカル・リポジトリをブラウザーで開けるようにする簡単なスクリプトだ。
```bash
$ git instaweb
```
以下のようなページが開かれる:
[*Gitの`instaweb`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-instaweb )
### Gitの設定
`.gitconfig` とはあらゆる設定が書き込まれるファイルだ。
#### エイリアス
エイリアスはGitの呼び出し方を自分で好きなように定義できるヘルパー機能だ。例えば`git a` で`git add --all` を実行するようにすることができる。
エイリアスを追加するには`~/.gitconfig` を開き、以下のような形式で記述していく:
```
[alias]
co = checkout
cm = commit
p = push
# Show verbose output about tags, branches or remotes
tags = tag -l
branches = branch -a
remotes = remote -v
```
またはコマンドラインからも設定できる:
```bash
$ git config --global alias.new_alias git_function
```
例:
```bash
$ git config --global alias.cm commit
```
注: エイリアスが複数のコマンドからなる場合はクオートで括る必要がある:
```bash
$ git config --global alias.ac 'add -A . & & commit'
```
おすすめの設定を挙げておこう:
| エイリアス | コマンド | 設定方法 |
| --- | --- | --- |
| `git cm` | `git commit` | `git config --global alias.cm commit` |
| `git co` | `git checkout` | `git config --global alias.co checkout` |
| `git ac` | `git add . -A` `git commit` | `git config --global alias.ac '!git add -A && git commit'` |
| `git st` | `git status -sb` | `git config --global alias.st 'status -sb'` |
| `git tags` | `git tag -l` | `git config --global alias.tags 'tag -l'` |
| `git branches` | `git branch -a` | `git config --global alias.branches 'branch -a'` |
| `git remotes` | `git remote -v` | `git config --global alias.remotes 'remote -v'` |
2014-05-08 09:18:48 +08:00
| `git lg` | `git log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --` | `git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --"` |
2014-04-13 21:30:13 +09:00
#### コマンドの自動修正
多分今は`git comit` とタイプした場合、以下のような出力を得ることだろう:
```bash
$ git comit -m "Message"
# git: 'comit' is not a git command. See 'git --help'.
# Did you mean this?
# commit
```
これを`comit` とタイプした時に`commit` を実行させたい場合、自動修正を有効にすれば良い:
```bash
$ git config --global help.autocorrect 1
```
すると以下のような出力を得るようになるだろう:
```bash
$ git comit -m "Message"
# WARNING: You called a Git command named 'comit', which does not exist.
# Continuing under the assumption that you meant 'commit'
# in 0.1 seconds automatically...
```
#### 色設定
Gitの出力をカラフルにするには以下のような設定を加えると良い:
```bash
$ git config --global color.ui 1
```
[*Gitの`config`コマンドについてもっと詳しく* ](http://git-scm.com/docs/git-config )
### Git Resources
| Title | Link |
| ----- | ---- |
| Official Git Site | http://git-scm.com/ |
| Official Git Video Tutorials | http://git-scm.com/videos |
| Code School Try Git | http://try.github.com/ |
| Introductory Reference & Tutorial for Git | http://gitref.org/ |
| Official Git Tutorial | http://git-scm.com/docs/gittutorial |
| Everyday Git | http://git-scm.com/docs/everyday |
| Git Immersion | http://gitimmersion.com/ |
| Ry's Git Tutorial | http://rypress.com/tutorials/git/index.html |
| Git for Designer | http://hoth.entp.com/output/git_for_designers.html |
| Git for Computer Scientists | http://eagain.net/articles/git-for-computer-scientists/ |
| Git Magic | http://www-cs-students.stanford.edu/~blynn/gitmagic/ |
#### Git Books
| Title | Link |
| ----- | ---- |
| Pragmatic Version Control Using Git | http://www.pragprog.com/titles/tsgit/pragmatic-version-control-using-git |
| Pro Git | http://git-scm.com/book |
| Git Internals Peepcode | http://peepcode.com/products/git-internals-pdf |
| Git in the Trenches | http://cbx33.github.com/gitt/ |
| Version Control with Git | http://www.amazon.com/Version-Control-Git-collaborative-development/dp/1449316387 |
| Pragmatic Guide to Git | http://www.pragprog.com/titles/pg_git/pragmatic-guide-to-git |
| Git: Version Control for Everyone | http://www.packtpub.com/git-version-control-for-everyone/book |
## 訳注
これは[GitHub Cheat Sheet ](https://github.com/tiimgreen/github-cheat-sheet )の日本語訳である。
