utilities/bat
utilities/bat
1
0
Fork 0
mirror of https://github.com/sharkdp/bat synced 2024-07-22 02:44:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

customization is translated

Browse source
This commit is contained in:
Sergey Duck 2020-06-03 19:42:14 +03:00 committed by David Peter
parent 0d2ef02c9e
commit 4ea70f8409
1 changed files with 46 additions and 65 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

111
doc/README-ru.md
View file

@ -13,7 +13,7 @@
<a href="#installation">Установка</a> • <a href="#installation">Установка</a> •
<a href="#customization">Кастомизация</a> • <a href="#customization">Кастомизация</a> •
<a href="#project-goals-and-alternatives">Цели проекта и его альтернативы </a> • <a href="#project-goals-and-alternatives">Цели проекта и его альтернативы </a> •
Translation [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>][<a href="doc/README-ja.md">日本語</a>][<a href="doc/README-ko.md">한국어</a>][<a href="doc/README-ru.md">日本語</a>][<a href="doc/README-ko.md">Русский</a>] Translation [<a href="https://github.com/chinanf-boy/bat-zh">中文</a>][<a href="doc/README-ja.md">日本語</a>][<a href="doc/README-ko.md">한국어</a>][<a href="doc/README-ru.md">Русский</a>]
</p> </p>
### Выделение синтаксиса ### Выделение синтаксиса
@ -271,7 +271,7 @@ brew install bat
port install bat port install bat
``` ```
### On Windows ### Windows
Есть несколько способов установить `bat`. Как только вы установили его, посмотрите на секцию ["Using `bat` on Windows"](#using-bat-on-windows). Есть несколько способов установить `bat`. Как только вы установили его, посмотрите на секцию ["Using `bat` on Windows"](#using-bat-on-windows).
@ -282,7 +282,7 @@ port install bat
choco install bat choco install bat
``` ```
#### With Scoop #### С помощью Scoop
Вы можете установить `bat` с помощью [scoop](https://scoop.sh/): Вы можете установить `bat` с помощью [scoop](https://scoop.sh/):
```bash ```bash
@ -346,122 +346,103 @@ ansible-galaxy install aeimer.install_bat
cargo install --locked bat cargo install --locked bat
``` ```
## Customization ## Кастомизация
### Highlighting theme ### Темы для выделения текста
Use `bat --list-themes` to get a list of all available themes for syntax Используйте `bat --list-themes` чтобы вывести список всех доступных тем. Для выбора темы `TwoDark`, используйте `bat` с флагом
highlighting. To select the `TwoDark` theme, call `bat` with the `--theme=TwoDark` или поставьте переменную окружения `BAT_THEME` равной `TwoDark`. Используйте `export BAT_THEME="TwoDark"` в стартап файле вашей оболочки, чтобы изменить ее навсегда. Или же, используйте [конфиг файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
`--theme=TwoDark` option or set the `BAT_THEME` environment variable to
`TwoDark`. Use `export BAT_THEME="TwoDark"` in your shell's startup file to
make the change permanent. Alternatively, use `bat`s
[configuration file](https://github.com/sharkdp/bat#configuration-file).
If you want to preview the different themes on a custom file, you can use Если вы хотите просто просмотреть темы, используйте следующую команду (вам понадобится [`fzf`](https://github.com/junegunn/fzf) для этого):
the following command (you need [`fzf`](https://github.com/junegunn/fzf) for this):
```bash ```bash
bat --list-themes | fzf --preview="bat --theme={} --color=always /path/to/file" bat --list-themes | fzf --preview="bat --theme={} --color=always /путь/к/файлу"
``` ```
`bat` looks good on a dark background by default. However, if your terminal uses a `bat` отлично смотрится на темном фоне. Однако, если ваш терминал использует светлую тему, такие темы как `GitHub` или `OneHalfLight` будут смотрется куда лучше!
light background, some themes like `GitHub` or `OneHalfLight` will work better for you. Вы так-же можете использовать новую тему, для этого перейдите [в раздел добавления тем](https://github.com/sharkdp/bat#adding-new-themes).
You can also use a custom theme by following the
['Adding new themes' section below](https://github.com/sharkdp/bat#adding-new-themes).
### Output style ### Изменение внешнего вывода
You can use the `--style` option to control the appearance of `bat`s output. Вы можете использовать флаг `--style` чтобы изменять внешний вид вывода в `bat`.
You can use `--style=numbers,changes`, for example, to show only Git changes Например, вы можете использовать `--style=numbers,changes`, чтобы показать только количество строк и изменений в Git. Установите переменную окружения `BAT_STYLE` чтобы изменить это навсегда, или используйте [конфиг файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
and line numbers but no grid and no file header. Set the `BAT_STYLE` environment
variable to make these changes permanent or use `bat`s
[configuration file](https://github.com/sharkdp/bat#configuration-file).
### Adding new syntaxes / language definitions ### Добавление новых синтаксисов
`bat` uses the excellent [`syntect`](https://github.com/trishume/syntect/) `bat` использует [`syntect`](https://github.com/trishume/syntect/) для выделения синтаксиса. `syntect` может читать
library for syntax highlighting. `syntect` can read any [файл `.sublime-syntax`](https://www.sublimetext.com/docs/3/syntax.html)
[Sublime Text `.sublime-syntax` file](https://www.sublimetext.com/docs/3/syntax.html) и темы. Чтобы добавить новый синтаксис, сделайте следующее:
and theme. To add new syntax definitions, do the following.
Create a folder with syntax definition files: Создайте каталог с синтаксисом:
```bash ```bash
mkdir -p "$(bat --config-dir)/syntaxes" mkdir -p "$(bat --config-dir)/syntaxes"
cd "$(bat --config-dir)/syntaxes" cd "$(bat --config-dir)/syntaxes"
# Put new '.sublime-syntax' language definition files # Разместите файлы '.sublime-syntax'
# in this folder (or its subdirectories), for example: # в каталоге (или субкаталогах), например:
git clone https://github.com/tellnobody1/sublime-purescript-syntax git clone https://github.com/tellnobody1/sublime-purescript-syntax
``` ```
Now use the following command to parse these files into a binary cache: Теперь, используйте следующую команду, чтобы превратить эти файлы в бинарный кеш:
```bash ```bash
bat cache --build bat cache --build
``` ```
Finally, use `bat --list-languages` to check if the new languages are available. Наконец, используйте `bat --list-languages` чтобы проверить, доступны ли новые языки.
If you ever want to go back to the default settings, call: Если когда-нибудь вы заходите вернутся к настройкам по умолчанию, введите
```bash ```bash
bat cache --clear bat cache --clear
``` ```
### Adding new themes ### Добавление новых тем
This works very similar to how we add new syntax definitions. Это работает похожим образом, так-же как и добавление новых тем выделения синтаксиса
First, create a folder with the new syntax highlighting themes: Во-первых, создайте каталог с новыми темами для синтаксиса:
```bash ```bash
mkdir -p "$(bat --config-dir)/themes" mkdir -p "$(bat --config-dir)/themes"
cd "$(bat --config-dir)/themes" cd "$(bat --config-dir)/themes"
# Download a theme in '.tmTheme' format, for example: # Загрузите тему в формате '.tmTheme':
git clone https://github.com/greggb/sublime-snazzy git clone https://github.com/greggb/sublime-snazzy
# Update the binary cache # Обновите кеш
bat cache --build bat cache --build
``` ```
Finally, use `bat --list-themes` to check if the new themes are available. Теперь, используйте `bat --list-themes` чтобы проверить доступность новых тем.
### Using a different pager ### Использование другого пейджера.
`bat` uses the pager that is specified in the `PAGER` environment variable. If this variable is not `bat` использует пейджер, указанный в переменной окружения `PAGER`. Если она не задана, то используется `less`.
set, `less` is used by default. If you want to use a different pager, you can either modify the Если вы желаете использовать другой пейджер, вы можете либо изменить переменную `PAGER`, либо `BAT_PAGER` чтобы перезаписать то, что указано в `PAGER`.
`PAGER` variable or set the `BAT_PAGER` environment variable to override what is specified in
`PAGER`.
If you want to pass command-line arguments to the pager, you can also set them via the Чтобы передать какие-то аргументы в ваш пейджер, вы так-же можете их поставить в этих переменных:
`PAGER`/`BAT_PAGER` variables:
```bash ```bash
export BAT_PAGER="less -RF" export BAT_PAGER="less -RF"
``` ```
Instead of using environment variables, you can also use `bat`s [configuration file](https://github.com/sharkdp/bat#configuration-file) to configure the pager (`--pager` option). Так-же вы можете использовать [файл конфигурации](https://github.com/sharkdp/bat#configuration-file) `bat` для изменения. (флаг `--pager`).
**Note**: By default, if the pager is set to `less` (and no command-line options are specified), **Внимание**: По умолчанию, `less` является пейджером (без каких либо аргументов),
`bat` will pass the following command line options to the pager: `-R`/`--RAW-CONTROL-CHARS`, `bat` задаст следующие флаги для пейджера:
`-F`/`--quit-if-one-screen` and `-X`/`--no-init`. The last option (`-X`) is only used for `less` `-R`/`--RAW-CONTROL-CHARS`,
versions older than 530. `-F`/`--quit-if-one-screen` и `-X`/`--no-init`. Последний флаг(`-X`) используется только для `less`, чья версия раньше 530.
The `-R` option is needed to interpret ANSI colors correctly. The second option (`-F`) instructs Флаг `-R` нужен чтобы корректно воспроизвести ANSI цвета. Второй флаг (`-F`) говорит
less to exit immediately if the output size is smaller than the vertical size of the terminal. `less` чтобы тот сразу-же завершился, если размер вывода меньше чем вертикальный размер терминала.
This is convenient for small files because you do not have to press `q` to quit the pager. The Это удобно для небольших файлов, т.к вам не надо каждый раз нажимать `q` чтобы выйти из пейджера. Третий флаг (`-X`) нужен чтобы исправить баг с `--quit-if-one-screen` в старых версиях `less`. К сожалению, это так-же блокирует возможность использования там колеса мышки.
third option (`-X`) is needed to fix a bug with the `--quit-if-one-screen` feature in old versions
of `less`. Unfortunately, it also breaks mouse-wheel support in `less`.
If you want to enable mouse-wheel scrolling on older versions of `less`, you can pass just `-R` (as Если вы хотите все же его включить, вы можете добавить флаг `-R`.
in the example above, this will disable the quit-if-one-screen feature). For less 530 or newer, Для `less` новее чем 530, оно должно работать из коробки.
it should work out of the box.
### Dark mode ### Темная тема
If you make use of the dark mode feature in macOS, you might want to configure `bat` to use a different Если вы используете темный режим в macOS, возможно вы захотите чтобы `bat` использовал другую тему, основанную на теме вашей ОС. Следующий сниппет использует тему `default`, когда у вас включен темный режим, и тему `GitHub`, когда включен светлый.
theme based on the OS theme. The following snippet uses the `default` theme when in the _dark mode_
and the `GitHub` theme when in the _light mode_.
```bash ```bash
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)"