mirror of
https://github.com/sharkdp/bat.git
synced 2024-11-28 10:43:38 +01:00
Stylistic, spelling and punctuation fixes in README-ru
This commit is contained in:
parent
99c04a8740
commit
803447e2a1
133
doc/README-ru.md
133
doc/README-ru.md
@ -23,14 +23,14 @@
|
|||||||
![Пример выделения синтаксиса](https://i.imgur.com/3FGy5tW.png)
|
![Пример выделения синтаксиса](https://i.imgur.com/3FGy5tW.png)
|
||||||
|
|
||||||
### Интеграция с Git
|
### Интеграция с Git
|
||||||
`bat` использует `git` чтобы показать изменения в коде
|
`bat` использует `git`, чтобы показать изменения в коде
|
||||||
(смотрите на левый сайдбар):
|
(смотрите на левый сайдбар):
|
||||||
|
|
||||||
![Пример интеграции с Git](https://i.imgur.com/azUAzdx.png)
|
![Пример интеграции с Git](https://i.imgur.com/azUAzdx.png)
|
||||||
|
|
||||||
### Показать непечатаемые символы
|
### Показать непечатаемые символы
|
||||||
|
|
||||||
Вы можете использовать `-A` / `--show-all` флаг чтобы показать символы, которые невозможно напечатать:
|
Вы можете использовать `-A` / `--show-all` флаг, чтобы показать символы, которые невозможно напечатать:
|
||||||
|
|
||||||
![Строка с неотображемыми символами](https://i.imgur.com/X0orYY9.png)
|
![Строка с неотображемыми символами](https://i.imgur.com/X0orYY9.png)
|
||||||
|
|
||||||
@ -57,7 +57,7 @@
|
|||||||
> bat src/*.rs
|
> bat src/*.rs
|
||||||
```
|
```
|
||||||
|
|
||||||
Читаем из stdin и определяем синтаксис автоматически (внимание, это работает, читая заглавную строку файла, например `#!/bin/sh` )
|
Читаем из stdin и определяем синтаксис автоматически (внимание: это делается по заглавной строке файла, например, `#!/bin/sh`)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
> curl -s https://sh.rustup.rs | bat
|
> curl -s https://sh.rustup.rs | bat
|
||||||
@ -74,7 +74,7 @@
|
|||||||
> bat -A /etc/hosts
|
> bat -A /etc/hosts
|
||||||
```
|
```
|
||||||
|
|
||||||
Использование как замена `cat`
|
Использование в качестве замены `cat`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bat > note.md # мгновенно создаем новый файл
|
bat > note.md # мгновенно создаем новый файл
|
||||||
@ -90,12 +90,12 @@ bat f - g # выводит 'f' в stdin, а потом 'g'.
|
|||||||
|
|
||||||
#### `find` или `fd`
|
#### `find` или `fd`
|
||||||
|
|
||||||
Вы можете использовать флаг `-exec` в `find` чтобы посмотреть превью всех файлов в `bat`
|
Вы можете использовать флаг `-exec` в `find`, чтобы посмотреть превью всех файлов в `bat`
|
||||||
```bash
|
```bash
|
||||||
find … -exec bat {} +
|
find … -exec bat {} +
|
||||||
```
|
```
|
||||||
|
|
||||||
Если вы используете [`fd`](https://github.com/sharkdp/fd), вы вполне можете использоваль флаг `-X`/`--exec-batch` чтобы сделать тоже самое:
|
Если вы используете [`fd`](https://github.com/sharkdp/fd), применяйте для этого флаг `-X`/`--exec-batch`:
|
||||||
```bash
|
```bash
|
||||||
fd … -X bat
|
fd … -X bat
|
||||||
```
|
```
|
||||||
@ -118,7 +118,7 @@ tail -f /var/log/pacman.log | bat --paging=never -l log
|
|||||||
|
|
||||||
#### `git`
|
#### `git`
|
||||||
|
|
||||||
Вы можете использовать `bat` с `git show` чтобы просмотреть старую версию файла с выделением синтаксиса:
|
Вы можете использовать `bat` с `git show`, чтобы просмотреть старую версию файла с выделением синтаксиса:
|
||||||
```bash
|
```bash
|
||||||
git show v0.6.0:src/main.rs | bat -l rs
|
git show v0.6.0:src/main.rs | bat -l rs
|
||||||
```
|
```
|
||||||
@ -127,11 +127,12 @@ git show v0.6.0:src/main.rs | bat -l rs
|
|||||||
|
|
||||||
#### `xclip`
|
#### `xclip`
|
||||||
|
|
||||||
Количество строк и просмотр изменений в `bat` может сделать копирование содержания файла немного сложной. Чтобы предотвратить это, используйте флаг `-p`/`--plain` или просто перевести вывод в `xclip`:
|
Нумерация стро и отображение изменений затрудняет копирование содержимого файлов в буфер обмена.
|
||||||
|
Чтобы спроваиться с этим, используйте флаг `-p`/`--plain` или просто перенаправьте стандартный вывод в `xclip`:
|
||||||
```bash
|
```bash
|
||||||
bat main.cpp | xclip
|
bat main.cpp | xclip
|
||||||
```
|
```
|
||||||
`bat` обнаружит, что вывод будет переведен, и выведет обычный текст без выделения синтаксиса.
|
`bat` обнаружит перенаправление вывода и выведет обычный текст без выделения синтаксиса.
|
||||||
|
|
||||||
#### `man`
|
#### `man`
|
||||||
|
|
||||||
@ -143,15 +144,15 @@ export MANPAGER="sh -c 'col -bx | bat -l man -p'"
|
|||||||
man 2 select
|
man 2 select
|
||||||
```
|
```
|
||||||
|
|
||||||
Возможно вам понадобится также установить `MANROFFOPT="-c"` если у вас есть проблемы с форматированием.
|
Возможно вам понадобится также установить `MANROFFOPT="-c"`, если у вас есть проблемы с форматированием.
|
||||||
|
|
||||||
Если вы хотите сделать этой одной командой, вы можете использовать [`batman`](https://github.com/eth-p/bat-extras/blob/master/doc/batman.md).
|
Если вы хотите сделать этой одной командой, вы можете использовать [`batman`](https://github.com/eth-p/bat-extras/blob/master/doc/batman.md).
|
||||||
|
|
||||||
Обратите внимание, что [синтаксис manpage](assets/syntaxes/02_Extra/Manpage.sublime-syntax) разрабатывается в этом репозитории, и все еще находится в разработке.
|
Обратите внимание, что [синтаксис manpage](assets/syntaxes/02_Extra/Manpage.sublime-syntax) разрабатывается в этом репозитории и все еще находится в разработке.
|
||||||
|
|
||||||
#### `prettier` / `shfmt` / `rustfmt`
|
#### `prettier` / `shfmt` / `rustfmt`
|
||||||
|
|
||||||
[`Prettybat`](https://github.com/eth-p/bat-extras/blob/master/doc/prettybat.md) это скрипт, который форматирует код и выводит его с помощью `bat`.
|
[`Prettybat`](https://github.com/eth-p/bat-extras/blob/master/doc/prettybat.md) — скрипт, который форматирует код и выводит его с помощью `bat`.
|
||||||
|
|
||||||
|
|
||||||
## Установка
|
## Установка
|
||||||
@ -162,7 +163,7 @@ man 2 select
|
|||||||
*... и другие дистрибутивы основанные на Debian.*
|
*... и другие дистрибутивы основанные на Debian.*
|
||||||
|
|
||||||
`bat` есть в репозиториях [Ubuntu](https://packages.ubuntu.com/eoan/bat) и
|
`bat` есть в репозиториях [Ubuntu](https://packages.ubuntu.com/eoan/bat) и
|
||||||
[Debian](https://packages.debian.org/sid/bat), и доступен начиная с Ubuntu Eoan 19.10. На Debian `bat` пока-что доступен только с нестабильной веткой "Sid"
|
[Debian](https://packages.debian.org/sid/bat) и доступен начиная с Ubuntu Eoan 19.10. На Debian `bat` пока что доступен только с нестабильной веткой "Sid".
|
||||||
|
|
||||||
Если ваша версия Ubuntu/Debian достаточно новая, вы можете установить `bat` так:
|
Если ваша версия Ubuntu/Debian достаточно новая, вы можете установить `bat` так:
|
||||||
|
|
||||||
@ -170,7 +171,7 @@ man 2 select
|
|||||||
apt install bat
|
apt install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
Если вы установили `bat` таким образом, то бинарный файл может быть установлен как `batcat` заместо `bat` (из-за [конфликта имени с другим пакетом](https://github.com/sharkdp/bat/issues/982)). Вы можете сделать симлинк или алиас `bat -> batcat`, чтобы предотвратить проблемы, которые могут произойти с другими дистрибутивами.
|
Если вы установили `bat` таким образом, то бинарный файл может быть установлен как `batcat` вместо `bat` (из-за [конфликта имени с другим пакетом](https://github.com/sharkdp/bat/issues/982)). Вы можете сделать симлинк или алиас `bat -> batcat`, чтобы предотвратить подобные проблемы и в других дистрибутивах.
|
||||||
|
|
||||||
``` bash
|
``` bash
|
||||||
mkdir -p ~/.local/bin
|
mkdir -p ~/.local/bin
|
||||||
@ -180,7 +181,7 @@ ln -s /usr/bin/batcat ~/.local/bin/bat
|
|||||||
### Ubuntu (С помощью самого нового `.deb` пакета)
|
### Ubuntu (С помощью самого нового `.deb` пакета)
|
||||||
*... и другие дистрибутивы Linux основанные на Debian*
|
*... и другие дистрибутивы Linux основанные на Debian*
|
||||||
|
|
||||||
Если пакет еще недоступен в вашем Ubuntu/Debian дистрибутиве, или вы хотите установить самую последнюю версию `bat`, то вы можете скачать самый последний `deb`-пакет отсюда:
|
Если пакет еще недоступен в вашем Ubuntu/Debian дистрибутиве или вы хотите установить самую последнюю версию `bat`, то вы можете скачать самый последний `deb`-пакет отсюда:
|
||||||
[release page](https://github.com/sharkdp/bat/releases) и установить так:
|
[release page](https://github.com/sharkdp/bat/releases) и установить так:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -189,7 +190,7 @@ sudo dpkg -i bat_0.15.4_amd64.deb # измените архитектуру и
|
|||||||
|
|
||||||
### Alpine Linux
|
### Alpine Linux
|
||||||
|
|
||||||
Вы можете установить [`bat`](https://pkgs.alpinelinux.org/packages?name=bat) из оффициальных источников:
|
Вы можете установить [`bat`](https://pkgs.alpinelinux.org/packages?name=bat) из официальных источников:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
apk add bat
|
apk add bat
|
||||||
@ -197,7 +198,7 @@ apk add bat
|
|||||||
|
|
||||||
### Arch Linux
|
### Arch Linux
|
||||||
|
|
||||||
Вы можете установить [`bat`](https://www.archlinux.org/packages/community/x86_64/bat/) из оффициального источника:
|
Вы можете установить [`bat`](https://www.archlinux.org/packages/community/x86_64/bat/) из официального источника:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pacman -S bat
|
pacman -S bat
|
||||||
@ -205,7 +206,7 @@ pacman -S bat
|
|||||||
|
|
||||||
### Fedora
|
### Fedora
|
||||||
|
|
||||||
Вы можете установить [`bat`](https://koji.fedoraproject.org/koji/packageinfo?packageID=27506) из оффициального репозитория [Fedora Modular](https://docs.fedoraproject.org/en-US/modularity/using-modules/).
|
Вы можете установить [`bat`](https://koji.fedoraproject.org/koji/packageinfo?packageID=27506) из официального репозитория [Fedora Modular](https://docs.fedoraproject.org/en-US/modularity/using-modules/).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
dnf install bat
|
dnf install bat
|
||||||
@ -213,7 +214,7 @@ dnf install bat
|
|||||||
|
|
||||||
### Gentoo Linux
|
### Gentoo Linux
|
||||||
|
|
||||||
Вы можете установить [`bat`](https://packages.gentoo.org/packages/sys-apps/bat) из оффициальных источников:
|
Вы можете установить [`bat`](https://packages.gentoo.org/packages/sys-apps/bat) из официальных источников:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
emerge sys-apps/bat
|
emerge sys-apps/bat
|
||||||
@ -221,14 +222,14 @@ emerge sys-apps/bat
|
|||||||
|
|
||||||
### Void Linux
|
### Void Linux
|
||||||
|
|
||||||
Вы можете установить `bat` с помощью xbps-install:
|
Вы можете установить `bat` с помощью `xbps-install`:
|
||||||
```bash
|
```bash
|
||||||
xbps-install -S bat
|
xbps-install -S bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### FreeBSD
|
### FreeBSD
|
||||||
|
|
||||||
Вы можете установить [`bat`](https://www.freshports.org/textproc/bat) с помощью pkg:
|
Вы можете установить [`bat`](https://www.freshports.org/textproc/bat) с помощью `pkg`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pkg install bat
|
pkg install bat
|
||||||
@ -243,7 +244,7 @@ make install
|
|||||||
|
|
||||||
### С помощью nix
|
### С помощью nix
|
||||||
|
|
||||||
Вы можете установить `bat` используя [nix package manager](https://nixos.org/nix):
|
Вы можете установить `bat`, используя [nix package manager](https://nixos.org/nix):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
nix-env -i bat
|
nix-env -i bat
|
||||||
@ -251,21 +252,21 @@ nix-env -i bat
|
|||||||
|
|
||||||
### openSUSE
|
### openSUSE
|
||||||
|
|
||||||
Вы можете установить`bat` с помощью zypper:
|
Вы можете установить `bat` с помощью `zypper`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
zypper install bat
|
zypper install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
### On macOS
|
### macOS
|
||||||
|
|
||||||
Вы можете установить`bat` с помощью [Homebrew](http://braumeister.org/formula/bat):
|
Вы можете установить `bat` с помощью [Homebrew](http://braumeister.org/formula/bat):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
brew install bat
|
brew install bat
|
||||||
```
|
```
|
||||||
|
|
||||||
Или-же установить его с помощью [MacPorts](https://ports.macports.org/port/bat/summary):
|
Или же установить его с помощью [MacPorts](https://ports.macports.org/port/bat/summary):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
port install bat
|
port install bat
|
||||||
@ -293,13 +294,13 @@ scoop install bat
|
|||||||
|
|
||||||
#### Из заранее скомпилированных файлов:
|
#### Из заранее скомпилированных файлов:
|
||||||
|
|
||||||
Их вы можете скачать на [странице релизов](https://github.com/sharkdp/bat/releases),
|
Их вы можете скачать на [странице релизов](https://github.com/sharkdp/bat/releases).
|
||||||
|
|
||||||
Для этого у вас должен быть установлен [Visual C++ Redistributable](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads).
|
Для этого у вас должен быть установлен [Visual C++ Redistributable](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads).
|
||||||
|
|
||||||
### С помощью Docker
|
### С помощью Docker
|
||||||
|
|
||||||
Вы можете использовать [Docker image](https://hub.docker.com/r/danlynn/bat/) чтобы запустить `bat` в контейнере:
|
Вы можете использовать [Docker image](https://hub.docker.com/r/danlynn/bat/), чтобы запустить `bat` в контейнере:
|
||||||
```bash
|
```bash
|
||||||
docker pull danlynn/bat
|
docker pull danlynn/bat
|
||||||
alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
|
alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
|
||||||
@ -331,16 +332,16 @@ ansible-galaxy install aeimer.install_bat
|
|||||||
- Arch Linux
|
- Arch Linux
|
||||||
- Void Linux
|
- Void Linux
|
||||||
- FreeBSD
|
- FreeBSD
|
||||||
- MacOS
|
- macOS
|
||||||
|
|
||||||
### С помощью бинарников
|
### Из скомпилированных файлов
|
||||||
|
|
||||||
Перейдите на [страницу релизов](https://github.com/sharkdp/bat/releases) для
|
Перейдите на [страницу релизов](https://github.com/sharkdp/bat/releases) для
|
||||||
скомпилированных файлов `bat` для различных платформ. Бинарные файлы со статической связкой так-же доступны - выбирайте архив с `musl` в имени.
|
скомпилированных файлов `bat` для различных платформ. Бинарные файлы со статической связкой так же доступны: выбирайте архив с `musl` в имени.
|
||||||
|
|
||||||
### Из исходников
|
### Из исходников
|
||||||
|
|
||||||
Если вы желаете установить `bat` из исходников, вам понадобится Rust 1.40 или выше. После этого вы должны использовать `cargo`, чтобы все скомпилировать:
|
Если вы желаете установить `bat` из исходников, вам понадобится Rust 1.40 или выше. После этого используйте `cargo`, чтобы все скомпилировать:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cargo install --locked bat
|
cargo install --locked bat
|
||||||
@ -350,8 +351,8 @@ cargo install --locked bat
|
|||||||
|
|
||||||
### Темы для выделения текста
|
### Темы для выделения текста
|
||||||
|
|
||||||
Используйте `bat --list-themes` чтобы вывести список всех доступных тем. Для выбора темы `TwoDark`, используйте `bat` с флагом
|
Используйте `bat --list-themes`, чтобы вывести список всех доступных тем. Для выбора темы `TwoDark` используйте `bat` с флагом
|
||||||
`--theme=TwoDark` или поставьте переменную окружения `BAT_THEME` равной `TwoDark`. Используйте `export BAT_THEME="TwoDark"` в стартап файле вашей оболочки, чтобы изменить ее навсегда. Или же, используйте [конфиг файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
|
`--theme=TwoDark` или выставьте переменную окружения `BAT_THEME` в `TwoDark`. Используйте `export BAT_THEME="TwoDark"` в конфигурационном файле вашей оболочки, чтобы изменить ее навсегда. Или же используйте [конфигурационный файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
|
||||||
|
|
||||||
Если вы хотите просто просмотреть темы, используйте следующую команду (для этого вам понадобится [`fzf`](https://github.com/junegunn/fzf)):
|
Если вы хотите просто просмотреть темы, используйте следующую команду (для этого вам понадобится [`fzf`](https://github.com/junegunn/fzf)):
|
||||||
```bash
|
```bash
|
||||||
@ -363,7 +364,7 @@ bat --list-themes | fzf --preview="bat --theme={} --color=always /путь/к/ф
|
|||||||
|
|
||||||
### Изменение внешнего вывода
|
### Изменение внешнего вывода
|
||||||
|
|
||||||
Вы можете использовать флаг `--style` чтобы изменять внешний вид вывода в `bat`.
|
Вы можете использовать флаг `--style`, чтобы изменять внешний вид вывода в `bat`.
|
||||||
Например, вы можете использовать `--style=numbers,changes`, чтобы показать только количество строк и изменений в Git. Установите переменную окружения `BAT_STYLE` чтобы изменить это навсегда, или используйте [конфиг файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
|
Например, вы можете использовать `--style=numbers,changes`, чтобы показать только количество строк и изменений в Git. Установите переменную окружения `BAT_STYLE` чтобы изменить это навсегда, или используйте [конфиг файл](https://github.com/sharkdp/bat#configuration-file) `bat`.
|
||||||
|
|
||||||
### Добавление новых синтаксисов
|
### Добавление новых синтаксисов
|
||||||
@ -383,7 +384,7 @@ cd "$(bat --config-dir)/syntaxes"
|
|||||||
git clone https://github.com/tellnobody1/sublime-purescript-syntax
|
git clone https://github.com/tellnobody1/sublime-purescript-syntax
|
||||||
```
|
```
|
||||||
|
|
||||||
Теперь, используйте следующую команду, чтобы превратить эти файлы в бинарный кеш:
|
Теперь используйте следующую команду, чтобы превратить эти файлы в бинарный кеш:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bat cache --build
|
bat cache --build
|
||||||
@ -399,7 +400,7 @@ bat cache --clear
|
|||||||
|
|
||||||
### Добавление новых тем
|
### Добавление новых тем
|
||||||
|
|
||||||
Это работает похожим образом, так-же как и добавление новых тем выделения синтаксиса
|
Это работает похожим образом, так же как и добавление новых тем выделения синтаксиса
|
||||||
|
|
||||||
Во-первых, создайте каталог с новыми темами для синтаксиса:
|
Во-первых, создайте каталог с новыми темами для синтаксиса:
|
||||||
```bash
|
```bash
|
||||||
@ -413,20 +414,20 @@ git clone https://github.com/greggb/sublime-snazzy
|
|||||||
bat cache --build
|
bat cache --build
|
||||||
```
|
```
|
||||||
|
|
||||||
Теперь, используйте `bat --list-themes` чтобы проверить доступность новых тем.
|
Теперь используйте `bat --list-themes`, чтобы проверить доступность новых тем.
|
||||||
|
|
||||||
### Использование другого пейджера.
|
### Использование другого пейджера.
|
||||||
|
|
||||||
`bat` использует пейджер, указанный в переменной окружения `PAGER`. Если она не задана, то используется `less`.
|
`bat` использует пейджер, указанный в переменной окружения `PAGER`. Если она не задана, то используется `less`.
|
||||||
Если вы желаете использовать другой пейджер, вы можете либо изменить переменную `PAGER`, либо `BAT_PAGER` чтобы перезаписать то, что указано в `PAGER`.
|
Если вы желаете использовать другой пейджер, вы можете либо изменить переменную `PAGER`, либо `BAT_PAGER` чтобы перезаписать то, что указано в `PAGER`.
|
||||||
|
|
||||||
Чтобы передать какие-то аргументы в ваш пейджер, вы так-же можете их поставить в этих переменных:
|
Чтобы передать дополнительные аргументы вашему пейджеру, перечислите их в этой переменной:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
export BAT_PAGER="less -RF"
|
export BAT_PAGER="less -RF"
|
||||||
```
|
```
|
||||||
|
|
||||||
Так-же вы можете использовать [файл конфигурации](https://github.com/sharkdp/bat#configuration-file) `bat` для изменения. (флаг `--pager`).
|
Так же вы можете использовать [файл конфигурации](https://github.com/sharkdp/bat#configuration-file) `bat` (флаг `--pager`).
|
||||||
|
|
||||||
**Внимание**: По умолчанию пейджером является`less` (без каких-либо аргументов),
|
**Внимание**: По умолчанию пейджером является`less` (без каких-либо аргументов),
|
||||||
`bat` задаст следующие флаги для пейджера:
|
`bat` задаст следующие флаги для пейджера:
|
||||||
@ -434,11 +435,11 @@ export BAT_PAGER="less -RF"
|
|||||||
`-F`/`--quit-if-one-screen` и `-X`/`--no-init`. Последний флаг(`-X`) используется только для `less`, чья версия раньше 530.
|
`-F`/`--quit-if-one-screen` и `-X`/`--no-init`. Последний флаг(`-X`) используется только для `less`, чья версия раньше 530.
|
||||||
|
|
||||||
Флаг `-R` нужен чтобы корректно воспроизвести ANSI цвета. Второй флаг (`-F`) говорит
|
Флаг `-R` нужен чтобы корректно воспроизвести ANSI цвета. Второй флаг (`-F`) говорит
|
||||||
`less` чтобы тот сразу-же завершился, если размер вывода меньше чем вертикальный размер терминала.
|
`less` чтобы тот сразу же завершился, если размер вывода меньше чем вертикальный размер терминала.
|
||||||
Это удобно для небольших файлов, так как вам не надо каждый раз нажимать `q`, чтобы выйти из пейджера. Третий флаг (`-X`) нужен для того, чтобы исправить баг с `--quit-if-one-screen` в старых версиях `less`. К сожалению, это блокирует возможность использования колеса мышки.
|
Это удобно для небольших файлов, так как вам не надо каждый раз нажимать `q`, чтобы выйти из пейджера. Третий флаг (`-X`) нужен для того, чтобы исправить баг с `--quit-if-one-screen` в старых версиях `less`. К сожалению, это блокирует возможность использования колеса мышки.
|
||||||
|
|
||||||
Если вы хотите все же его включить, вы можете добавить флаг `-R`.
|
Если вы хотите все же его включить, вы можете добавить флаг `-R`.
|
||||||
Для `less` новее чем 530, оно должно работать из коробки.
|
Для `less` новее чем 530 оно должно работать из коробки.
|
||||||
|
|
||||||
### Темная тема
|
### Темная тема
|
||||||
|
|
||||||
@ -450,17 +451,17 @@ alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /de
|
|||||||
|
|
||||||
## Файл конфигурации
|
## Файл конфигурации
|
||||||
|
|
||||||
`bat` так-же может быть кастомизирован с помощью файла конфигурации. Его местоположение зависит от вашей ОС, чтобы посмотреть его путь, введите
|
`bat` также может быть кастомизирован с помощью файла конфигурации. Его местоположение зависит от вашей ОС: чтобы посмотреть его путь, введите
|
||||||
```
|
```
|
||||||
bat --config-file
|
bat --config-file
|
||||||
```
|
```
|
||||||
|
|
||||||
Так-же вы можете установить переменную окружения `BAT_CONFIG_PATH` чтобы изменить путь к файлу конфигурации.
|
Также вы можете установить переменную окружения `BAT_CONFIG_PATH`, чтобы изменить путь к файлу конфигурации.
|
||||||
```bash
|
```bash
|
||||||
export BAT_CONFIG_PATH="/path/to/bat.conf"
|
export BAT_CONFIG_PATH="/path/to/bat.conf"
|
||||||
```
|
```
|
||||||
|
|
||||||
Файл конфигурации по-умолчанию может быть создан с помощью флага `--generate-config-file`.
|
Файл конфигурации «по умолчанию» может быть создан с помощью флага `--generate-config-file`.
|
||||||
```bash
|
```bash
|
||||||
bat --generate-config-file
|
bat --generate-config-file
|
||||||
```
|
```
|
||||||
@ -471,19 +472,19 @@ bat --generate-config-file
|
|||||||
|
|
||||||
Пример файла конфигурации:
|
Пример файла конфигурации:
|
||||||
```bash
|
```bash
|
||||||
# Устанавливает тему "TwoDark"
|
# Установить тему "TwoDark"
|
||||||
--theme="TwoDark"
|
--theme="TwoDark"
|
||||||
|
|
||||||
# Показывает количество строк, изменений в Git и заголовок файла
|
# Показывать количество строк, изменений в Git и заголовок файла
|
||||||
--style="numbers,changes,header"
|
--style="numbers,changes,header"
|
||||||
|
|
||||||
# Использует наклонный текст (не все терминалы поддерживаеются)
|
# Использовать курсив (поддерживается не всеми терминалами)
|
||||||
--italic-text=always
|
--italic-text=always
|
||||||
|
|
||||||
# Использует синтаксис C++ для всех .ino файлов
|
# Использовать синтаксис C++ для всех .ino файлов
|
||||||
--map-syntax "*.ino:C++"
|
--map-syntax "*.ino:C++"
|
||||||
|
|
||||||
# Использует синтаксик Git Ignore для всех файлов .ignore
|
# Использовать синтаксик Git Ignore для всех файлов .ignore
|
||||||
--map-syntax ".ignore:Git Ignore"
|
--map-syntax ".ignore:Git Ignore"
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -497,8 +498,8 @@ Windows поддерживает только очень простой пейд
|
|||||||
|
|
||||||
### Цвета
|
### Цвета
|
||||||
|
|
||||||
Windows 10 поддерживает цвета и в`conhost.exe` (Command Prompt) и в PowerShell начиная с версии Windows
|
Windows 10 поддерживает цвета и в `conhost.exe` (Command Prompt), и в PowerShell начиная с версии Windows
|
||||||
[v1511](https://ru.wikipedia.org/wiki/Windows_10#Обновления и поддержка), так-же как и в bash. На ранних версиях Windows, вы можете использовать
|
[v1511](https://ru.wikipedia.org/wiki/Windows_10#Обновления и поддержка), так же как и в bash. На ранних версиях Windows вы можете использовать
|
||||||
[Cmder](http://cmder.net/), в котором есть [ConEmu](https://conemu.github.io/).
|
[Cmder](http://cmder.net/), в котором есть [ConEmu](https://conemu.github.io/).
|
||||||
|
|
||||||
**Внимание:** Версия `less` в Git и MSYS2 воспроизводит цвета некорректно. Если у вас нет других пейджеров, мы можете отключить использование пейджеров с помощью флага `--paging=never`
|
**Внимание:** Версия `less` в Git и MSYS2 воспроизводит цвета некорректно. Если у вас нет других пейджеров, мы можете отключить использование пейджеров с помощью флага `--paging=never`
|
||||||
@ -506,9 +507,9 @@ Windows 10 поддерживает цвета и в`conhost.exe` (Command Promp
|
|||||||
|
|
||||||
### Cygwin
|
### Cygwin
|
||||||
|
|
||||||
`bat` не поддерижвает нативно пути в стиле Unix (`/cygdrive/*`). Когда указан абсолютный путь cygwin, `bat` выдаст следующую ошибку: `The system cannot find the path specified. (os error 3)`
|
Из коробки `bat` не поддерживает пути в стиле Unix (`/cygdrive/*`). Когда указан абсолютный путь cygwin, `bat` выдаст следующую ошибку: `The system cannot find the path specified. (os error 3)`
|
||||||
|
|
||||||
Она может быть решена, добавлением следующей функции в `.bash_profile`:
|
Она может быть решена добавлением следующей функции в `.bash_profile`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bat() {
|
bat() {
|
||||||
@ -528,25 +529,25 @@ bat() {
|
|||||||
|
|
||||||
### Терминалы и цвета
|
### Терминалы и цвета
|
||||||
|
|
||||||
`bat` поддерживает терминалы *с* и *без* поддержки truecolor. Однако подсветка синтаксиса не оптимизирована к 8-битным цветам, и рекомендуется использовать терминалы с поддержкой 24-битных цветов (`terminator`, `konsole`, `iTerm2`, ...).
|
`bat` поддерживает терминалы *с* и *без* поддержки truecolor. Однако подсветка синтаксиса не оптимизирована для терминалов с 8-битными цветами, и рекомендуется использовать терминалы с поддержкой 24-битных цветов (`terminator`, `konsole`, `iTerm2`, ...).
|
||||||
Смотрите [эту статью](https://gist.github.com/XVilka/8346728) для полного списка терминалов.
|
Смотрите [эту статью](https://gist.github.com/XVilka/8346728) для полного списка терминалов.
|
||||||
|
|
||||||
Удостовертесь, что переменная `COLORTERM` равна`truecolor` или
|
Удостовертесь, что переменная `COLORTERM` равна `truecolor` или
|
||||||
`24bit`. Иначе `bat` не сможет определить поддержку 24-битных цветов (и будет использовать 8-битные).
|
`24bit`. Иначе `bat` не сможет определить поддержку 24-битных цветов (и будет использовать 8-битные).
|
||||||
|
|
||||||
### Текст и номера строк плохо видны
|
### Текст и номера строк плохо видны
|
||||||
|
|
||||||
Используйте другую тему (смотрите `bat --list-themes` чтобы увидеть все темы). Темы `OneHalfDark` и
|
Используйте другую тему (`bat --list-themes` выведет список всех установленных тем). Темы `OneHalfDark` и
|
||||||
`OneHalfLight` имеют более яркие номера строк и тексты.
|
`OneHalfLight` имеют более яркие номера строк и тексты.
|
||||||
|
|
||||||
### Кодировки файлов
|
### Кодировки файлов
|
||||||
|
|
||||||
`bat` поддерживает UTF-8 и UTF-16. Для другой кодировки, вам возможно будет нужно перекодировать их, так как кодировка может быть распознана не верно. Используйте `iconv`.
|
`bat` поддерживает UTF-8 и UTF-16. Файлы в других кодировках, возможно, придётся перекодировать, так как кодировка может быть распознана неверно. Используйте `iconv`.
|
||||||
Пример: у вас есть PHP файл в кодировке Latin-1 (ISO-8859-1):
|
Пример: у вас есть PHP файл в кодировке Latin-1 (ISO-8859-1):
|
||||||
``` bash
|
``` bash
|
||||||
iconv -f ISO-8859-1 -t UTF-8 my-file.php | bat
|
iconv -f ISO-8859-1 -t UTF-8 my-file.php | bat
|
||||||
```
|
```
|
||||||
Внимание: вам может понадобится флаг `-l`/`--language` если синтаксис не смог быть авто-определен `bat`.
|
Внимание: вам может понадобится флаг `-l`/`--language`, если `bat` не сможет автоматически определить синтаксис.
|
||||||
|
|
||||||
## Разработка
|
## Разработка
|
||||||
|
|
||||||
@ -564,7 +565,7 @@ cargo test
|
|||||||
# Установка (релизная версия)
|
# Установка (релизная версия)
|
||||||
cargo install --locked
|
cargo install --locked
|
||||||
|
|
||||||
#Компилирование исполняего файла bat с другим синтаксисом и темами
|
# Компилирование исполняего файла bat с другим синтаксисом и темами
|
||||||
bash assets/create.sh
|
bash assets/create.sh
|
||||||
cargo install --locked --force
|
cargo install --locked --force
|
||||||
```
|
```
|
||||||
@ -576,18 +577,18 @@ cargo install --locked --force
|
|||||||
|
|
||||||
## Цели и альтернативы
|
## Цели и альтернативы
|
||||||
|
|
||||||
`bat` старается добится:
|
Цели проекта `bat`:
|
||||||
|
|
||||||
- Красивый, продвинутый синтаксис.
|
- Красивая и продвинутая подсветка синтаксиса.
|
||||||
- Интеграция с Git
|
- Интеграция с Git.
|
||||||
- Быть заменой `cat`
|
- Полноценная замена `cat`.
|
||||||
- Предлагать дружелюбный интерфейс и аргументы.
|
- Дружелюбный интерфейс и аргументы.
|
||||||
|
|
||||||
Есть очень много альтернатив `bat`. Смотрите [этот документ](doc/alternatives.md) для сравнения.
|
Есть очень много альтернатив `bat`. Смотрите [этот документ](doc/alternatives.md) для сравнения.
|
||||||
|
|
||||||
## Лицензия
|
## Лицензия
|
||||||
Copyright (c) 2018-2020 [Разработчики bat](https://github.com/sharkdp/bat).
|
Copyright (c) 2018-2020 [Разработчики bat](https://github.com/sharkdp/bat).
|
||||||
|
|
||||||
`bat` распостраняется под лицензями MIT License и Apache License 2.0.
|
`bat` распостраняется под лицензями MIT License и Apache License 2.0 (на выбор пользователя).
|
||||||
|
|
||||||
Смотрите [LICENSE-APACHE](LICENSE-APACHE) и [LICENSE-MIT](LICENSE-MIT) для более подробного ознакомления.
|
Смотрите [LICENSE-APACHE](LICENSE-APACHE) и [LICENSE-MIT](LICENSE-MIT) для более подробного ознакомления.
|
||||||
|
Loading…
Reference in New Issue
Block a user