@@ -1,75 +1,86 @@
11<p align="center">
2− <img src="../doc/logo-header.svg" alt="bat - a cat clone with wings"><br>
3− <a href="https://travis-ci.org/sharkdp/bat"><img src="https://travis-ci.org/sharkdp/bat.svg?branch=master" alt="Build Status"></a>
4− <a href="https://ci.appveyor.com/project/sharkdp/bat"><img src="https://ci.appveyor.com/api/projects/status/cptsmtbiwbnr2vhf/branch/master?svg=true"></a>
2+ <img src="doc/logo-header.svg" alt="bat - a cat clone with wings"><br>
3+ <a href="https://github.com/sharkdp/bat/actions?query=workflow%3ACICD"><img src="https://github.com/sharkdp/bat/workflows/CICD/badge.svg" alt="Build Status"></a>
54 <img src="https://img.shields.io/crates/l/bat.svg" alt="license">
65 <a href="https://crates.io/crates/bat"><img src="https://img.shields.io/crates/v/bat.svg?colorB=319e8c" alt="Version info"></a><br>
7−
8− 문법 강조와 깃 통합 기능의 <i>cat(1)</i> 클론
6+ 문법 강조와 Git 통합 기능의 <i>cat(1)</i> 클론
97</p>
108
119<p align="center">
1210 <a href="#문법-강조">주요 기능들</a> •
1311 <a href="#사용법">사용법</a> •
1412 <a href="#설치">설치</a> •
15− <a href="#커스터마이즈">커스터마이즈</a> •
13+ <a href="#사용자화">사용자화</a> •
1614 <a href="#프로젝트-목표와-대안들">프로젝트 목표와 대안들</a> •
17− 번역 [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>][<a href="../doc/README-ja.md">日本語</a>]
15+ [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>] [<a href="doc/README-ja.md">日本語</a>] [<a href="doc/README-ko.md">한국어</a>] [<a href="doc/README-ru.md">Русский</a>]
1816</p>
1917
2018### 문법 강조
2119
22−`bat`은 다양한 프로그래밍 언어와 마크업 언어에 대해 문법 강조(Syntax highlighting)기능을 지원하고 있습니다:
20+`bat`은 다양한 프로그래밍 및 마크업 언어의 문법 강조(syntax highlighting) 기능을
21+지원합니다:
2322
2423
2524
2625### Git 통합
2726
28−`bat`은 `git`을 통해 인덱스와 함께 변경분을 표시합니다 (왼쪽 바를 확인하세요):
27+`bat`은 `git`을 통해 인덱스와 함께 변경분을 표시합니다
28+(왼쪽 사이드바를 확인하세요):
2929
3030
3131
32−### 표시할 수 없는 문자 처리
32+### 비인쇄 문자 처리
3333
34−`-A`/`--show-all` 옵션을 사용하여 표시할수 없는 문자를 시각화 해줍니다:
34+`-A`/`--show-all` 옵션을 사용하여 비인쇄 문자를 표시 및 강조할 수 있습니다:
3535
3636
3737
38−### 자동 페이징
38+### 자동 페이징
3939
40−하나의 화면에 비해 출력이 너무 큰 경우, `less` 를 이용해 출력들을 연결할 수 있습니다.
40+`bat`은 기본적으로 한 화면에 비해 출력이 큰 경우 `less`와 같은 페이저(pager)로
41+출력을 연결(pipe)합니다.
42+만약 `bat`을 언제나 `cat`처럼 작동하게 하려면 (출력을 페이지하지 않기),
43+`--paging=never` 옵션을 커맨드 라인이나 설정 파일에 넣을 수 있습니다.
44+셸(shell) 설정에서 `cat`을 `bat`의 alias로 사용하려면,
45+`alias cat='bat --paging=never'`를 써서 기본 행동을 유지할 수 있습니다.
4146
42−### 파일 연결
47+### 파일 연결(concatenation)
4348
44−이 뿐만 아니라 파일을 연결할 때도 사용 할 수 있습니다. :wink: `bat`가 인터렉티브 하지 않은(non-interactive)가 감지하면 (예를 들어,다른 프로세스 혹은 파일과 파이프라인을 연결 한 경우) `bat`은 `cat`을 대신하여 동작하며 일반 파일 내용을 표기해줍니다.
49+페이저(pager)를 사용하더라도 `bat`은 파일들을 연결(concatenate)할 수 있습니다
50+:wink:.
51+`bat`이 비대화형(non-interactive) 터미널(예를 들어, 다른 프로세스나 파일에
52+연결(pipe)한 경우)을 감지하면, `bat`은 `--pager` 옵션의 값과 상관없이 `cat`과
53+동일하게 파일 내용을 그대로 출력합니다.
4554
4655## 사용법
4756
48−터미널에서 하나의 파일 표시하기
57+터미널에 하나의 파일 표시하기
4958
5059```bash
5160> bat README.md
5261```
5362
54−여러 파일 한번에 보여주기
63+여러 파일 한 번에 보여주기
5564
5665```bash
5766> bat src/*.rs
5867```
5968
60−stdin에서 읽고, 자동으로 맞는 문법 강조 적용하기
69+stdin에서 읽고, 자동으로 맞는 문법 결정하기 (참고로, 문법 강조는 파일의 첫
70+줄만으로 문법이 결정될 수 있을 때만 작동합니다.
71+이는 보통 `#!/bin/sh`와 같은 셔뱅(shebang)으로 판단합니다.)
6172
6273```bash
6374> curl -s https://sh.rustup.rs | bat
6475```
6576
66−stdin에서 읽고, 명시적으로 언어 지정하여 적용하기
77+stdin에서 읽고, 명시적으로 언어 지정하기
6778
6879```bash
6980> yaml2json .travis.yml | json_pp | bat -l json
7081```
7182
72−표시할 수 없는 문자 처리하기
83+비인쇄 문자 표시 및 강조하기
7384```bash
7485> bat -A /etc/hosts
7586```
@@ -86,23 +97,38 @@ bat -n main.rs # show line numbers (only)
8697bat f - g # output 'f', then stdin, then 'g'.
8798```
8899
89−### 다른 툴과의 통합
100+### 다른 도구들과 통합하기
101+
102+#### `fzf`
103+
104+`bat`을 [`fzf`](https://github.com/junegunn/fzf)의 프리뷰로 쓸 수 있습니다.
105+이를 위해서는 `bat`의 `--color=always` 옵션으로 항상 컬러 출력이 나오게 해야
106+합니다.
107+또한 `--line-range` 옵션으로 긴 파일의 로드 시간을 제한할 수 있습니다:
108+```bash
109+fzf --preview 'bat --color=always --style=numbers --line-range=:500 {}'
110+```
111+더 많은 정보는
112+[`fzf`의 `README`](https://github.com/junegunn/fzf#preview-window)를 참고하세요.
90113
91−#### `find` 와 `fd`
114+#### `find`와 `fd`
92115
93−`find`의 `-exec` 옵션을 사용하여 `bat`의 모든 검색 결과를 미리 볼 수 있습니다:
116+`find`의 `-exec` 옵션을 사용하여 모든 검색 결과를 `bat`로 미리 볼 수 있습니다:
94117```bash
95118find … -exec bat {} +
96119```
97120
98−[`fd`](https://github.com/sharkdp/fd)를 사용하고 있는 경우, `-X`/`--exec-batch` 옵션을 이용하여 동일하게 사용할 수 있습니다:
121+[`fd`](https://github.com/sharkdp/fd)를 사용하는 경우, `-X`/`--exec-batch`
122+옵션을 이용하여 동일하게 사용할 수 있습니다:
99123```bash
100124fd … -X bat
101125```
102126
103127#### `ripgrep`
104128
105−[`batgrep`](https://github.com/eth-p/bat-extras/blob/master/doc/batgrep.md)과 함께, [`ripgrep`](https://github.com/BurntSushi/ripgrep)의 검색 결과를 `bat`을 이용하여 볼 수 있습니다.
129+[`batgrep`](https://github.com/eth-p/bat-extras/blob/master/doc/batgrep.md)을
130+통해 `bat`로 [`ripgrep`](https://github.com/BurntSushi/ripgrep)의 검색 결과를
131+출력할 수 있습니다.
106132
107133```bash
108134batgrep needle src/
@@ -110,279 +136,393 @@ batgrep needle src/
110136
111137#### `tail -f`
112138
113−`bat` 과 `tail -f`를 함께 사용하여, 특정 파일을 문법 강조하며 지속적으로 모니터링 할 수 있습니다.
139+`bat`와 `tail -f`를 함께 사용하여 주어진 파일을 문법 강조하며 지속적으로
140+모니터할 수 있습니다.
114141```bash
115142tail -f /var/log/pacman.log | bat --paging=never -l log
116143```
117−이 작업을 하려면 페이징 기능을 꺼야합니다. 또, 자동 감지가 되지 않기 때문에, 적용되어야할 문법을 명시적(`-l log`)으로 지정해야 합니다.
144+참고로 이 작업을 하려면 페이징 기능을 꺼야 합니다.
145+또한 이 경우 문법을 자동 감지할 수 없기 때문에, 적용할 문법을 직접 지정해야
146+합니다 (`-l log`).
118147
119148#### `git`
120149
121−`bat`과 `git show`를 함께 사용하여 주어진 파일의 이전 기록을 문법 강조와 함께 볼 수 있습니다:
150+`bat`과 `git show`를 함께 사용하여 주어진 파일의 이전 버전을 올바른 문법 강조로
151+볼 수 있습니다:
122152```bash
123153git show v0.6.0:src/main.rs | bat -l rs
124154```
125155
126−diffs 내에서 문법 강조 표시는 현재 지원되지 않습니다. 이 기능은 [`delta`](https://github.com/dandavison/delta)에서 찾아 볼 수 있습니다.
156+#### `git diff`
157+
158+`bat`과 `git diff`를 함께 사용하여 수정된 코드 주위의 줄들을 올바른 문법 강조로
159+볼 수 있습니다:
160+```bash
161+batdiff() {
162+ git diff --name-only --diff-filter=d | xargs bat --diff
163+}
164+```
165+이것을 별도의 도구로 쓰고 싶다면
166+[`bat-extras`](https://github.com/eth-p/bat-extras)의 `batdiff`를 확인해 보세요.
167+
168+Git과 diff의 더 많은 지원을 원한다면
169+[`delta`](https://github.com/dandavison/delta)를 확인해 보세요.
127170
128171#### `xclip`
129172
130−`bat` 출력에서 라인 넘버와 Git 수정 내역이 같이 있어 파일 내용을 복사하기가 어려울 수도 있습니다. 이 경우에는 `-p`/`--plain` 옵션을 사용 하거나 출력 시 파이프라인으로 `xclip`을 사용하면 됩니다:
173+`bat` 출력에 줄 번호와 Git 수정 내역이 포함되어서 파일의 내용을 복사하기
174+어려울 수 있습니다.
175+이 경우에는 `bat`의 `-p`/`--plain` 옵션을 사용하거나 간단히 `xclip`으로 출력을
176+연결(pipe)하면 됩니다:
131177```bash
132178bat main.cpp | xclip
133179```
134−`bat` 에서는 리다이렉트된 것으로 감지하여, 파일 내용만 출력합니다.
180+`bat`는 출력이 우회되고 있다는 것을 감지하여 파일 내용 그대로를 출력합니다.
135181
136182#### `man`
137183
138−`bat`은 `MANPAGER` 환경 변수 설정을 통해 `man`에 대하여 컬러 페이져를 사용할 수 있습니다:
184+`MANPAGER` 환경 변수 설정을 통해 `bat`을 `man`의 컬러 페이저(pager)로 쓸 수
185+있습니다.
139186
140187```bash
141188export MANPAGER="sh -c 'col -bx | bat -l man -p'"
142189man 2 select
143190```
191+(Debian이나 Ubuntu를 사용한다면 `bat`을 `batcat`으로 치환하세요.)
144192
145−포매팅 문제가 발생한다면, `MANROFFOPT="-c"` 설정 해야 할 수도 있습니다 .
193+포팻 문제가 발생한다면, `MANROFFOPT="-c"`을 써야 할 수 있습니다.
146194
147−새 커맨드에서 이 번들을 사용하려면, [`batman`](https://github.com/eth-p/bat-extras/blob/master/doc/batman.md)을 이용 할 수 있습니다.
195+이 기능을 포함한 새로운 명령어를 선호한다면,
196+[`batman`](https://github.com/eth-p/bat-extras/blob/master/doc/batman.md)을 쓸
197+수도 있습니다.
148198
199+참고로 [Manpage 문법](../assets/syntaxes/Manpage.sublime-syntax)은 본 저장소에서
200+개발 중에 있으며, 아직 더 손봐야 합니다.
149201
150−참고 : [Manpage syntax](../assets/syntaxes/Manpage.sublime-syntax)는 이 저장소에서 개발되고 있으며, 아직 작업 중 입니다.
202+또한, 이는 Mandoc의 `man` 구현에서
203+[작동하지 않습니다](https://github.com/sharkdp/bat/issues/1145).
151204
152205#### `prettier` / `shfmt` / `rustfmt`
153206
154−[`prettybat`](https://github.com/eth-p/bat-extras/blob/master/doc/prettybat.md) 스크립트는 코드를 포맷팅하고 `bat`으로 출력해주는 랩퍼(wrapper) 입니다.
207+[`prettybat`](https://github.com/eth-p/bat-extras/blob/master/doc/prettybat.md)
208+스크립트는 코드를 포맷하고 `bat`으로 출력하는 래퍼(wrapper)입니다.
155209
156210
157211## 설치
158212
159−[](https://repology.org/project/bat/versions)
213+[](https://repology.org/project/bat-cat/versions)
214+
215+### Ubuntu에서 (`apt` 사용)
216+*... 그리고 다른 Debian 기반의 Linux 배포판들에서.*
160217
161−### On Ubuntu
162−*... 그리고 기타 Debian 기반의 Linux 배포판들.*
218+`bat`은 [Ubuntu](https://packages.ubuntu.com/eoan/bat)와
219+[Debian](https://packages.debian.org/sid/bat) 패키지 배포 과정에 도입되는 중이며,
220+Eoan 19.10 버전의 Ubuntu에서부터 제공됩니다.
221+현재 Debain에서는 불안정한 "Sid" 브랜치에서만 `bat`이 제공됩니다.
163222
164−Ubuntu Eoan 19.10 혹은 Debian unstable sid 이후 버전 부터는 [Ubuntu용 `bat` 패키지](https://packages.ubuntu.com/eoan/bat)나 [Debian용 `bat` 패키지](https://packages.debian.org/sid/bat) 를 설치 할 수 있습니다.
223+만약 충분히 최신 버전의 Ubuntu/Debian이 설치되어 있다면 간단히 다음을 실행하세요:
165224
166225```bash
167226apt install bat
168227```
169228
170−만약 최근 릴리즈된 bat을 사용을 원하거나 buntu/Debian 예전 버전을 사용하는 경우, [릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서 다음과 같이 `.deb` 패키지를 받아 설치 할 수도 있습니다:
229+**중요**: 만약 `bat`을 이와 같이 설치한다면, ([다른 패키지와의 이름
230+충돌](https://github.com/sharkdp/bat/issues/982)로 인하여) `bat` 대신에
231+`batcat`이라는 이름의 실행 파일로 설치될 수 있음을 참고하세요.
232+이에 따른 문제들과 다른 배포판들과의 일관성을 위하여 `bat -> batcat` symlink
233+혹은 alias를 설정할 수 있습니다:
234+``` bash
235+mkdir -p ~/.local/bin
236+ln -s /usr/bin/batcat ~/.local/bin/bat
237+```
238+
239+### Ubuntu에서 (가장 최신 `.deb` 패키지들 사용)
240+*... 그리고 다른 Debian 기반의 Linux 배포판들에서.*
241+
242+만약 여러분이 설치한 Ubuntu/Debian에 패키지가 배포되지 않거나 가장 최신 릴리즈된
243+`bat`을 원한다면, [릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서
244+다음과 같이 `.deb` 패키지를 받아 설치하세요:
171245
172246```bash
173247sudo dpkg -i bat_0.18.1_amd64.deb # adapt version number and architecture
174248```
175249
176−### On Alpine Linux
250+### Alpine Linux에서
177251
178−공식 소스를 통해 [`bat` 패키지](https://pkgs.alpinelinux.org/packages?name=bat) 를 설치 할 수 있습니다:
252+적절한 저장소가 활성화되어 있다면, 공식 소스를 통해
253+[`bat` 패키지](https://pkgs.alpinelinux.org/packages?name=bat)를 설치할 수
254+있습니다:
179255
180256```bash
181257apk add bat
182258```
183259
184−### On Arch Linux
260+### Arch Linux에서
185261
186−공식 소스를 통해 [`bat` 패키지](https://www.archlinux.org/packages/community/x86_64/bat/)를 설치할 수 있습니다:
262+공식 소스를 통해
263+[`bat` 패키지](https://www.archlinux.org/packages/community/x86_64/bat/)를
264+설치할 수 있습니다:
187265
188266```bash
189267pacman -S bat
190268```
191269
192−### On Fedora
270+### Fedora에서
193271
194−[공식 Fedora 모듈 저장소](https://docs.fedoraproject.org/en-US/modularity/using-modules/)에서 [`bat` 패키지](https://koji.fedoraproject.org/koji/packageinfo?packageID=27506)을 설치할 수 있습니다:
272+공식
273+[Fedora 모듈](https://docs.fedoraproject.org/en-US/modularity/using-modules/)
274+저장소에서
275+[`bat` 패키지](https://koji.fedoraproject.org/koji/packageinfo?packageID=27506)를
276+설치할 수 있습니다:
195277
196278```bash
197279dnf install bat
198280```
199281
200−### On Gentoo Linux
282+### Gentoo Linux에서
201283
202−공식 소스를 통해 [`bat` 패키지](https://packages.gentoo.org/packages/sys-apps/bat)를 설치할 수 있습니다.
284+공식 소스를 통해
285+[`bat` 패키지](https://packages.gentoo.org/packages/sys-apps/bat)를 설치할 수
286+있습니다:
203287
204288```bash
205289emerge sys-apps/bat
206290```
207291
208−### On Void Linux
292+### Void Linux에서
209293
210−xbps-install를 이용해 `bat`을 설치할 수 있습니다:
294+xbps-install을 이용해 `bat`을 설치할 수 있습니다:
211295```bash
212296xbps-install -S bat
213297```
214298
215−### On FreeBSD
299+### Termux에서
300+
301+pkg를 이용해 `bat`을 설치할 수 있습니다:
302+```bash
303+pkg install bat
304+```
305+
306+### FreeBSD에서
216307
217−pkg를 이용하여 미리 컴파일된 [`bat` 패키지](https://www.freshports.org/textproc/bat)를 설치할 수 있습니다:
308+pkg를 이용하여 미리 컴파일된
309+[`bat` 패키지](https://www.freshports.org/textproc/bat)를 설치할 수 있습니다:
218310
219311```bash
220312pkg install bat
221313```
222314
223−또는 FreeBSD 포트에서 직접 빌드할 수도 있습니다:
315+또는 FreeBSD 포트에서 직접 빌드할 수도 있습니다:
224316
225317```bash
226318cd /usr/ports/textproc/bat
227319make install
228320```
229321
230−### Via nix
322+### nix를 써서
231323
232−[nix package manager](https://nixos.org/nix)를 이용해 `bat`을 설치할 수 있습니다:
324+[nix package manager](https://nixos.org/nix)를 이용해 `bat`을 설치할 수
325+있습니다:
233326
234327```bash
235328nix-env -i bat
236329```
237330
238−### On openSUSE
331+### openSUSE에서
239332
240−zypper을 이용해 `bat`을 설치할 수 있습니다:
333+zypper를 이용해 `bat`을 설치할 수 있습니다:
241334
242335```bash
243336zypper install bat
244337```
245338
246−### On macOS
339+### snap 패키지를 써서
340+
341+지금으로서는 추천하는 snap 패키지가 없습니다.
342+제공되는 패키지들이 존재할 수는 있지만, 공식적으로 지원되지 않으며
343+[문제](https://github.com/sharkdp/bat/issues/1519)가 있을 수 있습니다.
344+
345+
346+### macOS (또는 Linux)에서 Homebrew를 써서
247347
248−[Homebrew](http://braumeister.org/formula/bat)를 이용해 `bat`을 설치할 수 있습니다:
348+[macOS의 Homebrew](https://formulae.brew.sh/formula/bat) 또는
349+[Linux의 Homebrew](https://formulae.brew.sh/formula-linux/bat)를 이용하여
350+`bat`을 설치할 수 있습니다.
249351
250352```bash
251353brew install bat
252354```
253355
254−또는 [MacPorts](https://ports.macports.org/port/bat/summary)를 사용할 수도 있습니다:
356+### macOS에서 MacPorts를 써서
357+
358+[MacPorts](https://ports.macports.org/port/bat/summary)를 이용하여 `bat`을
359+설치할 수 있습니다:
255360
256361```bash
257362port install bat
258363```
259364
260−### On Windows
365+### Windows에서
366+
367+Windows에서 `bat`을 설치할 수 있는 몇 가지 옵션들이 있습니다.
368+먼저 `bat`을 설치한 후,
369+["Windows에서 `bat` 사용하기"](#windows에서-bat-사용하기) 섹션을 살펴보세요.
261370
262−Windows에서 `bat`을 설치할 수 있는 몇 가지 옵션들이 있습니다. 먼저 `bat`을 설치 한 후, ["Windows에서 사용하기"](#Windows에서-사용하기) 참고하시기 바랍니다.
371+#### 전제 조건
263372
264−#### With Chocolatey
373+[Visual C++ 재배포 가능](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)
374+패키지를 설치해야 합니다.
265375
266−[Chocolatey](https://chocolatey.org/packages/Bat)를 이용해 `bat`을 설치할 수 있습니다:
376+#### Chocolatey를 써서
377+
378+[Chocolatey](https://chocolatey.org/packages/Bat)를 이용해 `bat`을 설치할 수
379+있습니다:
267380```bash
268381choco install bat
269382```
270383
271−#### With Scoop
384+#### Scoop을 써서
272385
273386[scoop](https://scoop.sh/)을 이용해 `bat`을 설치할 수 있습니다:
274387```bash
275388scoop install bat
276389```
277−[Visual C++ Redistributable 패키지](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)를 같이 설치해 주어야 합니다.
278390
279−#### From prebuilt binaries:
391+#### 사전 빌드된 바이너리들로
280392
281−[릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서 빌드된 바이너리를 다운받을 수 있습니다.
393+[릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서 사전 빌드된
394+바이너리를 다운받을 수 있습니다.
282395
283−[Visual C++ Redistributable 패키지](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)를 같이 설치해 주어야 합니다.
396+[Visual C++ 재배포 가능](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)
397+패키지를 설치해야 합니다.
284398
285−### Via Docker
399+### 바이너리들로
286400
287−컨테이너에서 `bat`을 사용할 수 있는 [Docker image](https://hub.docker.com/r/danlynn/bat/)가 있습니다.:
288−```bash
289−docker pull danlynn/bat
290−alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
291−```
401+[릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서 다양한 아키텍처를
402+위해 사전 빌드된 버전들을 확인할 수 있습니다.
403+정적 링크 바이너리들은 파일 이름에 `musl` 이 포함된 아카이브들을 확인하세요.
292404
293−### Via Ansible
405+### 소스에서
294406
295−[Ansible](https://www.ansible.com/)을 사용해 `bat`을 설치할 수 있습니다:
407+`bat`의 소스를 빌드하기 위해서는, Rust 1.45 이상이 필요합니다.
408+`cargo`를 이용해 전부 빌드할 수 있습니다:
296409
297410```bash
298−# Install role on local machine
299−ansible-galaxy install aeimer.install_bat
300−```
301−
302−```yaml
303−---
304−# Playbook to install bat
305−- host: all
306− roles:
307− - aeimer.install_bat
411+cargo install --locked bat
308412```
309413
310−- [Ansible Galaxy](https://galaxy.ansible.com/aeimer/install_bat)
311−- [GitHub](https://github.com/aeimer/ansible-install-bat)
312−
313−다음 배포판들에서 동작합니다:
314−- Debian/Ubuntu
315−- ARM (eg. Raspberry PI)
316−- Arch Linux
317−- Void Linux
318−- FreeBSD
319−- MacOS
414+참고로 man 페이지나 셸 자동 완성 파일과 같은 부가 파일들은 이 방법으로 설치될 수
415+없습니다.
416+이것들은 `cargo`에 의해 생성이 되고 (`build` 밑의) cargo 타켓 폴더에서 찾을 수
417+있습니다.
320418
321−### From binaries
419+## 사용자화
322420
323−[릴리즈 페이지](https://github.com/sharkdp/bat/releases)에서 다양한 환경을 위해 빌드된 버전들을 확인 할 수 있습니다. 정적 링크 바이너리들은 아카이브에서 파일 이름에 `musl` 이 포함 파일로 확인 할 수 있습니다.
421+### 문법 강조 테마
324422
325−### From source
423+`bat --list-themes`을 사용하여 사용 가능한 문법 강조 테마들의 목록을 확인할 수
424+있습니다.
425+`TwoDark` 테마를 선택하려면, `--theme=TwoDark` 옵션과 함께 `bat`을 사용하거나
426+`BAT_THEME` 환경 변수를 `TwoDark`로 설정하세요.
427+셸 시작 파일에 `export BAT_THEME="TwoDark"` 를 정의해 영구적으로 설정할 수
428+있습니다.
429+이 밖에 `bat`의 [설정 파일](#설정-파일)을 이용할 수 있습니다.
326430
327−`bat`의 소스를 직접 빌드하기 위해서는, Rust 1.36 이상이 필요하며 `cargo`를 이용해 빌드할 수 있습니다.
431+만약 다른 테마들을 사용하여 특정 파일을 보고 싶다면, 다음 명령어를 쓸 수
432+있습니다(이 경우 [`fzf`](https://github.com/junegunn/fzf)가 필요합니다.)
328433
329434```bash
330−cargo install --locked bat
435+bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file"
331436```
332437
333−일부 플랫폼에서는 `llvm` 그리고/또는 `libclang-dev` 설치가 필요할 수도 있습니다.
438+`bat`은 기본적으로 어두운 배경에 적합합니다.
439+그러나 밝은 배경의 터미널을 사용한다면 `GitHub`이나 `OneHalfLight`과 같은 테마가
440+더 잘 어울립니다.
441+아래 [새로운 테마 추가하기](#새로운-테마-추가하기) 섹션에 따라 커스텀 테마를
442+사용할 수도 있습니다.
334443
335−## 커스터마이즈
444+### 8비트 테마
336445
337−### 문법 강조 테마
446+`bat`은 트루컬러 지원이 되더라도 항상
447+[8비트 색상](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors)을 사용하는
448+세 개의 테마가 있습니다.
338449
339−`bat --list-themes`을 사용하면, 현재 사용 가능한 문법 강조 테마들을 확인할 수 있습니다. `TwoDark` 테마 선택하는 경우, `--theme=TwoDark` 옵션과 함께 `bat`을 사용하거나 환경변수에서 `BAT_THEME`를 `TwoDark`로 세팅해주면 됩니다. 쉘 시작 파일에 `export BAT_THEME="TwoDark"` 를 정의해 계속 사용도 가능합니다. 이 밖에 `bat`의 [설정 파일](#설정-파일)을 이용할 수도 있습니다.
450+- `ansi`는 어떤 터미널에서도 무난하게 보입니다. 이는 3비트 색상을 사용합니다:
451+ 검정, 빨강, 녹색, 노랑, 파랑, 마젠타, 시안, 하양.
452+- `base16`은 [base16](https://github.com/chriskempson/base16) 터미널 테마를 위해
453+ 디자인되었습니다.
454+ 이는 [base16 스타일 가이드라인](https://github.com/chriskempson/base16/blob/master/styling.md)에
455+ 따라 4비트 색상(3비트 색상에 밝은 변형 추가)을 사용합니다.
456+- `base16-256`는 [base16-shell](https://github.com/chriskempson/base16-shell)을
457+ 위해 디자인되었습니다.
458+ 이는 16부터 21의 일부 밝은 색상을 8비트 색상으로 대치합니다.
459+ 단지 256-색상 터미널을 쓰지만 base16-shell을 쓰지 않는다고 해서 이것을
460+ 사용하지 **마십시오**.
340461
341−다른 테마를 미리 보고 싶은경우 다음 명령어와 같이 사용할 수 있습니다.(이 경우 [`fzf`](https://github.com/junegunn/fzf)가 필요합니다.)
462+이들 테마는 더 제한적이지만, 트루컬러 테마에 비해 두 장점이 있습니다:
342463
343−```bash
344−bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file"
345−```
346−`bat`의 기본 테마는 어두운 배경색 터미널에 적합합니다. 만일 밝은 배경색을 사용할 경우에는 `GitHub` 이나 `OneHalfLight` 과 같은 테마가 더 잘 어울립니다. 아래 [새로운 테마 추가하기](#새로운-테마-추가하기)에 따라 커스텀 테마를 사용할수도 있습니다.
464+- 이들은 3비트 혹은 4비트 색상을 쓰는 다른 터미널 소프트웨어와 더 잘
465+ 어울립니다.
466+- 만약 터미널 테마를 바꾼다면, 이미 화면 상의 `bat`의 출력도 이에 맞추어
467+ 업데이트됩니다.
347468
348469### 출력 스타일
349470
350−`--style` 옵션을 이용하여 `bat`의 출력 스타일을 변경 할 수 있습니다. 예를 들어, `--style=numbers,changes`는 Git 변경분과 라인 넘버에 대해서만 출력하며 눈금과 파일 헤더가 표시되지 않습니다. `BAT_STYLE` 환경 변수로 정의하여 계속해서 사용하거나`bat`의 [설정 파일](#설정-파일)을 사용할 수도 있습니다.
471+`--style` 옵션을 이용하면 `bat`의 출력 모양을 조절할 수 있습니다.
472+예를 들어, `--style=numbers,changes`를 통해 Git 변경분과 줄 번호는 출력하지만
473+격자와 파일 헤더는 출력하지 않을 수 있습니다.
474+`BAT_STYLE` 환경 변수를 정의하여 이러한 수정을 영구적으로 하거나 `bat`의
475+[설정 파일](#설정-파일)을 사용하세요.
351476
352−### 새로운 문법 강조 / 언어 추가하기
477+### 새로운 문법 / 언어 정의 추가하기
353478
354−`bat`은 문법 강조를 위해 [`syntect`](https://github.com/trishume/syntect/) 라이브러리를 사용하고 있습니다. `syntect`는 [Sublime Text의 `.sublime-syntax` 파일](https://www.sublimetext.com/docs/3/syntax.html)과 테마를 읽을 수 있습니다. 새로운 문법 강조를 추가하는 방법은 다음과 같습니다.
479+만약 `bat`에서 특정 문법이 지원되지 않을 경우, 다음의 절차를 통해 현재 `bat`
480+설치본에 새로운 문법을 쉽게 추가할 수 있습니다.
355481
356−우선 문법 정의 파일을 넣을 폴더를 만듭니다:
482+`bat`은 문법 강조를 위해 훌륭한
483+[`syntect`](https://github.com/trishume/syntect/) 라이브러리를 사용합니다.
484+`syntect`는 임의의 [Sublime Text의 `.sublime-syntax`
485+파일](https://www.sublimetext.com/docs/3/syntax.html)과 테마를 읽을 수 있습니다.
357486
358−```bash
359−mkdir -p "$(bat --config-dir)/syntaxes"
360−cd "$(bat --config-dir)/syntaxes"
487+[Package Control](https://packagecontrol.io/)에 Sublime 문법 패키지를 찾는
488+방법이 잘 정리되어 있습니다.
489+일단 문법을 찾았다면:
361490
362−# Put new '.sublime-syntax' language definition files
363−# in this folder (or its subdirectories), for example:
364−git clone https://github.com/tellnobody1/sublime-purescript-syntax
365−```
491+1. 문법 정의 파일들을 넣을 폴더를 만듭니다:
366492
367−다음 명령어를 통해 파일을 바이너리 캐시로 파싱합니다.
493+ ```bash
494+ mkdir -p "$(bat --config-dir)/syntaxes"
495+ cd "$(bat --config-dir)/syntaxes"
368496
369−```bash
370−bat cache --build
371−```
497+ # Put new '.sublime-syntax' language definition files
498+ # in this folder (or its subdirectories), for example:
499+ git clone https://github.com/tellnobody1/sublime-purescript-syntax
500+ ```
372501
373−마지막으로 `bat --list-languages`을 통해 새로운 언어가 사용 가능한지 확인합니다.
502+2. 이제 다음 명령어를 통해 파일들을 파싱(parse)하여 바이너리 캐시를 만듭니다.
374503
375−기본 설정으로 돌아가려면, 다음 명령어를 이용합니다.:
504+ ```bash
505+ bat cache --build
506+ ```
376507
377−```bash
378−bat cache --clear
379−```
508+3. 마지막으로, `bat --list-languages`로 새로 추가한 언어가 사용 가능한지
509+ 확인합니다.
510+
511+ 만약 기본 설정으로 돌아갈 일이 생긴다면, 다음 명령어를 이용합니다:
512+
513+ ```bash
514+ bat cache --clear
515+ ```
516+
517+4. 만약 특정 문법이 `bat`에 기본적으로 포함되어 있어야 한다고 생각한다면, 방침과
518+ 절차를 [여기](../doc/assets.md)서 읽은 후 "문법 요청(syntax request)"을 열어
519+ 주세요: [문법 요청하기](https://github.com/sharkdp/bat/issues/new?labels=syntax-request&template=syntax_request.md).
380520
381521### 새로운 테마 추가하기
382522
383−새로운 문법 정의 추가와 매우 유사합니다.
523+이 과정은 새로운 문법 정의 추가 방식과 매우 비슷합니다.
384524
385−먼저, 새로운 문법 강조 테마 폴더를 만듭니다.
525+먼저, 새로운 문법 강조 테마 폴더를 만듭니다.
386526```bash
387527mkdir -p "$(bat --config-dir)/themes"
388528cd "$(bat --config-dir)/themes"
@@ -394,32 +534,93 @@ git clone https://github.com/greggb/sublime-snazzy
394534bat cache --build
395535```
396536
397−마지막으로 `bat --list-themes`을 통해 새로운 테마가 사용 가능한지 확인합니다.
537+마지막으로 `bat --list-themes`을 통해 새로 추가한 테마들이 사용 가능한지
538+확인합니다.
539+
540+### 파일 타입 설정을 추가하거나 변경하기
541+
542+새로운 파일 이름 패턴을 추가하려면 (혹은 이미 존재하는 것을 변경하려면)
543+`--map-syntax` 커맨드 라인 옵션을 사용하세요.
544+이 옵션은 `pattern:syntax` 꼴의 인자를 받습니다.
545+이때 `pattern`은 파일 이름과 절대 파일 경로를 매치할 글로브(glob) 패턴입니다.
546+`syntax` 부분은 지원되는 언어의 전체 이름입니다
547+(`bat --list-languages`를 통해 개요를 확인하세요).
548+
549+참고: 이 옵션은 커맨드 라인에 넘겨 주는 것보다는 `bat`의 설정 파일에 넣는 것이
550+좋을 것입니다 (아래를 보세요).
551+
552+예시: "INI" 문법 강조를 `.conf` 파일 확장자의 모든 파일에 적용하려면, 다음을
553+사용하세요:
554+```bash
555+--map-syntax='*.conf:INI'
556+```
557+
558+예시: `.ignore`(완전 일치)이라는 이름의 모든 파일을 "Git Ignore" 문법으로
559+열려면, 다음을 사용하세요:
560+```bash
561+--map-syntax='.ignore:Git Ignore'
562+```
563+
564+예시: `/etc/apache2`의 하위 폴더들에 있는 모든 `.conf` 파일들을 "Apache Conf"
565+문법으로 열려면, 다음을 사용하세요 (이 대응(mapping)은 이미 내장되어 있습니다):
566+```bash
567+--map-syntax='/etc/apache2/**/*.conf:Apache Conf'
568+```
398569
399−### 다른 페이져 사용하기
570+### 다른 페이저 사용하기
400571
401−`bat`은 환경변수 `PAGER`로 사용할 페이져를 명시합니다. 만약 이 변수가 정의되어있지 않다면 `less`가 기본입니다. 만약 다른 페이져를 사용하고 싶다면 `PAGER` 변수를 수정하거나 `BAT_PAGER` 환경 변수로 `PAGER` 대신 정의 할 수도 있습니다.
572+`bat`은 환경 변수 `PAGER`에 명시된 페이저를 사용합니다.
573+이 변수가 정의되어 있지 않다면, `less`가 기본으로 사용됩니다.
574+만약 다른 페이저를 사용하고 싶다면, `PAGER` 변수를 수정하거나 `BAT_PAGER` 환경
575+변수를 설정하여 `PAGER`의 설정을 오버라이드(override)할 수 있습니다.
402576
403−만약 커맨드라인 인수로 넘기려면, `PAGER`/`BAT_PAGER` 변수를 정의를 통해 사용 할 수 있습니다. :
577+만약 커맨드라인 인수들을 페이저에게 넘겨 주려면, `PAGER`/`BAT_PAGER` 변수로
578+설정할 수 있습니다:
404579
405580```bash
406581export BAT_PAGER="less -RF"
407582```
408583
409−환경 변수 대신, `bat`의 [설정 파일](#설정-파일)에서 페이져를 설정 할 수도 있습니다.(`--pager` 옵션)
584+환경 변수를 사용하는 대신, `bat`의 [설정 파일](#설정-파일)로 페이저를 설정할
585+수도 있습니다 (`--pager` 옵션).
410586
411−**참고**: 기본적으로 페이져가 `less`로 설정 되어있다면, `bat`은 다음 옵션들을 받을 수 있습니다: `-R`/`--RAW-CONTROL-CHARS`,
412−`-F`/`--quit-if-one-screen` 그리고 `-X`/`--no-init`. 마지막 옵션(`-X`)은 530 이전 버전에서만 사용됩니다.
587+**참고**: 기본적으로, 페이저가 `less`로 설정되어 있다면 (그리고 커맨드 라인
588+옵션이 지정되어 있지 않다면), `bat`은 다음 옵션들을 페이저로 넘겨줍니다:
589+`-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen` 그리고 `-X`/`--no-init`.
590+마지막 옵션(`-X`)은 530 이전 버전의 `less`에만 사용됩니다.
413591
414−`-R` 옵션은 ANSI 컬러를 올바르게 해석하기 위해 필요합니다. 두번째 옵션 (`-F`)은 출력 크기가 터미널의 세로 크기보다 작을 경우 즉시 종료되도록 합니다.
415−페이져를 종료하기 위해 `q`를 누를 필요 없기 때문에 작은 파일을 다룰 때 용이합니다. 세번째 옵션(`-X`)는 `less` 이전 버전의 `--quit-if-one-screen` 기능과 함께 버그를 잡을 때 필요합니다. 안타깝게도, `less`의 마우스 휠 지원은 종료합니다.
592+`-R` 옵션은 ANSI 색상을 올바르게 해석하기 위해 필요합니다.
593+두 번째 옵션(`-F`)은 출력 크기가 터미널의 세로 크기보다 작을 경우 less가 즉시
594+종료되도록 합니다.
595+이는 작은 파일을 다룰 때 페이저를 종료하기 위해 `q`를 누를 필요 없어서
596+편리합니다.
597+세 번째 옵션(`-X`)는 예전 버전의 `less`에 있는 `--quit-if-one-screen` 기능의
598+버그를 고치기 위해 필요합니다.
599+안타깝게도, 이는 `less`의 마우스 휠 지원과 호환되지 않습니다.
416600
417−`less` 예전 버전에서 마우스 휠 기능을 활성화 시키려면, `-R` 옵션을 사용하면 됩니다. (위의 예제처럼, 이 옵션은 quit-if-one-screen 기능을 비활성화 시킵니다.)
418−530 이하 버전에서는 그대로 사용할 수 있습니다.
601+`less`의 예전 버전에서 마우스 휠 기능을 활성화하려면, `-R` 옵션을 넘겨주세요
602+(위의 예제처럼, 이 옵션은 quit-if-one-screen 기능을 비활성화합니다).
603+less 530과 이후 버전에서는 그대로 사용할 수 있습니다.
604+
605+### 들여쓰기
606+
607+`bat`은 페이저에 의존하지 않고 탭을 4 스페이스로 확장합니다.
608+이를 변경하려면 간단히 `--tabs` 인자에 표시되기를 원하는 스페이스 개수를
609+추가하세요.
610+
611+**참고**: (`bat`의 `--pager` 인자 혹은 `less`의 `LESS` 환경 변수를 통해)
612+페이저의 탭 길이를 지정하는 것은 효과가 없을 것인데, 이는 페이저가 이미
613+스페이스로 확장된 탭을 받기 때문입니다.
614+이 기능은 사이드바에 의한 들여쓰기 문제를 회피하기 위해 추가되었습니다.
615+`bat`을 `--tabs=0`과 함께 호출하면 이를 오버라이드하여 페이저가 탭을 처리하게
616+합니다.
419617
420618### 다크 모드
421619
422−macOS에서 다크 모드를 사용하고 있다면, OS 테마에 따라 다른 테마를 사용하도록 `bat`의 구성할 수 있습니다. 아래 코드는 라이트 모드에서는 `default` 테마를 다크모드에서는 `Github` 테마를 사용하는 방법입니다.
620+macOS에서 다크 모드를 사용하고 있다면, `bat`가 OS 테마에 따라 다른 테마를
621+사용하도록 구성할 수 있습니다.
622+아래 스니펫은 _다크 모드_에서는 `default` 테마를, _라이트 모드_에서는 `GitHub`
623+테마를 사용하는 방법입니다.
423624
424625```bash
425626alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
@@ -427,57 +628,89 @@ alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /de
427628
428629## 설정 파일
429630
430−`bat` 설정 파일로 커스터마이즈 할 수 있습니다. 파일의 위치는 운영 체제에 따라 다릅니다. 아래 커맨드를 통해 시스템의 기본 경로를 알 수 있습니다.
631+`bat`는 설정 파일로도 사용자화 할 수 있습니다.
632+설정 파일의 위치는 운영 체제에 따라 다릅니다.
633+아래 커맨드를 통해 시스템의 기본 경로를 확인할 수 있습니다.
431634```
432635bat --config-file
433636```
434637
435−또는, `BAT_CONFIG_PATH` 환경 변수를 사용하여 `bat`의 설정 파일 위치를 지정할 수 있습니다.
638+또는, `BAT_CONFIG_PATH` 환경 변수를 사용하여 `bat`가 설정 파일의 기본 경로
639+이외의 위치를 사용하도록 할 수 있습니다.
436640```bash
437641export BAT_CONFIG_PATH="/path/to/bat.conf"
438642```
439643
644+기본 설정 파일은 `--generate-config-file` 옵션으로 생성할 수 있습니다.
645+```bash
646+bat --generate-config-file
647+```
648+
440649### 포맷
441650
442−설정 파일은 명령어 인수들의 리스트 입니다. `bat --help`를 이용하여 가능한 옵션들과 값들을 확인해 볼 수 있습니다. 또, `#` 으로 주석을 추가할수도 있습니다.
651+설정 파일은 단순히 커맨드 라인 인자들의 리스트입니다.
652+`bat --help`로 가능한 모든 옵션과 값들을 확인하세요.
653+추가적으로, 줄 앞에 `#` 문자를 추가해 주석을 넣을 수 있습니다.
443654
444−설정 파일의 예:
655+설정 파일 예시:
445656```bash
446−# Set the theme to "TwoDark"
657+# "TwoDark" 테마 설정하기
447658--theme="TwoDark"
448659
449−# Show line numbers, Git modifications and file header (but no grid)
660+# 줄 번호, Git 변경 내용, 파일 헤더 보이기 (격자 없이)
450661--style="numbers,changes,header"
451662
452−# Use italic text on the terminal (not supported on all terminals)
663+# 터미널에서 이탤릭체 쓰기 (일부 터미널에서 미지원)
453664--italic-text=always
454665
455−# Use C++ syntax for .ino files
666+# .ino 파일에 C++ 문법 쓰기
456667--map-syntax "*.ino:C++"
457−
458−# Use ".gitignore"-style highlighting for ".ignore" files
459−--map-syntax ".ignore:Git Ignore"
460668```
461669
462−## Windows에서 사용하기
670+## Windows에서 `bat` 사용하기
671+
672+`bat`는 대부분의 경우 Windows에서 기본적으로 잘 작동하지만, 일부 기능은 추가적인
673+구성이 필요할 수 있습니다.
674+
675+#### 전제 조건
463676
464−`bat` 대부분의 경우 Windows에서 기본적으로 잘 작동하지만, 일부 기능에는 추가 적인 구성이 필요할 수 있습니다.
677+[Visual C++ 재배포 가능](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)
678+패키지를 설치해야 합니다.
465679
466−### 페이징
680+### 페이징
467681
468−Windows는 `more` 형식의 매우 제한된 페이저만이 포함되어있습니다. `less`용 Windows 바이너리는 [이 홈페이지](http://www.greenwoodsoftware.com/less/download.html)나 [Chocolatey](https://chocolatey.org/packages/Less)에서 다운로드 받을 수 있습니다. 이를 사용하려면 바이너리를 `PATH` 디렉토리에 배치하거나 [환경 변수로 정의](#using-a-different-pager) 하세요. [Chocolatey 패키지](#on-windows)로 `less`를 자동으로 설치할 수 있습니다.
682+Windows는 `more` 형식의 매우 제한된 페이저만 포함합니다.
683+Windows용 `less` 바이너리는
684+[공식 홈페이지](http://www.greenwoodsoftware.com/less/download.html)나
685+[Chocolatey](https://chocolatey.org/packages/Less)를 통해 다운로드 받을 수
686+있습니다.
687+이를 사용하려면 디렉터리 안의 바이너리를 `PATH`에 넣거나
688+[환경 변수로 정의](#using-a-different-pager)하세요.
689+[Chocolatey 패키지](#on-windows)는 `less`를 자동으로 설치합니다.
469690
470691### 색상
471692
472−Windows 10은 기본 내장기능으로 [v1511](https://en.wikipedia.org/wiki/Windows_10_version_history#Version_1511_(November_Update)) 이후의 `conhost.exe`(Command Prompt) 와 PowerShell, 그리고 최신 버전의 bash에서 색상을 지원합니다. 이전 버전의 Windows에서는, [ConEmu](https://conemu.github.io/)가 포함 된 [Cmder](http://cmder.net/)를 사용할 수 있습니다 .
693+Windows 10은
694+[v1511](https://en.wikipedia.org/wiki/Windows_10_version_history#Version_1511_(November_Update))부터
695+기본적으로 `conhost.exe`(Command Prompt)와 PowerShell에서 색상을 지원하며,
696+최신 버전의 bash에서도 색상을 지원합니다.
697+이전 버전의 Windows에서는, [ConEmu](https://conemu.github.io/)가 포함된
698+[Cmder](http://cmder.net/)를 사용할 수 있습니다.
473699
474−**참고:** `less`의 Git과 MSYS 버전은 Windows에서 색상을 올바르게 해석하지 않습니다. 다른 페이져가 설치되어 있지 않은 경우, `--paging=never` 하거나 `BAT_PAGER`를 빈 문자열로 설정하여 페이징을 완전히 비활성화 할 수 있습니다 .
700+**참고:** Git과 MSYS 버전의 `less`는 Windows에서 색상을 올바르게 해석하지
701+않습니다.
702+다른 페이저가 설치되어 있지 않은 경우, `--paging=never`을 넘겨주거나
703+`BAT_PAGER`을 빈 문자열로 설정하여 페이징을 완전히 비활성화 할 수 있습니다.
475704
476705### Cygwin
477706
478−Windows에서의 `bat`은 기본적으로 Cygwin의 unix 스타일의 경로(`/cygdrive/*`)를 지원하지 않습니다. cygwin 절대경로를 인자로 받았을 때, `bat`은 다음과 같이 오류를 반환합니다. `:The system cannot find the path specified. (os error 3)`
707+Windows에서의 `bat`은 기본적으로 Cygwin의 unix 스타일 경로(`/cygdrive/*`)를
708+지원하지 않습니다.
709+Cygwin 절대 경로를 인자로 받았을 때, `bat`은 다음과 같은 오류를 반환합니다:
710+`The system cannot find the path specified. (os error 3)`
479711
480−이 경우, wrapper를 만들거나 다음 함수를 `.bash_profile`추가하여 문제를 해결하실 수 있습니다 :
712+이는 wrapper를 만들거나 다음 함수를 `.bash_profile`에 추가하여 해결할 수
713+있습니다:
481714
482715```bash
483716bat() {
@@ -493,68 +726,94 @@ bat() {
493726}
494727```
495728
496−## 트러블슈팅
729+## 문제 해결
497730
498731### 터미널과 색상
499732
500−`bat`은 터미널 트루컬러 지원 여부와 상관없이 동작합니다. 하지만, 문법 강조 테마의 색상이 8-bit 컬러에는 최적화 되어 있지 않고 있으며, 24-bit 트루컬러 지원하는 터미널 사용하는 것을 적극 권장합니다.(`terminator`, `konsole`, `iTerm2`, ...). [이 글](https://gist.github.com/XVilka/8346728)에서 24-bit 트루컬러 지원하는 터미널들을 찾아보실 수 있습니다.
733+`bat`은 터미널의 트루컬러 지원 여부와 상관 없이 동작합니다.
734+그러나 대부분 문법 강조 테마의 색상은 8비트 색상에 최적화되어 있지 않습니다.
735+따라서 24비트 트루컬러 지원이 되는 터미널(`terminator`, `konsole`, `iTerm2`,
736+...)을 사용하는 것을 적극 권장합니다.
737+트루컬러를 지원하는 터미널들과 더 자세한 정보는
738+[이 글](https://gist.github.com/XVilka/8346728)에서 찾아보실 수 있습니다.
501739
502−사용하고 있는 터미널에서 `COLORTERM`을 `truecolor` 혹은
503−`24bit`으로 설정 되어있는지 확인하세요. 만약 아니라면, `bat`은 24-bit escape sequence를 지원되는지 여부를 판단 할 수 없습니다. (그리고 8-bit 색상으로 돌아갑니다.)
740+사용하고 있는 트루컬러 터미널에서 `COLORTERM` 변수를 `truecolor` 혹은
741+`24bit`로 설정되어 있는지 확인하세요.
742+그렇지 않을 경우, `bat`은 24비트 확장열(escape sequence)이 지원되는지 여부를
743+판단할 수 없습니다 (그리고 8비트 색상을 사용합니다).
504744
505−### 라인 숫자와 눈금이 잘 보이지 않는 경우
745+### 줄 번호와 격자가 잘 보이지 않는 경우
506746
507−다른 테마를 사용해 보세요. (`bat --list-themes`에서 테마들을 확인해 볼 수 있습니다.) `OneHalfDark` 과 `OneHalfLight` 테마는 눈금과 선의 색을 밝게 합니다.
747+다른 테마를 사용해 보세요 (`bat --list-themes`에서 목록을 볼 수 있습니다).
748+`OneHalfDark`와 `OneHalfLight` 테마는 더 밝은 눈금과 선의 색상을 사용합니다.
508749
509750### 파일 인코딩
510751
511−`bat`은 기본적으로 UTF-8과 UTF-8을 제공합니다. 다른 파일 인코딩의 경우, 자동 감지 되지 않으므로 UTF-8로 먼저 변환해 주어야 합니다. 이렇게 할 때, `iconv`를 사용 할 수 있습니다. 예를 들어, Latin-1 (ISO-8859-1)로 인코딩된 PHP파일이라면 다음과 같이 사용할 수 있습니다.:
752+`bat`은 기본적으로 UTF-8과 UTF-16을 지원합니다.
753+다른 모든 종류의 파일 인코딩에 대해서는, 일반적으로 인코딩을 자동으로 판별하는
754+방법이 없기 때문에 먼저 UTF-8으로 변환해야 할 수 있습니다.
755+이를 위해 `iconv`를 사용할 수 있습니다.
756+예시: Latin-1(ISO-8859-1)로 인코딩된 PHP 파일은 다음과 같이 처리할 수 있습니다:
512757``` bash
513758iconv -f ISO-8859-1 -t UTF-8 my-file.php | bat
514759```
515−참고: `bat`으로 자동 감지가 되지 않는 경우에는 `-l`/`--language` 옵션을 사용할 수도 있습니다.
760+참고: `bat`으로 문법 자동 감지가 되지 않는 경우에는 `-l`/`--language` 옵션을
761+사용할 수 있습니다.
516762
517−## 배포
763+## 개발
518764
519765```bash
520−# Recursive clone to retrieve all submodules
766+# 모든 서브모듈을 받기 위해 재귀적으로 복제하기
521767git clone --recursive https://github.com/sharkdp/bat
522768
523−# Build (debug version)
769+# (디버그 버전) 빌드
524770cd bat
525771cargo build --bins
526772
527−# Run unit tests and integration tests
773+# 단위 테스트와 통합 테스트 실행
528774cargo test
529775
530−# Install (release version)
776+# (배포 버전) 설치
531777cargo install --locked
532778
533−# Build a bat binary with modified syntaxes and themes
779+# 수정된 문법과 테마가 적용된 bat 바이너리 빌드
534780bash assets/create.sh
535781cargo install --locked --force
536782```
537783
784+`bat`의 pretty-printing 기능을 라이브러리로 사용하는 애플리케이션을 만들고
785+싶다면, [API 문서](https://docs.rs/bat/)를 살펴보세요.
786+참고로 `bat`에 라이브러리로써 의존한다면, `regex-onig`나 `regex-fancy`를
787+기능으로 사용해야 합니다.
788+
789+## 기여하기
790+
791+[`CONTRIBUTING.md`](../CONTRIBUTING.md) 가이드를 살펴보세요.
792+
538793## 메인테이너들
539794
540795- [sharkdp](https://github.com/sharkdp)
541796- [eth-p](https://github.com/eth-p)
797+- [keith-hall](https://github.com/keith-hall)
798+- [Enselic](https://github.com/Enselic)
542799
543800## 프로젝트 목표와 대안들
544801
545−`bat`은 아래와 같은 목표를 달성하려고 합니다:
546−
547−- 아름답고 발전된 문법 강조 기능
548−- Git 연동을 통한 파일 수정 내역 확인
549−- (POSIX)`cat`의 대체제
550−- 사용자 친화적인 CLI 제공
802+`bat`은 다음과 같은 목표를 달성하려고 합니다:
551803
804+- 아름답고 발전된 문법 강조 기능 제공
805+- Git과의 연동을 통한 파일 변경 내용 확인
806+- (POSIX) `cat`의 대체제
807+- 사용자 친화적인 커맨드 라인 인터페이스 제공
552808
553−비슷한 프로그램들을 찾고 있다면, 많은 대안들이 있습니다. 비교는 [이 문서]((doc/alternatives.md))를 참조해주세요.
809+비슷한 프로그램들을 찾고 있다면 많은 대안들이 있습니다.
810+비교는 [이 문서](../doc/alternatives.md)를 참조해 주세요.
554811
555812## 라이센스
556813Copyright (c) 2018-2021 [bat-developers](https://github.com/sharkdp/bat).
557814
558−`bat`는 MIT 라이센스 및 Apache 라이센스 2.0의 조건에 따라 배포됩니다.
815+`bat`는 여러분의 선택에 따라 MIT 라이센스 또는 Apache 라이센스 2.0의 조건에 따라
816+배포됩니다.
559817
560−라이센스 세부사항은 [LICENSE-APACHE](LICENSE-APACHE)와 [LICENSE-MIT](LICENSE-MIT)를 참조하세요.
818+라이센스의 세부사항은 [LICENSE-APACHE](LICENSE-APACHE)와
819+[LICENSE-MIT](LICENSE-MIT)를 참조하세요.