Git을 사용하기 위한 프로그램들이 많다. 그중에서도 번역하려고 하는 것은 Tig. 터미널 환경에 맞게 구성이되어 있으며, Git CLI와 같이 사용하면 왠만한 GUI 프로그램 못지않은 사용성을 보여주고 있다. 단지… 명령어가 많아질 뿐이다…

Tig Homepage

실행시키면 위와 같은 모습을 보여주게된다. 간단한 설명은 여기까지하고 메뉴얼이나 보자. 다수의 의역이 포함되어있다. 안할려고 했으나 하루죙일 하다보니… 그리고 한국어로 곧장 옮기니 이상한 부분이 있어…

The Tig Manual

이 문서는 Tig에 대한 메뉴얼이며, Tig는 Git에 대한 ncurses 기반의 텍스트 모드 인터페이스로 작성되었습니다. Tig는 Git 저장소의 변화를 확인하고 추가적으로 다양한 Git 명령에 대한 출력 내용을 확인할 수 있는 pager로 사용할 수 있습니다. Pager로 사용할 경우, stdin에서 입력을 표시하고, 생상을 추가할 수 있습니다.

저장소 확인용으로 사용할 경우, Tig는 기초적인 Git 명령을 사용하여 요약된 커밋 로그, 로그 메시지에서의 커밋 내용, diffstat, diff 와 같은 다양한 뷰를 이용하여 사용자에게 보여줍니다.

1. Calling Conventions (호출 규칙)

Pager Mode (Pager 모드)

Stdin 파이프를 사용할 경우, 모든 로그나 diff 옵션은 무시되고 pager 뷰는 stdin으로 들어온 데이터를 로딩하여 확인할 수 있습니다. Pager 모드는 다양한 Git 명령에 대한 출력값을 색상을 추가하여 확인할 수 있도록 도와줍니다.

예로 git-show(1) 명령에 대한 출력을 색상을 추가한 버전으로 보고 싶다면:

$ git show | tig

• git-show

• git-show | tig

Git Command Options (Git 명령어 옵션)

명령 줄에서 모든 Git 명령어 옵션은 주어진 명령에 전달되고 셸에 모두 전달되기 전에 인용 셸을 통과할 것입니다.

주의: 메인 뷰에 대한 옵션을 지정하는 경우엔, 메인 뷰에서 사용하는 형식으로 자동 설정되는 --pretty 옵션을 사용할 수 없습니다.

커밋과 author, 커미터 정보를 모두 보여주는 방법에 대한 예:

$ tig show --pretty=fuller

Git 명령에 대해 지원되는 변경 옵션 지원에 대한 소개는 지정 리버전 섹션을 참조하세요. 특정 Git 명령 옵션에 대한 자세한 설명은 해당 명령의 맨 페이지를 참조하세요.

2. The Viewer (뷰어)

디스플레이는 하나 이상의 뷰와 스크린으로 구성되어있으며, 맨 마지막 라인은 상태 윈도우로 사용됩니다. 기본 값은 한번에 하나의 뷰만을 보여줍니다. 하지만 메인과 로그 뷰로 나눠서 커밋 diff를 확인할 수 있습니다.

현재 라인이 커밋 라인일때, 로그 뷰에서 엔터키를 누르게되면 다음과 같은 명령이 실행되는 것과 같습니다:

commit 4d55caff4cc89335192f3e566004b4ceef572521

뷰를 나눠서 볼 수 있는데, 로그 뷰는 윈도우 상단에, diff 뷰는 윈도우 하단에 위치시킬 수 있습니다. 탭을 눌러 두 뷰사이를 왔다갔다 할 수 있습니다. 로그 뷰만 보려면 l를 누르면 됩니다.

Views (뷰)

저장소에서 여러가지 views를 볼 수 있습니다. 각 뷰는 확장 명령, git log, git diff, git show로부터 나오는 출력 값에 기반하여 보여줍니다.

메인 뷰

기본 뷰이며, 리버전의 선택된 목록에서 각 커밋을 요약하여 보여줍니다. 요약한 내용에서는 author 날짜, author, 로그 메시지 첫 줄을 포함하고 있습니다. 추가적으로 태그와 같은 저장소 참조 표시도 같이 표시됩니다.

로그 뷰

전체 로그 메시지와 diffstat에대한 리버전 로그를 보여주는 다양한 뷰를 제공합니다.

Diff 뷰

현재 작업 트리에 대한 diff, 즉, 마지막 커밋이후 변화분, 로그 메시지, diffstat, diff에 대한 커밋 diff 완료 내용을 나타냅니다.

트리 뷰

디렉토리 목록을 트리로 표현하여 현재 리버전에대한 하위 디렉토리로 내려가며 확인하거나 올라오며 확인할 수 있으며 파일의 blob에 대해서도 확인이 가능합니다.

Blob 뷰

파일 내용이나 파일 이름에 대한 관련 데이터의 “blob”을 보여줍니다.

Blame 뷰

파일 내용의 주석이나 커밋에 대한 blam을 보여줍니다.

Refs 뷰

저장소에서 브런치, 리모트, 태그를 보여줍니다.

Status 뷰

작업 트리내의 파일 상태나 staged/unstaged 변화분 확인과 추적되지 않는 파일의 추가를 좀 더 쉽게 보여줍니다.

Stage 뷰

stage된 변화분, unstage된 파일의 추적분, 추적되지 않는 파일의 내용에 대한 diff를 보여줍니다.

Stash 뷰

저장소의 Stash 목록을 보여줍니다.

Grep 뷰

검색 패턴과 동일한 내용으로 모든 라인과 파일 목록을 보여줍니다.

Pager 뷰

Stdin으로 입력과 내부 프롬프트에서 입력된 Git 명령어로부터 출력 모두를 보여주는데 사용됩니다.

도움말 뷰

키 바인딩에 대한 간단한 참조를 보여줍니다.

Browsing State and User-defined Commands (상태 확인과 사용자 정의 명령어)

뷰어는 head와 커밋 ID 모두를 추적하고, 현재 상태를 보여줍니다. 커밋 ID는 커서 라인에 따라가며 다른 커밋을 선택할때마다 강조표시가 변경됩니다. 커밋 ID가 변경되면, diff 뷰에선 열때마다 재로드됩니다. Head ID는 지나온 로그를 보면서 리버전된 것이 나타내는 메인과 로그 뷰를 확인할때 사용됩니다.

Tig에서 명령을 사용하거나 제공하는 명령을 구성할 수 있습니다. 환경 변수의 일부와 외부 명령을 사용할 수 있습니다. 사용자 정의 명령의 경우 다음 변수들을 이용하여 현재 브라우징 상태에 대한 참조 인자로 사용할 수 있습니다.

사용자 정의 명령어 예제들:

• 마지막 커밋에 대해 amend 적용:

  bind generic + !git commit --amend
  

• 크립 보드에서 커밋 ID 복사:

  bind generic 9 !@sh -c "echo -n %(commit) | xclip -selection c"
  

• 리뷰 즁 현재 커밋에서 사용된 노트 추가/수정:

  bind generic T !git notes edit %(commit)
  

• Git 대화형으로 파일 내용에 세밀한 staging 추가 입력:

  bind generic I !git add -i %(file)
  

• 선택된 브런치의 최상위에서 현재 브런치로 리배이스:

  bind refs 3 !git rebase -i %(branch)
  

Title Windows (제목 윈도우)

각 뷰는 뷰 이름에 대한 제목 윈도우를 가집니다. 가능하다면 현재 커밋 ID로도 나태낼 수 있으며, 뷰에서는 다음과 같이 위치됩니다:

[main] c622eefaa485995320bc743431bae0d497b1d875 - commit 1 of 61 (1%)

기본 값으로 현재 뷰의 제목은 굵은 폰트를 사용하여 강조됩니다. 긴 로딩이 있는 뷰의 경우(3초 이상), 로딩이 시작된 시간으로 부터의 시간이 추가되어 보여집니다:

[main] 77d9e40fbcea3238015aea403e06f61542df9a31 - commit 1 of 779 (0%) 5s

3. Environment Variables (환경 변수)

Git 인터페이스에 관련된 몇가지 옵션을 환경 옵션을 통해 구성할 수 있습니다.

Configuration Files (구성 파일)

시작시 Tig는 시스템 전체 구성 파일(기본 값 {sysconfigdir}/tigrc)을 읽은 다음 사용자 구성 파일(기본 값 ~/.tigrc)을 읽습니다. 이 파일 중 하나의 경로를 다음과 같은 환경 변수를 이용하여 재정의 할 수 있습니다:

TIGRC_USER

사용자 구성 파일 위치

TIGRC_SYSTEM

시스템 전체 구성 파일 위치

Repository References (저장소 참조)

태그와 브런치 head가 참조하는 커밋은 [과 ]에 둘러쌓여 참조 이름으로 표시됩니다:

2006-03-26 19:42 Petr Baudis         | [cogito-0.17.1] Cogito 0.17.1

브런치가 보여지는 것을 제한하길 원한다면, 보여질 브런치의 이름이 master이거나 feature/ 로 접두어로 시작하는 경우엔 다음과 같이 변수를 설정할 수 있습니다:

$ TIG_LS_REMOTE="git ls-remote . master feature/*" tig

또는 여러분의 환경에서 영구적으로 변수를 설하여 사용할 수 있습니다.

TIG_LS_REMOTE

모든 저장소에 대한 참조를 검색하는 명령을 설정합니다. 명령을 사용하게 되면 git-ls-remote(1) 과같은 포맷으로 데이터를 출력할 수 있습니다. 기본 값은 다음과 같습니다:

git ls-remote .

Diff options (Diff 옵션)

Diff 뷰에 대해 diff를 어떻게 표시할 것인가에 대한 내용으로 수정이 가능합니다. 예를 들어 커멧과 author 날짜를 상대 날짜와 같이 보길 원한다면:

$ TIG_DIFF_OPTS="--relative-date" tig

또는 여러분의 환경에서 영구적으로 변수를 설정하여 사용할 수 있습니다.

4. Default Keybindings (기본 키 바인딩)

기본 키 바인딩에 대해서는 아래와 같습니다.

View Switching (뷰 전환)

• m | 메인 뷰로 전환

• d | diff 뷰로 전환

• l | 로그 뷰로 전환

• p | pager 뷰로 전환

• t | 디렉토리 트리 뷰로 전환

• f | 파일 blob 뷰로 전환

• g | grep 뷰로 전환

• b | blame 뷰로 전환

• r | refs 뷰로 전환

• y | stash 뷰로 전환

• h | 도움말 뷰로 전환

• s | status 뷰로 전환

• c | stage 뷰로 전환

View Manipulation (뷰 조작)

View Specific Actions (뷰 지정 동작)

Cursor Navigation (커서 네비게이션)

Scrolling (스크롤링)

Searching (검색)

Misc

Prompt (프롬프트)

External Commands (외부 명령어)

사용자에 따라 외부 명령어가 더 필요한 경우, 쉽게 스크립트다 프로그램을 사용할 수 있는 방법을 제공합니다. 현재 커밋 ID로 키를 연결하고 현재 보여지는 상태에서 정보를 사용할 수 있습니다. Tig에서 기본 등록되어있는 확장 명령어:

5. Revision Specification (리버전 사항)

이 세션에서는 리버전을 표시하거나 볼 수 있는 내용을 제한할 수 있도록 설정하는 방법에 대해서 설명합니다. Tig에서는 구문 분석을 하지 않습니다. 리버전 옵션에 대한 자세한 설명은 Git 메뉴얼 페이지에서 확인하십시오. 연관된 맨페이지는 git-log(1)을 기준으로 git-diff(1)과 git-rev-list(1)입니다.

설정 가능한 옵션을 사용하여 Git과 상호 작용을 이 세션에서 설명합니다. 예를 들어 diff 옵션에 대한 세션에서 설명된 환경 변수를 사용하여 구성할 수 있습니다.

Limit by Path Name (패치 이름 제한)

특정 파일 (또는 여러 파일) 변경에 대해서만 확인하고 싶다면 다음과 같이 목록으로 나타냅니다:

$ tig Makefile README

Tig의 하위 명령 또는 태그 이름과 같은 저장소 참조에서 발생할 수 있는 모호성을 방지하기 위해 Git 옵션의 경우 --를 사용하여 구분해야됩니다. states라는 이름을 가진 파일이 있다면, status 하위 명령과 충돌을 일으킬꺼니 다음과 같이 사용해야합니다:

$ tig -- status

Limit by Date or Number (날짜나 숫자 제한)

Git과의 상호작용 속도를 올리기 위해 로그와 메인 뷰에서 보여지는 커밋의 수를 제한할 수 있습니다. 예를 들어, 날짜로 제한을 걸 경우엔 --since=1.month, 커밋 수로 제한을 걸 경우엔 -n400와 같이 사용합니다.

만약 두 날짜 사이에 발생한 변경분에 대해서 확인하고 싶다면:

$ tig --after="May 5th" --before="2006-05-16 15:44"

주의, 공간을 포함하는 날짜를 사용하지 않는다면 .를 이용하여 나타낼 수 있습니다. 예, --after=May.5th

Limiting by Commit Ranges (커밋 범위 제한)

대안으로 “tag-1.0과 tag-2.0 사이의 모든 커밋”과 같은 특정 범위로 제안할 수 있습니다. 예를 들면:

$ tig tag-1.0..tag-2.0

원격 브런치로 푸시되지 않은 커밋의 검색 제한은 다음과 같은 방법으로 가능합니다. origin을 업스트림 원격 브런치고 가정하고 사용한다면:

$ tig origin..HEAD

원격 브런치에서 푸시된 내용들을 나열 합니다. 선택적으로 HEAD는 생략될 수 있습니다.

Limiting by Reachability (도달 가능 제한)

Git 인터프리트에서는 “tag-1.0…tag-2.0”을 사용하는 경우, “tag-1.0를 제외하고 tag-2.0까지의 모든 커밋”으로 지정할 수 없습니다. 도달 가능한 참조는 물음의 브런치의 원형 (또는 히스토리의 일부분)의 커밋 또는 테그된 리버전일 수 있습니다.

이 방법으로 다음 미리 커밋을 지정하려는 경우:

$ tig tag-2.0 ^tag-1.0

부정 연산자로 ^를 생각할 수 있습니다. 이 대체 문법을 사용하면 위의 여려 브런치의 cut off를 지정하여 커밋 브런치를 없애버릴 수 있습니다.

Combining Revisions Specification (변경 사항 연결)

리버전 옵션은 다음과 같이 연결하여 사용할 수 있습니다. “Documentation/ 디렉토리에 있는 파일의 변경 사항들을 마지막달 20개 커밋까지 보여다오.”를 다음과 같이 나타낼 수 있습니다:

$ tig --since=1.month -n20 -- Documentation/

Examining All Repository References (모든 저장소 참조 검사)

일부 경우엔 저장소에 대한 모든 참조를 걸쳐서 변화를 조회하는 것이 편할 수 있습니다. 다음 예제는 “이 저장소의 개발 라인에서 지난주내 특정파일이 변경되었는지”에 대해 묻는 것입니다. 다음 명령으로 가능합니다:

$ tig --all --since=1.week -- Makefile

6. More Information (정보를 더 원하시면)

Tig 홈페이지나 메인 Git 저장소를 방문하여 새로운 릴리즈 내용, 버그 리포트 내용, 기능 요청에 대한 정보를 얻어가시길 바랍니다.

7. Copyright (저작권)

Copyright (c) 2006-2014 Jonas Fonseca jonas.fonseca@gmail.com

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

8. See Also (더보기)

맨 페이지:

• tig(1)
• tigrc(5)