mirror of
https://github.com/sharkdp/bat.git
synced 2025-03-14 06:38:24 +00:00
Small improvement to the syntax mapping section
This commit is contained in:
parent
a838ff47b5
commit
0a28da0cd0
29
README.md
29
README.md
@ -490,27 +490,32 @@ and the `GitHub` theme when in the _light mode_.
|
|||||||
alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
|
alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Syntax of a file
|
### Adapting file type associations
|
||||||
|
|
||||||
You can change the default syntax association of the file using the `--map-syntax` option.
|
You can add new (or change existing) file name patterns using the
|
||||||
It supports glob pattern matching and is matched on full path and filename.
|
`--map-syntax` option. The option takes an argument of the form `pattern:syntax`.
|
||||||
|
`pattern` is a glob pattern that is matched against the file name and
|
||||||
|
the absolute file path. `syntax` is the *name* of a supported language
|
||||||
|
(use `bat --list-languages` for an overview).
|
||||||
|
|
||||||
You can use it like this:
|
This option is most useful in combination with the `bat` configuration file (see below).
|
||||||
|
|
||||||
|
Example: To use "INI" syntax highlighting for all files with a `.conf` file extension, use
|
||||||
```bash
|
```bash
|
||||||
bat --map-syntax='PATTERN:SYNTAX' file-name
|
--map-syntax='*.conf:INI'
|
||||||
```
|
```
|
||||||
|
|
||||||
For example:
|
Example: To open all files called `.ignore` (exact match) with the "Git Ignore" syntax, use:
|
||||||
```bash
|
```bash
|
||||||
# Using `INI` file syntax highlighting when opening a file with extension `.conf`.
|
--map-syntax='.ignore:Git Ignore'
|
||||||
bat --map-syntax='*.conf:INI' file.conf
|
```
|
||||||
|
|
||||||
# Using `Git Ignore` file syntax highlighting for ".ignore" files
|
Example: To open all `.conf` files in subfolders of `/etc/apache2` with the "Apache Conf"
|
||||||
bat --map-syntax='.ignore:Git Ignore' .ignore
|
syntax, use (this mapping is already built in):
|
||||||
|
```bash
|
||||||
|
-map-syntax='/etc/apache2/**/*.conf:Apache Conf'
|
||||||
```
|
```
|
||||||
|
|
||||||
You can use `bat --list-languages` to see all the file syntax types available.
|
|
||||||
|
|
||||||
## Configuration file
|
## Configuration file
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user