MirroredRepos/bat
1
0
Fork 0
mirror of https://github.com/sharkdp/bat.git synced 2025-10-31 07:04:04 +00:00
Code Issues Releases Wiki Activity

docs: added minor theming documentation notes

Browse Source 
.
This commit is contained in:
Caleb Larsen
2025-08-19 15:41:52 -05:00
committed by Martin Nordholts
parent 6a74283289
commit 45efc4117e
1 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
README.md
View File

@@ -503,8 +503,9 @@ bat --completion <shell>
### Highlighting theme ### Highlighting theme
Use `bat --list-themes` to get a list of all available themes for syntax Use `bat --list-themes` to get a list of all available themes for syntax
highlighting. To select the `TwoDark` theme, call `bat` with the highlighting. By default, `bat` uses `Monokai Extended` or `Monokai Extended Light`
`--theme=TwoDark` option or set the `BAT_THEME` environment variable to for dark and light themes respectively. To select the `TwoDark` theme, call `bat`
with the `--theme=TwoDark` option or set the `BAT_THEME` environment variable to
`TwoDark`. Use `export BAT_THEME="TwoDark"` in your shell's startup file to `TwoDark`. Use `export BAT_THEME="TwoDark"` in your shell's startup file to
make the change permanent. Alternatively, use `bat`'s make the change permanent. Alternatively, use `bat`'s
[configuration file](#configuration-file). [configuration file](#configuration-file).
@@ -605,6 +606,8 @@ syntax:
### Adding new themes ### Adding new themes
This works very similar to how we add new syntax definitions. This works very similar to how we add new syntax definitions.
> [!NOTE]
> Themes are stored in [`.tmTheme` files](https://www.sublimetext.com/docs/color_schemes_tmtheme.html).
First, create a folder with the new syntax highlighting themes: First, create a folder with the new syntax highlighting themes:
```bash ```bash
@@ -619,6 +622,8 @@ bat cache --build
``` ```
Finally, use `bat --list-themes` to check if the new themes are available. Finally, use `bat --list-themes` to check if the new themes are available.
> [!NOTE]
> `bat` uses the name of the `.tmTheme` file for the theme's name.
### Adding or changing file type associations ### Adding or changing file type associations