mirror of
https://github.com/sharkdp/bat
synced 2026-06-09 10:03:18 +00:00
Rizky Mirzaviandy Priambodo
844bfded50
* feat(cli): add fallback syntax option Expose a new fallback syntax CLI option so users can opt into syntax highlighting only when auto-detection fails. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> * feat(syntax): apply fallback only after detection fails Use the fallback syntax only when path and first-line detection fail, preserving existing behavior for detected files and explicit language selection. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> * test(cli): cover fallback syntax behavior Add integration coverage for fallback syntax usage, precedence with --language, and no-op behavior when syntax is already detected; update help snapshots for the new option. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> * docs(changelog): document fallback syntax option Record the new fallback syntax feature in the unreleased changelog section. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> --------- Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
73 lines
2.8 KiB
Plaintext
73 lines
2.8 KiB
Plaintext
A cat(1) clone with wings.
|
|
|
|
Usage: bat [OPTIONS] [FILE]...
|
|
bat <COMMAND>
|
|
|
|
Arguments:
|
|
[FILE]... File(s) to print / concatenate. Use '-' for standard input.
|
|
|
|
Options:
|
|
-A, --show-all
|
|
Show non-printable characters (space, tab, newline, ..).
|
|
--nonprintable-notation <notation>
|
|
Set notation for non-printable characters.
|
|
--binary <behavior>
|
|
How to treat binary content. (default: no-printing)
|
|
-p, --plain...
|
|
Show plain style (alias for '--style=plain').
|
|
-l, --language <language>
|
|
Set the language for syntax highlighting.
|
|
--fallback-syntax <fallback-syntax>
|
|
Set a fallback language for undetected syntaxes. [aliases: --fallback-language]
|
|
-H, --highlight-line <N:M>
|
|
Highlight lines N through M.
|
|
--file-name <name>
|
|
Specify the name to display for a file.
|
|
-d, --diff
|
|
Only show lines that have been added/removed/modified.
|
|
--tabs <T>
|
|
Set the tab width to T spaces.
|
|
--wrap <mode>
|
|
Specify the text-wrapping mode (*auto*, never, character, word).
|
|
-S, --chop-long-lines
|
|
Truncate all lines longer than screen width. Alias for '--wrap=never'.
|
|
-n, --number
|
|
Show line numbers (alias for '--style=numbers').
|
|
--color <when>
|
|
When to use colors (*auto*, never, always).
|
|
--italic-text <when>
|
|
Use italics in output (always, *never*)
|
|
--decorations <when>
|
|
When to show the decorations (*auto*, never, always).
|
|
--paging <when>
|
|
Specify when to use the pager, or use `-P` to disable (*auto*, never, always).
|
|
-m, --map-syntax <glob:syntax>
|
|
Use the specified syntax for files matching the glob pattern ('*.cpp:C++').
|
|
--theme <theme>
|
|
Set the color theme for syntax highlighting.
|
|
--theme-light <theme>
|
|
Sets the color theme for syntax highlighting used for light backgrounds.
|
|
--theme-dark <theme>
|
|
Sets the color theme for syntax highlighting used for dark backgrounds.
|
|
--list-themes
|
|
Display all supported highlighting themes.
|
|
-s, --squeeze-blank
|
|
Squeeze consecutive empty lines.
|
|
--style <components>
|
|
Comma-separated list of style elements to display (*default*, auto, full, plain, changes,
|
|
header, header-filename, header-filesize, grid, rule, numbers, snip).
|
|
-r, --line-range <N:M>
|
|
Only print the lines from N to M.
|
|
-L, --list-languages
|
|
Display all supported languages.
|
|
-u, --unbuffered
|
|
Enable unbuffered input reading for streaming use cases.
|
|
--completion <SHELL>
|
|
Show shell completion for a certain shell. [possible values: bash, fish, zsh, ps1]
|
|
-E, --quiet-empty
|
|
Produce no output when the input is empty.
|
|
-h, --help
|
|
Print help (see more with '--help')
|
|
-V, --version
|
|
Print version
|