mirror of
https://github.com/sharkdp/bat.git
synced 2025-03-15 07:08:36 +00:00
Bump the required Rust version. Because of some transitive dependencies needing `std::sync::atomic::spin_loop_hint`, this won't compile without [1.24](https://blog.rust-lang.org/2018/02/15/Rust-1.24.html): ``` Compiling parking_lot_core v0.2.14 error[E0432]: unresolved import `std::sync::atomic::spin_loop_hint` --> .cargo/registry/src/github.com-1ecc6299db9ec823/parking_lot_core-0.2.14/src/spinwait.rs:14:5 | 14 | use std::sync::atomic::spin_loop_hint; | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ no `spin_loop_hint` in `sync::atomic` error: aborting due to previous error error: Could not compile `parking_lot_core`. warning: build failed, waiting for other jobs to finish... error: failed to compile `bat v0.2.0`, intermediate artifacts can be found at `/var/folders/z6/9wkk458s4y1g3_82242l_wv5ws7k_8/T/cargo-install.Nyyc2EJDojxa` ```
80 lines
2.3 KiB
Markdown
80 lines
2.3 KiB
Markdown
# bat
|
|
|
|
[](https://travis-ci.org/sharkdp/bat)
|
|
[](https://crates.io/crates/bat)
|
|
|
|
A *cat(1)* clone with syntax highlighting and Git integration.
|
|
|
|
## Features
|
|
|
|
### Syntax highlighting
|
|
|
|
`bat` supports syntax highlighting for a large number of programming and markup languages:
|
|
|
|

|
|
|
|
### Git integration
|
|
|
|
`bat` communicates with `git` to show modifications with respect to the index (see left side bar):
|
|
|
|

|
|
|
|
## Installation
|
|
|
|
Check out the [Release page](https://github.com/sharkdp/bat/releases) for binary builds and Debian packages.
|
|
|
|
### Arch Linux
|
|
|
|
On Arch Linux, you can install [the AUR package](https://aur.archlinux.org/packages/bat/) via yaourt, or manually:
|
|
|
|
```bash
|
|
git clone https://aur.archlinux.org/bat.git
|
|
cd bat
|
|
makepkg -si
|
|
```
|
|
|
|
### From source
|
|
|
|
If you want to build to compile `bat` from source, you need Rust 1.24 or higher.
|
|
Make sure that you have the devel-version of libopenssl installed (see instructions
|
|
[here](https://github.com/sfackler/rust-openssl)). You can then use `cargo` to build everything:
|
|
|
|
``` bash
|
|
cargo install bat
|
|
```
|
|
|
|
## Customization
|
|
|
|
`bat` uses the excellent [`syntect`](https://github.com/trishume/syntect/) library for syntax highlighting. `syntect` can read any [Sublime Text `.sublime-syntax` files](https://www.sublimetext.com/docs/3/syntax.html) and themes.
|
|
|
|
To build your own language-set and theme, follow these steps:
|
|
|
|
Create a folder with a syntax highlighting theme:
|
|
``` bash
|
|
mkdir -p ~/.config/bat/themes
|
|
cd ~/.config/bat/themes
|
|
|
|
# Download a theme, for example:
|
|
git clone https://github.com/jonschlinkert/sublime-monokai-extended
|
|
|
|
# Create a 'Default.tmTheme' link
|
|
ln -s "sublime-monokai-extended/Monokai Extended.tmTheme" Default.tmTheme
|
|
```
|
|
|
|
Create a folder with language definition files:
|
|
``` bash
|
|
mkdir -p ~/.config/bat/syntax
|
|
cd ~/.config/bat/syntax
|
|
|
|
# Download some language definition files, for example:
|
|
git clone https://github.com/sublimehq/Packages/
|
|
rm -rf Packages/Markdown
|
|
git clone https://github.com/jonschlinkert/sublime-markdown-extended
|
|
```
|
|
|
|
Finally, use the following command to parse all these files into a binary
|
|
cache:
|
|
``` bash
|
|
bat init-cache
|
|
```
|