refactor: finish moving ssh-* scripts to own installers
[webi-installers/.git] / bat / README.md
1 ---
2 title: bat
3 homepage: https://github.com/sharkdp/bat
4 tagline: |
5   bat: A cat(1) clone with syntax highlighting and Git integration.
6 ---
7
8 To update or switch versions, run `webi bat@stable` (or `@v0.18`, `@beta`, etc).
9
10 ## Cheat Sheet
11
12 > `bat` is pretty much what `cat` would be if it were developed today's in the
13 > world of Markdown, git, etc.
14
15 ### How to run on Windows 10
16
17 On Windows 10 you'll get an error like this:
18
19 > execution cannot proceed run because vcruntime140.dll was not found
20
21 You need to download and install the
22 [Microsoft Visual C++ Redistributable](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)
23
24 ### How to alias as `cat`
25
26 Update your `.bashrc`, `.zshrc`, or `.profile`
27
28 ```bash
29 alias cat="bat --style=plain"
30 ```
31
32 For situations in which you must use `cat` exactly, remember that you can escape
33 the alias:
34
35 ```bash
36 \cat foo
37 ```
38
39 ### How to change the default behavior
40
41 Take a look at the config options:
42
43 ```bash
44 bat --help
45 ```
46
47 Check to see where your config file is:
48
49 ```bash
50 echo 'N' | bat --generate-config-file
51 ```
52
53 Edit the config file:
54
55 `~/.config/bat/config`:
56
57 ```txt
58 # no numbers or headers, just highlighting and such
59 --style="plain"
60 ```