mirror of
https://github.com/sharkdp/bat
synced 2024-11-16 21:25:56 +00:00
fix: doc/README-ja.md
- Synchronized the contents of `README.md`. - Fixed `README.md` to match the line number of text. - Translated to Japanese. - Fixed menu link anchor.
This commit is contained in:
parent
1bc62cd7b5
commit
260c5dcb75
349
doc/README-ja.md
349
doc/README-ja.md
@ -8,41 +8,44 @@
|
|||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<a href="#syntax-highlighting">特徴</a> •
|
<a href="#シンタックスハイライト">特徴</a> •
|
||||||
<a href="#how-to-use">使い方</a> •
|
<a href="#使い方">使い方</a> •
|
||||||
<a href="#installation">インストール</a> •
|
<a href="#インストール">インストール</a> •
|
||||||
<a href="#customization">カスタマイズ</a> •
|
<a href="#カスタマイズ">カスタマイズ</a> •
|
||||||
<a href="#project-goals-and-alternatives">プロジェクトの目標と既存の類似したOSS</a> •
|
<a href="#プロジェクトの目標と既存の類似したOSS">プロジェクトの目標と既存の類似したOSS</a> •
|
||||||
翻訳 [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>][<a href="README-ja.md">日本語</a>]
|
翻訳 [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>][<a href="README-ja.md">日本語</a>]
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
### シンタックスハイライト
|
### シンタックスハイライト
|
||||||
|
|
||||||
`bat` は多くのプログラミング言語やマークアップ言語のシンタックスハイライトに対応しています。
|
`bat` は多くのプログラミング言語やマークアップ言語の
|
||||||
|
シンタックスハイライトに対応しています:
|
||||||
|
|
||||||
![Syntax highlighting example](https://imgur.com/rGsdnDe.png)
|
![Syntax highlighting example](https://imgur.com/rGsdnDe.png)
|
||||||
|
|
||||||
### Gitの統合
|
### Gitの統合
|
||||||
|
|
||||||
|
`bat` は `git` とも連携しており、差分を表現する記号が表示されます
|
||||||
`bat` は `git` とも連携しており、差分を表現する記号が表示されます(図の左端):
|
(図の左端):
|
||||||
|
|
||||||
![Git integration example](https://i.imgur.com/2lSW4RE.png)
|
![Git integration example](https://i.imgur.com/2lSW4RE.png)
|
||||||
|
|
||||||
### 空白文字の可視化
|
### 印刷できない文字の表示
|
||||||
|
|
||||||
`-A`/`--show-all` オプションをつけることで、空白文字を可視化できます:
|
`-A`/`--show-all` オプションをつけることで
|
||||||
|
印刷できない文字を可視化できます:
|
||||||
|
|
||||||
![Non-printable character example](https://i.imgur.com/WndGp9H.png)
|
![Non-printable character example](https://i.imgur.com/WndGp9H.png)
|
||||||
|
|
||||||
### 自動呼び出し
|
### 自動ページング
|
||||||
|
|
||||||
出力が1つの画面に対して大きすぎる場合、`bat` は自身の出力を `less` にパイプで繋げることが可能です。
|
出力が1つの画面に対して大きすぎる場合、`bat` は自身の出力を `less` にパイプで繋げることが可能です。
|
||||||
|
|
||||||
### ファイルの連結
|
### ファイルの連結
|
||||||
|
|
||||||
あなたはさらにファイルを連結させるに使うことも可能です:wink:。
|
あなたはさらにファイルを連結させるに使うことも可能です:wink:。
|
||||||
`bat` は非対話型のターミナルを検出すると、いつでも `cat` の完全互換として振る舞い、
|
`bat` は非対話型のターミナルを検出すると、
|
||||||
|
いつでも `cat` の完全互換として振る舞い、
|
||||||
プレーンなファイルを表示します。
|
プレーンなファイルを表示します。
|
||||||
|
|
||||||
## 使い方
|
## 使い方
|
||||||
@ -88,117 +91,223 @@ bat -n main.rs # show line numbers (only)
|
|||||||
bat f - g # output 'f', then stdin, then 'g'.
|
bat f - g # output 'f', then stdin, then 'g'.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 他のツールとの統合
|
||||||
|
|
||||||
|
#### `find` or `fd`
|
||||||
|
|
||||||
|
`find` の `-exec` オプションを使用して、`bat` ですべての検索結果をプレビューできます:
|
||||||
|
```bash
|
||||||
|
find … -exec bat {} +
|
||||||
|
```
|
||||||
|
|
||||||
|
[`fd`](https://github.com/sharkdp/fd) を使用している場合は、`-X` /`-exec-batch` オプションを使用して同じことを行うことができます:
|
||||||
|
```bash
|
||||||
|
fd … -X bat
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `ripgrep`
|
||||||
|
|
||||||
|
[`batgrep`](https://github.com/eth-p/bat-extras/blob/master/doc/batgrep.md) では、[`ripgrep`](https://github.com/BurntSushi/ripgrep) 検索結果のプリンターとして `bat` を使用できます。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
batgrep needle src/
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `tail -f`
|
||||||
|
|
||||||
|
`bat` を `tail -f` と組み合わせて、構文強調表示を使用して特定のファイルを継続的に監視できます。
|
||||||
|
```bash
|
||||||
|
tail -f /var/log/pacman.log | bat --paging=never -l log
|
||||||
|
```
|
||||||
|
Note that we have to switch off paging in order for this to work. We have also specified the syntax
|
||||||
|
explicitly (`-l log`), as it can not be auto-detected in this case.
|
||||||
|
|
||||||
|
#### `git`
|
||||||
|
|
||||||
|
`bat` を `git show` と組み合わせて、
|
||||||
|
適切な構文強調表示を使用して特定のファイルの古いバージョンを表示できます:
|
||||||
|
```bash
|
||||||
|
git show v0.6.0:src/main.rs | bat -l rs
|
||||||
|
```
|
||||||
|
|
||||||
|
差分内の構文強調表示は現在サポートされていないことに注意してください。 これを探しているなら、[`delta`](https://github.com/dandavison/delta) をチェックしてください。
|
||||||
|
|
||||||
|
#### `xclip`
|
||||||
|
|
||||||
|
`bat` の出力の行番号と Git 変更マーカーにより、ファイルの内容をコピーするのが難しくなる場合があります。
|
||||||
|
これを防ぐには、`-p` / `-plain` オプションを使用して `bat` を呼び出すか、
|
||||||
|
単に出力を `xclip` にパイプします:
|
||||||
|
```bash
|
||||||
|
bat main.cpp | xclip
|
||||||
|
```
|
||||||
|
`bat` は出力がリダイレクトされていることを検出し、プレーンファイルの内容を出力します。
|
||||||
|
|
||||||
|
#### `man`
|
||||||
|
|
||||||
|
`bat` は `MANPAGER` 環境変数を設定することにより、
|
||||||
|
`man` の色付けページャーとして使用できます:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export MANPAGER="sh -c 'col -bx | bat -l man -p'"
|
||||||
|
man 2 select
|
||||||
|
```
|
||||||
|
|
||||||
|
フォーマットの問題が発生した場合は
|
||||||
|
`MANROFFOPT = "-c"` を設定する必要もあります。
|
||||||
|
|
||||||
|
これを新しいコマンドにバンドルしたい場合は [`batman`](https://github.com/eth-p/bat-extras/blob/master/doc/batman.md) も使用できます。
|
||||||
|
|
||||||
|
[Manpage syntax](assets/syntaxes/Manpage.sublime-syntax) はこのリポジトリで開発されており、まだ作業が必要であることに注意してください。
|
||||||
|
|
||||||
|
#### `prettier` / `shfmt` / `rustfmt`
|
||||||
|
|
||||||
|
[`prettybat`](https://github.com/eth-p/bat-extras/blob/master/doc/prettybat.md) スクリプトは、コードをフォーマットし、`bat` で印刷するラッパーです。
|
||||||
|
|
||||||
|
|
||||||
## インストール
|
## インストール
|
||||||
|
|
||||||
### Ubuntu
|
[![Packaging status](https://repology.org/badge/vertical-allrepos/bat.svg)](https://repology.org/project/bat/versions)
|
||||||
|
|
||||||
|
### On Ubuntu
|
||||||
*... や他のDebianベースのLinuxディストリビューション*
|
*... や他のDebianベースのLinuxディストリビューション*
|
||||||
|
|
||||||
最新の `.deb` パッケージを[こちら](https://github.com/sharkdp/bat/releases)からダウンロードして、インストールしてください:
|
Ubuntu Eoan 19.10 または Debian 不安定版 sid 以降の [the Ubuntu `bat` package](https://packages.ubuntu.com/eoan/bat) または [the Debian `bat` package](https://packages.debian.org/sid/bat) をインストールできます:
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
|
apt install bat
|
||||||
|
```
|
||||||
|
|
||||||
|
batの最新リリースを実行する場合、または Ubuntu/Debian の古いバージョンを使用している場合は、[release page](https://github.com/sharkdp/bat/releases) から最新の `.deb` パッケージをダウンロードし、
|
||||||
|
次の方法でインストールします:
|
||||||
|
```bash
|
||||||
sudo dpkg -i bat_0.12.1_amd64.deb # adapt version number and architecture
|
sudo dpkg -i bat_0.12.1_amd64.deb # adapt version number and architecture
|
||||||
```
|
```
|
||||||
|
|
||||||
### Arch Linux
|
### On Alpine Linux
|
||||||
|
|
||||||
[Arch Linuxの公式リソース](https://www.archlinux.org/packages/community/x86_64/bat/)からインストールできます。
|
適切なリポジトリが有効になっている場合は、
|
||||||
|
公式のソースから [`bat` package](https://pkgs.alpinelinux.org/packages?name=bat) をインストールできます:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
apk add bat
|
||||||
|
```
|
||||||
|
|
||||||
|
### On Arch Linux
|
||||||
|
|
||||||
|
[Arch Linuxの公式リソース](https://www.archlinux.org/packages/community/x86_64/bat/)
|
||||||
|
からインストールできます。
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pacman -S bat
|
pacman -S bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### Void Linux
|
### On Fedora
|
||||||
|
|
||||||
xbps-ininstall経由で `bat` をインストールできます。
|
公式の [Fedora Modular](https://docs.fedoraproject.org/en-US/modularity/using-modules/) リポジトリから [the `bat` package](https://koji.fedoraproject.org/koji/packageinfo?packageID=27506) をインストールできます。
|
||||||
|
|
||||||
```
|
|
||||||
xbps-install -S bat
|
|
||||||
```
|
|
||||||
|
|
||||||
### Fedora
|
|
||||||
|
|
||||||
[Fedora Modular](https://docs.fedoraproject.org/en-US/modularity/using-modules/)経由で `bat` をインストールできます。これはFedora 29以上ではデフォルトで有効化されています。 もしそうでなければ、 `dnf install fedora-repos-modular` を実行してセットアップし、 `fedora-modular` と `fedora-updates-modular` が `/etc/yum.repos.d` で有効化されていることを確認してください。
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
dnf module install bat
|
dnf install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### Gentoo Linux
|
### On Gentoo Linux
|
||||||
|
|
||||||
[Gentoo Linuxの公式リソース](https://packages.gentoo.org/packages/sys-apps/bat)からインストールできます。
|
公式ソースから
|
||||||
|
[the `bat` package](https://packages.gentoo.org/packages/sys-apps/bat) をインストールできます。
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
emerge sys-apps/bat
|
emerge sys-apps/bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### FreeBSD
|
### On Void Linux
|
||||||
|
|
||||||
事前にコンパイル済みである[pkg](https://www.freshports.org/textproc/bat)をインストールできます:
|
xbps-ininstall経由で `bat` をインストールできます。
|
||||||
|
```
|
||||||
|
xbps-install -S bat
|
||||||
|
```
|
||||||
|
|
||||||
|
### On FreeBSD
|
||||||
|
|
||||||
|
pkg を使用してプリコンパイルされた [`bat` package](https://www.freshports.org/textproc/bat) をインストールできます:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pkg install bat
|
pkg install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
または、FreeBSDのportsから自身でビルドすることも可能です:
|
または FreeBSD ポートから自分でビルドする:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /usr/ports/textproc/bat
|
cd /usr/ports/textproc/bat
|
||||||
make install
|
make install
|
||||||
```
|
```
|
||||||
|
|
||||||
### nix
|
### Via nix
|
||||||
|
|
||||||
`bat` を[nix package manager](https://nixos.org/nix)経由でインストールすることができます:
|
`bat` を [nix package manager](https://nixos.org/nix) 経由でインストールすることができます:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
nix-env -i bat
|
nix-env -i bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### openSUSE
|
### On openSUSE
|
||||||
|
|
||||||
You can install `bat` with zypper:
|
|
||||||
|
|
||||||
`bat` をzypperでインストールすることができます:
|
`bat` をzypperでインストールすることができます:
|
||||||
|
|
||||||
```
|
```bash
|
||||||
zypper install bat
|
zypper install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### macOS
|
### On macOS
|
||||||
|
|
||||||
[Homebrew](http://braumeister.org/formula/bat)でインストールすることができます:
|
|
||||||
|
|
||||||
|
[Homebrew](http://braumeister.org/formula/bat)で `bat` をインストールできます:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
brew install bat
|
brew install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### Windows
|
または [MacPorts](https://ports.macports.org/port/bat/summary) で `bat` をインストールします:
|
||||||
|
|
||||||
You can download prebuilt binaries from the [Release page],
|
```bash
|
||||||
or install it with :
|
port install bat
|
||||||
|
```
|
||||||
|
|
||||||
事前にビルド済みのバイナリを[リリースページ](https://github.com/sharkdp/bat/releases)からダウンロードすることができます。または、[scoop](https://scoop.sh/)でインストールすることも可能です。
|
### On Windows
|
||||||
|
|
||||||
|
Windowsにbatをインストールするいくつかのオプションがあります。
|
||||||
|
batをインストールしたら [Windowsでのbatの使用](#windows-での-bat-の利用) セクションをご覧ください。
|
||||||
|
|
||||||
|
#### With Chocolatey
|
||||||
|
|
||||||
|
[Chocolatey](https://chocolatey.org/packages/Bat) から `bat` をインストールできます:
|
||||||
|
```bash
|
||||||
|
choco install bat
|
||||||
|
```
|
||||||
|
|
||||||
|
#### With Scoop
|
||||||
|
|
||||||
|
[scoop](https://scoop.sh/) から `bat` をインストールできます:
|
||||||
```bash
|
```bash
|
||||||
scoop install bat
|
scoop install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
[See below](#using-bat-on-windows) for notes.
|
[Visual C ++再頒布可能](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) パッケージをインストールする必要があります。
|
||||||
|
|
||||||
### Docker
|
#### From prebuilt binaries:
|
||||||
|
|
||||||
|
[リリースページ](https://github.com/sharkdp/bat/releases) からビルド済みのバイナリをダウンロードできます。
|
||||||
|
|
||||||
コンテナ内で`bat` を使いたい方のために[Docker image](https://hub.docker.com/r/danlynn/bat/)が用意されています。
|
[Visual C ++再頒布可能](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) パッケージをインストールする必要があります。
|
||||||
|
|
||||||
|
### Via Docker
|
||||||
|
|
||||||
|
コンテナ内で `bat` を使いたい方のために [Docker image](https://hub.docker.com/r/danlynn/bat/) が用意されています:
|
||||||
```bash
|
```bash
|
||||||
docker pull danlynn/bat
|
docker pull danlynn/bat
|
||||||
alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
|
alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
|
||||||
```
|
```
|
||||||
|
|
||||||
### Ansible
|
### Via Ansible
|
||||||
|
|
||||||
[Ansible](https://www.ansible.com/)でインストールすることができます:
|
[Ansible](https://www.ansible.com/) でインストールすることができます:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install role on local machine
|
# Install role on local machine
|
||||||
@ -232,38 +341,51 @@ ansible-galaxy install aeimer.install_bat
|
|||||||
### From source
|
### From source
|
||||||
|
|
||||||
|
|
||||||
`bat` をソースからビルドしたいならば、Rust 1.29 以上の環境が必要です。そして、 `cargo` をビルドに対して使用します:
|
`bat` をソースからビルドしたいならば、Rust 1.36 以上の環境が必要です。
|
||||||
|
そして `cargo` をビルドに対して使用します:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cargo install bat
|
cargo install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
|
一部のプラットフォームでは `llvm` および/または `libclang-dev` のインストールが必要になる場合があります。
|
||||||
|
|
||||||
## カスタマイズ
|
## カスタマイズ
|
||||||
|
|
||||||
### ハイライト テーマ
|
### ハイライト テーマ
|
||||||
|
|
||||||
`bat --list-themes` を使うと現在利用可能なシンタックスハイライトのテーマを入手できます。 `TwoDark` テーマを選ぶためには `--theme=TwoDark` オプションをつけるか `BAT_THEME` という環境変数に `TwoDark` を代入する必要があります。 シェルの起動ファイルに `export BAT_THEME="TwoDark"` と定義すればその設定が変わることはないでしょう。あるいは、 `bat` の[設定ファイル](https://github.com/sharkdp/bat#configuration-file)を利用してください。
|
`bat --list-themes` を使うと現在利用可能なシンタックスハイライトのテーマを入手できます。
|
||||||
|
`TwoDark` テーマを選ぶためには
|
||||||
|
`--theme=TwoDark` オプションをつけるか `BAT_THEME` という環境変数に
|
||||||
|
`TwoDark` を代入する必要があります。 シェルの起動ファイルに `export BAT_THEME="TwoDark"`
|
||||||
|
と定義すればその設定が変わることはないでしょう。あるいは、 `bat` の
|
||||||
|
[設定ファイル](#設定ファイル)を利用してください。
|
||||||
|
|
||||||
|
カスタムファイルでさまざまなテーマをプレビューする場合は、
|
||||||
もし、ファイルにより異なるテーマを利用したい場合は、以下の[`fzf`](https://github.com/junegunn/fzf)を利用した以下のコマンドを使うことができます:
|
次のコマンドを使用できます(これには [`fzf`](https://github.com/junegunn/fzf) が必要です)。
|
||||||
``` bash
|
``` bash
|
||||||
bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file"
|
bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file"
|
||||||
```
|
```
|
||||||
|
|
||||||
`bat` はデフォルトだと黒い背景色のターミナルに適しています。しかし、`GitHub` や `OneHalfLight` のような白い背景色のテーマでもいい感じにすることができます。
|
`bat` はデフォルトだと黒い背景色のターミナルに適しています。
|
||||||
以下のカスタムテーマを参考にしてみてください。
|
しかし、`GitHub` や `OneHalfLight` のような白い背景色のテーマでもいい感じにすることができます。
|
||||||
['Adding new themes' section below](https://github.com/sharkdp/bat#adding-new-themes)
|
['新しいテーマの追加' セクションに従って](#新しいテーマの追加)
|
||||||
|
カスタムテーマを使用することもできます。
|
||||||
|
|
||||||
### 出力のスタイル
|
### 出力のスタイル
|
||||||
|
|
||||||
`--style` を使うことで `bat` の表示の見た目を変更することができます。例えば、 `--style=numbers,changes` と入力します。すると、Gitの差分と行番号だけが表示され、グリッド線とファイルヘッダーは表示されません。
|
`--style` を使うことで `bat` の表示の見た目を変更することができます。
|
||||||
|
例えば、 `--style=numbers,changes` と入力します。
|
||||||
|
すると、Gitの差分と行番号だけが表示され、グリッド線とファイルヘッダーは表示されません。
|
||||||
環境変数に `BAT_STYLE` を定義するとこれらの設定を永続的に使用することができます。
|
環境変数に `BAT_STYLE` を定義するとこれらの設定を永続的に使用することができます。
|
||||||
[設定ファイル](https://github.com/sharkdp/bat#configuration-file)を参考にしても良いでしょう。
|
[設定ファイル](#設定ファイル) を参考にしても良いでしょう。
|
||||||
|
|
||||||
### 新しい構文の追加 / 言語の定義
|
### 新しい構文の追加 / 言語の定義
|
||||||
|
|
||||||
`bat` はシンタックスハイライトのための[`syntext`](https://github.com/trishume/syntect/)という最高にイケてるライブラリを使用しています。`syntect` はSublime Textのために作られた[`.sublime-syntax` file](https://www.sublimetext.com/docs/3/syntax.html)テーマです。新しい構文を定義するために以下の手順を行います。
|
`bat` はシンタックスハイライトのための [`syntext`](https://github.com/trishume/syntect/)
|
||||||
|
という素晴らしいライブラリを使用しています。`syntect` は、
|
||||||
|
[Sublime Text の `.sublime-syntax` ファイル](https://www.sublimetext.com/docs/3/syntax.html)
|
||||||
|
とテーマを読み取ることができます。新しい構文を定義するために以下の手順を行います。
|
||||||
|
|
||||||
構文定義ファイルを入れておくためのフォルダを作る:
|
構文定義ファイルを入れておくためのフォルダを作る:
|
||||||
|
|
||||||
@ -283,6 +405,7 @@ bat cache --build
|
|||||||
```
|
```
|
||||||
|
|
||||||
最後に `bat --list-languages` と入力すると新しい言語が利用可能かどうかチェックします。
|
最後に `bat --list-languages` と入力すると新しい言語が利用可能かどうかチェックします。
|
||||||
|
|
||||||
デフォルトの設定に戻したいときは以下のコマンドを実行します:
|
デフォルトの設定に戻したいときは以下のコマンドを実行します:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -310,37 +433,60 @@ bat cache --build
|
|||||||
### 異なるページャーの使用
|
### 異なるページャーの使用
|
||||||
|
|
||||||
`bat` は環境変数 `PAGER` に使用するページャーを明記します。
|
`bat` は環境変数 `PAGER` に使用するページャーを明記します。
|
||||||
この環境変数が定義されていない場合、デフォルトで `less` が使用されます。もし、異なるページャーが使用したい場合は、`PAGER` を修正してください。または、`PAGER` を上書きする環境変数として `BAT_PAGER` を定義することも可能です。
|
この環境変数が定義されていない場合、デフォルトで `less` が使用されます。
|
||||||
|
もし、異なるページャーが使用したい場合は、`PAGER` を修正してください。
|
||||||
|
または、`PAGER` を上書きする環境変数として `BAT_PAGER` を定義することも可能です。
|
||||||
|
|
||||||
|
もし、ページャーにコマンドライン引数を渡したい場合は、
|
||||||
|
`PAGER`/`BAT_PAGER` 環境変数を定義してください:
|
||||||
|
|
||||||
もし、ページャーにコマンドライン引数を渡したい場合は、 `PAGER`/`BAT_PAGER` 環境変数を定義してください:
|
|
||||||
```bash
|
```bash
|
||||||
export BAT_PAGER="less -RF"
|
export BAT_PAGER="less -RF"
|
||||||
```
|
```
|
||||||
|
|
||||||
環境変数を利用する代わりに、 `bat` の[設定ファイル](https://github.com/sharkdp/bat#configuration-file)の `--pager` オプションを使用することも可能です。
|
環境変数を利用する代わりに、 `bat` の [設定ファイル](#設定ファイル) を使用して設定も可能です(`--pager` オプション)
|
||||||
|
|
||||||
**注意**: デフォルトにより、ページャーが `less` にセットされているならば `bat` は以下のコマンドラインを受け付けるでしょう。
|
**注意**: デフォルトにより、ページャーが `less` にセットされているならば
|
||||||
ページャーのオプション: `-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen` , `-X`/`--no-init`
|
`bat` はページャーの以下のコマンドラインオプション を受け付けるでしょう:
|
||||||
最初の `-R` はANSIカラーを正しく解釈するために必要です。2番目の `-F` は出力サイズがターミナルの縦のサイズよりも小さいならば `less` に即座に終了するように命令します。したがって、少量のファイルのためにページャーを終了する `q` を押す必要がありません。3番目のオプションの `-X` は `less` の古いバージョンの機能である `--quit-if-one-screen` でバグを修正するために必要です。運の悪いことに、これは `less` のマウス-ホイールのサポートを無効にします。もし、マウス-ホイール スクローリングを有効にしたいなら、`-R` だけをオプションとしてつけてください(ただし、これは `--quit-if-one-screen` を無効にするでしょう)。または、 `less` の最近バージョンを利用し、 `-RF` をつけてください。 これは望ましいことに `--quit-if-one-screen` と マウス-ホイールスクローリングの両方を有効にするでしょう。
|
`-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen` そして `-X`/`--no-init`。
|
||||||
|
最後のオプション(-X)は、530 より古いバージョンにのみ使用されます。
|
||||||
|
|
||||||
スクロールが未だ動作しないのであれば、加えて `-S` オプションを追加してみてください。
|
`-R` オプションは、ANSIカラーを正しく解釈するために必要です。
|
||||||
|
2番目のオプション(`-F`)は、出力サイズが端末の垂直サイズよりも小さい場合、すぐに終了するようにlessに指示します。
|
||||||
|
これは、ページャーを終了するために `q` を押す必要がないため、小さなファイルに便利です。
|
||||||
|
3番目のオプション(`-X`)は、`less` の古いバージョンの `--quit-if-one-screen` 機能のバグを修正するために必要です。
|
||||||
|
残念ながら、`less` のマウスホイールのサポートも少なくなります。
|
||||||
|
|
||||||
|
`less` の古いバージョンでマウスホイールのスクロールを有効にしたい場合は、
|
||||||
|
`-R` だけを渡すことができます(上記の例のように、これは1画面終了機能を無効にします)。
|
||||||
|
530以下の場合は、そのまま使用できます。
|
||||||
|
|
||||||
|
### Dark mode
|
||||||
|
|
||||||
|
macOSでダークモード機能を使用する場合、OSテーマに基づいて異なるテーマを使用するように `bat` を構成することができます。
|
||||||
|
次のスニペットは、ライトモードの場合は `デフォルト` のテーマを使用し、
|
||||||
|
ダークモードの場合は `GitHub` テーマを使用します。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
|
||||||
|
```
|
||||||
|
|
||||||
## 設定ファイル
|
## 設定ファイル
|
||||||
|
|
||||||
|
`bat` は設定ファイルでカスタマイズすることが可能です。ファイルの場所はOSに依存します。
|
||||||
`bat` は設定ファイルでカスタマイズすることが可能です。ファイルの場所はOSに依存します。使用しているOSのデフォルトパスを調べるには以下のコマンドを実行してください:
|
使用しているOSのデフォルトパスを調べるには以下のコマンドを実行してください:
|
||||||
```
|
```
|
||||||
bat --config-file
|
bat --config-file
|
||||||
```
|
```
|
||||||
|
|
||||||
また、環境変数 `BAT_CONFIG_PATH` に設定ファイルの場所を明記することもできます:
|
または、`BAT_CONFIG_PATH` 環境変数を使用して、`bat` が
|
||||||
|
構成ファイルのデフォルト以外の場所を指すようにすることができます:
|
||||||
```bash
|
```bash
|
||||||
export BAT_CONFIG_PATH="/path/to/bat.conf"
|
export BAT_CONFIG_PATH="/path/to/bat.conf"
|
||||||
```
|
```
|
||||||
|
|
||||||
### フォーマット
|
### フォーマット
|
||||||
|
|
||||||
|
|
||||||
この設定ファイルはコマンドライン引数の単純なリストです。 `bat --help` を利用すると、利用可能なオプションとその値を閲覧することができます。さらに、`#` でコメント文を加えることができます。
|
この設定ファイルはコマンドライン引数の単純なリストです。 `bat --help` を利用すると、利用可能なオプションとその値を閲覧することができます。さらに、`#` でコメント文を加えることができます。
|
||||||
|
|
||||||
設定ファイルの例:
|
設定ファイルの例:
|
||||||
@ -354,10 +500,6 @@ export BAT_CONFIG_PATH="/path/to/bat.conf"
|
|||||||
# Use italic text on the terminal (not supported on all terminals)
|
# Use italic text on the terminal (not supported on all terminals)
|
||||||
--italic-text=always
|
--italic-text=always
|
||||||
|
|
||||||
# Add mouse scrolling support in less (does not work with older
|
|
||||||
# versions of "less")
|
|
||||||
--pager="less -FR"
|
|
||||||
|
|
||||||
# Use C++ syntax (instead of C) for .h header files
|
# Use C++ syntax (instead of C) for .h header files
|
||||||
--map-syntax h:cpp
|
--map-syntax h:cpp
|
||||||
|
|
||||||
@ -371,22 +513,29 @@ Windows 上で `bat` はほとんど動作しますが、いくつかの機能
|
|||||||
|
|
||||||
### ページング
|
### ページング
|
||||||
|
|
||||||
Windowsには、`more`形式の非常に限られたページャーしか含まれていません。[ホームページ](http://www.greenwoodsoftware.com/less/download.html)または[Chocolatey](https://chocolatey.org/packages/Less)からWindows用の`less`バイナリをダウンロードできます。 使用するには、バイナリを`PATH`の通っているディレクトリに配置するか、[環境変数を定義](#異なるページャーの使用)します。
|
Windowsには、`more` 形式の非常に限られたページャーしか含まれていません。
|
||||||
|
`less` 用のWindowsバイナリは、[ホームページ](http://www.greenwoodsoftware.com/less/download.html) または
|
||||||
|
[Chocolatey](https://chocolatey.org/packages/Less) からダウンロードできます。
|
||||||
|
これを使用するには、バイナリを `PATH` のディレクトリに配置するか、環境変数を定義します。[Chocolateyパッケージ](#on-windows) は `less` を自動的にインストールします。
|
||||||
|
|
||||||
### 色
|
### 色
|
||||||
|
|
||||||
Windows 10 は[v1151](https://en.wikipedia.org/wiki/Windows_10_version_history#Version_1511_(November_Update))からbashの新しいバージョンと同様に `conhost.exe`(コマンドプロンプト)と PowerShell の色をネイティブサポートしていません。Windows の新しいバージョンでは、[Cmder](http://cmder.net/)を使うことができます。これは[ConEmu](https://conemu.github.io/)を含んでいます。
|
Windows 10では、`conhost.exe` (コマンドプロンプト)と
|
||||||
|
[v1511](https://en.wikipedia.org/wiki/Windows_10_version_history#Version_1511_(November_Update)) 以降の PowerShell の両方、
|
||||||
|
およびbashの新しいバージョンの色がネイティブにサポートされています。 以前のバージョンのWindowsでは、
|
||||||
|
[ConEmu](https://conemu.github.io/) を含む [Cmder](http://cmder.net/) を使用できます。
|
||||||
|
|
||||||
**注意:** Git と MSYS の `less` はWindows上で色を正しく解釈しません。もし、あなたが他のページャーをインストールしていないのであれば、 `--paging=never` オプションを付け加えるまたは `BAT_PAGER` に空文字を設定することでページングを完全に無効にできます。
|
**注意:** Git と MSYS の `less` はWindows上で色を正しく解釈しません。
|
||||||
|
もし、あなたが他のページャーをインストールしていないのであれば、 `--paging=never` オプションを付け加える
|
||||||
|
または `BAT_PAGER` に空文字を設定することでページングを完全に無効にできます。
|
||||||
|
|
||||||
### Cygwin
|
### Cygwin
|
||||||
|
|
||||||
Windows上の `bat` は Cygwin のunix風のpath(`/cygdrive/*`)をネイティブサポートしていません。
|
Windows上の `bat` は Cygwin のunix風のpath(`/cygdrive/*`)をネイティブサポートしていません。絶対的なcygwinパスを引数として受けたときに、 `bat` は以下のエラーを返すでしょう: `The system cannot find the path specified. (os error 3)`
|
||||||
絶対的なcygwinパスを引数として受けたときに、 `bat` は以下のエラーを返すでしょう: `The system cannot find the path specified. (os error 3)`
|
|
||||||
|
|
||||||
wrapperを作成するまたは以下の関数を `.bash_profile` に追記することでこの問題を解決することができます:
|
wrapperを作成するまたは以下の関数を `.bash_profile` に追記することでこの問題を解決することができます:
|
||||||
```shell
|
|
||||||
|
```bash
|
||||||
bat() {
|
bat() {
|
||||||
local index
|
local index
|
||||||
local args=("$@")
|
local args=("$@")
|
||||||
@ -404,15 +553,32 @@ bat() {
|
|||||||
|
|
||||||
### ターミナルと色
|
### ターミナルと色
|
||||||
|
|
||||||
`bat` はターミナルがトゥルーカラーをサポートしている/していない関係なくサポートします。しかし、シンタックスハイライトのテーマの色が8-bitカラーに最適化されていない場合、24-bitであるトゥルーカラーをサポートしているターミナルを使用することを強く推奨します(`terminator`, `konsole`, `iTerm2`, ...)。
|
`bat` はターミナルがトゥルーカラーをサポートしている/していない関係なくサポートします。
|
||||||
この[記事](https://gist.github.com/XVilka/8346728)には24-bitカラーがサポートされているターミナルの一覧が掲載されています。
|
しかし、シンタックスハイライトのテーマの色が8-bitカラーに最適化されていない場合、
|
||||||
|
24-bitであるトゥルーカラーをサポートしているターミナルを使用することを強く推奨します(`terminator`, `konsole`, `iTerm2`, ...)。
|
||||||
|
この [記事](https://gist.github.com/XVilka/8346728) には
|
||||||
|
24-bitカラーがサポートされているターミナルの一覧が掲載されています。
|
||||||
|
|
||||||
本当の色をターミナルにセットするために、環境変数 `COLORTERM` に `truecolor` か `24bit` のどちらかを代入してください。さもなければ、 `bat` はどの色を使うのか決定することができません。または、24-bit エスケープシーケンスがサポートされません(そして、8-bit colorに戻ります)。
|
本当の色をターミナルにセットするために、環境変数 `COLORTERM` に `truecolor` か
|
||||||
|
`24bit` のどちらかを代入してください。さもなければ、`bat` はどの色を使うのか決定することができません。または、24-bit エスケープシーケンスがサポートされません
|
||||||
|
(そして、8-bit colorに戻ります)。
|
||||||
|
|
||||||
### 行番号とグリッド線がほとんど見えない
|
### 行番号とグリッド線がほとんど見えない
|
||||||
|
|
||||||
異なるテーマを試してみてください(`bat --list-themes` でテーマを閲覧できます)。 `OneHalfDark` と `OneHalfLight` テーマはグリッド線と線の色を明るくします。
|
異なるテーマを試してみてください(`bat --list-themes` でテーマを閲覧できます)。
|
||||||
|
`OneHalfDark` と `OneHalfLight` テーマはグリッド線と線の色を明るくします。
|
||||||
|
|
||||||
|
### ファイルエンコーディング
|
||||||
|
|
||||||
|
`bat` は UTF-16 と同様に UTF-8 をネイティブにサポートします。
|
||||||
|
他のすべてのファイルエンコーディングでは、エンコーディングは通常自動検出できないため、最初に UTF-8 に変換する必要があります。
|
||||||
|
これを行うには `iconv` を使用できます。
|
||||||
|
例: Latin-1(ISO-8859-1)エンコーディングの PHP ファイルがある場合、次のように呼び出すことができます:
|
||||||
|
``` bash
|
||||||
|
iconv -f ISO-8859-1 -t UTF-8 my-file.php | bat
|
||||||
|
```
|
||||||
|
注: `bat` が構文を自動検出できない場合は
|
||||||
|
`-l` / `-language` オプションを使用する必要がある場合があります。
|
||||||
|
|
||||||
## 開発
|
## 開発
|
||||||
|
|
||||||
@ -435,6 +601,11 @@ bash assets/create.sh
|
|||||||
cargo install -f
|
cargo install -f
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Maintainers
|
||||||
|
|
||||||
|
- [sharkdp](https://github.com/sharkdp)
|
||||||
|
- [eth-p](https://github.com/eth-p)
|
||||||
|
|
||||||
## プロジェクトの目標と既存の類似したOSS
|
## プロジェクトの目標と既存の類似したOSS
|
||||||
|
|
||||||
`bat` は以下の目標を達成しようと試みています:
|
`bat` は以下の目標を達成しようと試みています:
|
||||||
@ -444,8 +615,8 @@ cargo install -f
|
|||||||
- (POSIX) `cat` との完全互換
|
- (POSIX) `cat` との完全互換
|
||||||
- ユーザーフレンドリーがコマンドラインインターフェースの提供
|
- ユーザーフレンドリーがコマンドラインインターフェースの提供
|
||||||
|
|
||||||
既存の類似したOSSはたくさんあります。
|
あなたが同様のプログラムを探しているなら、多くの選択肢があります。
|
||||||
`bat` とこれらを比較した表が[こちら](alternatives.md)にあります。
|
比較については [このドキュメント](alternatives.md) を参照してください。
|
||||||
|
|
||||||
## ライセンス
|
## ライセンス
|
||||||
Copyright (c) 2018-2020 [bat-developers](https://github.com/sharkdp/bat).
|
Copyright (c) 2018-2020 [bat-developers](https://github.com/sharkdp/bat).
|
||||||
|
Loading…
Reference in New Issue
Block a user