各ビューにだいたい共通の操作

Tig を起動すると、最初に main ビューが表示されます (図 2 (a))。Tig では、ビューによってキーの割り当てが変わる場合がありますが、次の操作はだいたい共通です。main ビューで Tig の基本操作に慣れておきましょう。

キー	機能
j	カーソル移動: 下
k	カーソル移動: 上
:<n>	カーソル移動: n 行目
Ctrl-u	半ページアップ
Ctrl-d	半ページダウン
Space	ページダウン
Enter	画面分割して別のビューを表示 (図 2 (b))
Tab	画面分割されているとき、ビューを移動する
Q	Tig 終了
q	現在のビューを閉じる
: (コロン)	プロンプトを開く (後述)
R	ビューの再読み込み
h	読みやすい親切なヘルプ
/	順方向検索 ([n] で次へ、[N] で前へ)
?	逆方向検索 ( 〃 )

図 2 (a)

図 2 (b)

ビューの切り替え

他のビューに切り替えてみましょう。いま自分がいるビューは画面左下に表示されます。

素の Git コマンドを実行する

Tig 単体で実行できない機能については、素の Git コマンドでカバーします。実行するには [:] キーでプロンプトを開き、[!] と入力してから Git コマンドを入力します (図 3 (a))。実行した結果、Git が標準出力に何かしら出力していれば、Tig がそれを受け取って pager ビューに表示してくれます (図 3 (b))。pager ビューを抜けるのも [q] キーです。また、プロンプトを開いた状態では [Ctrl-p] [Ctrl-n] キーでコマンド履歴を前後にたどることができます。

図 3 (a)

図 3 (b)

tree ビューなどにいるときに (図 4 (a))、批判的に眺めたいファイルにカーソルを合わせて [b] キーを押すと blame ビューに切り替わります (図 5 (a))。図のように、どの行がいつ、誰の、どのコミットで変更されたかが一目瞭然です。さらに、詳しく確認したい行にカーソルを合わせて [d] キーを押せば diff ビューに切り替わり (図 5 (b))、そのコミットの差分を確認することもできます。

このように、キー 1 発でビューを縦横無尽に切り替えて、いろいろな視点から変更点を眺められるのが Tig の優れた点だと思います。

図 5 (a)

図 5 (b)

1. [l] キーで log ビューに切り替える (図 6 (a))。差分を確認したいコミットがあれば、そのコミットに含まれる行のどこかにカーソルを合わせて、[d] キーまたは [Enter] を押す (Enter の場合は画面分割される)。
2. diff ビューに切り替わり、そのコミットで行われた変更の差分が表示される。ファイルの内容を確認したければ、そのファイルの差分情報が含まれる行のどこかにカーソルを合わせて、[f] キーを押す (図 6 (b))。
3. blob ビューに切り替わり、ファイルの内容を確認することができる (図 6 (c))。

手順 2 で [f] キーの代わりに [b] キーを押せば、すでに紹介した blame ビューで表示させることもできます。また、[e] キーを押せば、エディタが起動して編集することもできます。

図 6 (a)

図 6 (b)

図 6 (c)

ブランチを作る

:!git branch issue1

ブランチの一覧表示

ブランチの切り替え

ブランチのマージ

:!git merge issue1

ブランチの削除

図 7 (a)

図 7 (b)

図 7 (c)

status ビューの説明をするために、適当なブランチを作ってコミットしてみます。hp-example の sass ディレクトリには、なんでもやりたい放題の debug レイヤというものを用意してあります (本来の FLOCSS にはそんなものありません、念のため)。ふだんはコメントアウトしてありますが、これを有効にしてみましょう。有効にすると図 8 のように HTML の各要素を色分けして表示することができます。ブラウザの「検証ツール」を知らなかった頃は、これを使ってちまちまとデバッグしていました…。

図 8

まず debug ブランチを作って debug ブランチに切り替えましょう。やり方はすぐ上の refs ビューの説明を参照してください。その後の手順は次のとおりです。

1. エディタで src/sass/style.scss を開いて、一番下の行のコメントアウトを解除する (図 9 (a))。
2. この変更をコミットするために [s] キーで status ビューに切り替える。"Changes not staged for commit:" と書かれた行の下にいま変更したファイルが表示されている (図 9 (b))。
   ファイルにカーソルを合わせて [Enter] キーを押すと、画面が分割されて差分を確認することができる (図 9 (c))。
3. 変更をステージに上げる。ステージに上げたいファイルにカーソルを合わせて [u] キーを押すと、そのファイルが "Changes to be committed:" の下に移動する (図 9 (d))。
   ステージから下ろしたい場合は、そのファイルにカーソルを合わせて再度 [u] キーを押す。
   変更を破棄したい場合は、そのファイルにカーソルを合わせ、[!] キーを押す (ステージングエリアのファイルはステージから下ろしておく必要がある)。
4. コミットするには、ステージに上げた状態で [C] キーを押す。エディタが起動するので、コミットメッセージを入力する (図 9 (e))。
   '#' から始まる行は無視され、メッセージには含まれない。保存してエディタを終了させると、コミットが実行される。
5. main ビューに戻ると、たった今のコミットが追加されていることがわかる (図 9 (f))。もし表示されていなければ [R] キーで再読み込みしてみる。

図 9 (a)

図 9 (b)

図 9 (c)

図 9 (d)

図 9 (e)

図 9 (f)

ケイトが debug ブランチでいろいろやっている間に、マイクがリモートリポジトリを更新しました。それを debug ブランチにもチェリーピックして取り込みましょう。まずはリモートリポジトリを pull します。

:!git pull origin master

履歴を確認すると、タグ v0.1 以降で 2 件のコミットがあります (図 10 (a))。これらのコミットを debug ブランチに取り込むには、次のように操作します。

1. チェリーピック先のブランチ (ここでは debug ブランチ) に切り替える。[r] キーで ref ビューに切り替え、切り替えたいブランチにカーソルを合わせて [C] キーを押す。切り替えてもよいか訊かれるので、y と入力する (図 10 (b))。
2. 引き続き ref ビューでチェリーピック元のブランチ (ここでは master ブランチ) にカーソルを合わせて [Enter] キーを押す。画面が分割されて master ブランチの main ビューが表示される (図 10 (c))。
3. master ブランチの main ビューでチェリーピックしたいコミットにカーソルを合わせ、[C] キーを押す。本当に実行するか訊かれるので、y と入力する (図 10 (d))。
4. いまは main ビューに master ブランチの情報が表示されている状態。debug ブランチがどうなったか確認したいので、[TAB] キーで上段の refs ビュー移り、debug ブランチにカーソルを合わせて [Enter] キーを押す。
5. 下段の main ビューが debug ブランチの表示になった (図 10 (e))。master ブランチからのコミットが ab8691d というハッシュ値でチェリーピックされたことがわかる。

引き続き他のコミットをチェリーピックする場合は、この手順を繰り返します。

なお、チェリーピック時のコミットメッセージは、デフォルトではチェリーピック元と同じになります。~/.tigrc に次のように書いておく (-x オプションを付ける) と、図 10 (f) のようにチェリーピック元のコミットハッシュを自動で付記してくれるので便利です。

bind main C ?git cherry-pick -x %(commit)

図 10 (a)

図 10 (b)

図 10 (c)

図 10 (d)

図 10 (e)

図 10 (f)

1. debug ブランチで何らかの作業をしていて、ステージに上げたファイルが 1 個と、まだ上げていないファイルが 1 個ある状態 (図 11 (a))。
2. stash にはデフォルトではキーが割り当てられていないので、プロンプトを開いてコマンドを直接打つ (図 11 (b))。-uオプションを付けると、追跡していないファイルも含めて退避する。
   :!git stash -u
   

3. pager ビューにスタッシュの概要が表示される (図 11 (c))。ちなみに「WIP」は「Work In Progress」の略。
4. status ビューで確認する (図 11 (d))。リポジトリがクリアな状態になった。[R] キーで再読み込みしないと表示が更新されていないかも。
5. [y] キーで stash ビューに切り替える。今しがた退避した作業が一番上に表示されている (図 11 (e))。他にも退避した作業があれば、それらもまとめて一覧表示される。
   画面下のステータスバーに「stash@{0}」と表示されているが、これがスタッシュを識別する番号になる。1 行目のスタッシュはstash@{0}、2 行目のスタッシュはstash@{1}、... という具合。
6. スタッシュを復旧するときは、まず復旧させたいブランチ (この例では debug ブランチ) に切り替える。
7. stash ビューで復旧したいスタッシュにカーソルを合わせて [A] キー (apply) を押す。status ビューに切り替えて確認すると、退避前はステージに上がっていた _header.scss がステージから下ろされた状態で戻ってしまった (図 11 (f)) が、これはこういう仕様。

• ステージエリアの状態も含めて復旧したいときは、--indexオプションを付けます。
  :!git stash apply stash@{0} --index
  

  こうすると図 11 (a) の状態に戻ります。
• 復旧してもスタッシュは残ります。不要なら破棄しましょう。stash ビューで、破棄したいスタッシュにカーソルを合わせて [!] キーを押します。
• 復旧と同時にスタッシュを破棄することもできます。[A] (apply) キー の代わりに [P] (pop) キーを押します。

図 11 (a)

図 11 (b)

図 11 (c)

図 11 (d)

図 11 (e)

図 11 (f)

ファイル名でしぼり込む。

% tig src/ejs/template.ejs

期間でしぼり込む。

% tig --after="2023-08-11" --before="2023-08-13"

コミットハッシュでしぼり込む。

% tig 1bea5e3..4095817

HEAD の 10 個前から HEAD まで。

% tig HEAD~10..

• Git 第1回: GitHub に上げるサンプルプロジェクトを作ろう
• Git 第2回: ローカルリポジトリを GitHub や Bitbucket に上げよう
• Git 第3回: Git にテキスト UI をもたらす Tig の恩恵にあずかろう
• Git 第4回: Tig をカスタマイズしよう
• Git 第5回: ついでながら Windows でも Tig を使おう
• Git 第6回: 自宅 LAN の NAS にリポジトリを作ろう