From 8dfa69fde4b0744ffc2aac91c80a9764ba4f6bf9 Mon Sep 17 00:00:00 2001 From: Sergey Date: Tue, 23 Jun 2020 17:45:24 +0300 Subject: [PATCH] Update README-ru.md --- doc/README-ru.md | 54 ++++++++++++++++++++++++------------------------ 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/doc/README-ru.md b/doc/README-ru.md index 5f5c3c54..7b3b95cf 100644 --- a/doc/README-ru.md +++ b/doc/README-ru.md @@ -28,7 +28,7 @@ ![Пример интеграции с Git](https://i.imgur.com/azUAzdx.png) -### Показать символы, которые не возможно отобразить +### Показать символы, которые невозможно отобразить Вы можете использовать `-A` / `--show-all` флаг чтобы показать символы, которые невозможно напечатать: @@ -36,12 +36,12 @@ ### Автоматическое разделение текста -`bat` умеет траслировать вывод в `less` если вывод слишком большой, чтобы уместится на экране целиком +`bat` умеет траслировать вывод в `less` если он слишком большой, чтобы уместится на экране полностью ### Объединение файлов -О..вы так же можете объединять файлы :wink:. Всегда когда -`bat` обнаруживает неинтерактивный терминал (например когда вы направляете вывод в файл или процесс), `bat` будет работать как вставная замена `cat` и откатится к выводу это файла как обычного текста +О..Вы так же можете объединять файлы :wink:. Всегда когда +`bat` обнаруживает неинтерактивный терминал (например когда вы направляете вывод в файл или в процесс), `bat` будет работать как `cat` и откатится к выводу это файла как обычного текста (без поддержки синтаксиса) ## Как использовать @@ -63,7 +63,7 @@ > curl -s https://sh.rustup.rs | bat ``` -Читает из stdin и указываем что это за язык +Читаем из stdin и указываем что это за язык ```bash > yaml2json .travis.yml | json_pp | bat -l json @@ -110,11 +110,11 @@ batgrep needle src/ #### `tail -f` -`bat` может быть использован с `tail -f` чтобы просматривать файл вместе с выделением синтаксиса +`bat` может быть использован вместе с `tail -f` чтобы просматривать файл вместе с выделением синтаксиса ```bash tail -f /var/log/pacman.log | bat --paging=never -l log ``` -Заметье, что мы отключаем пэйджинг чтобы это заработало. Мы так-же указываем синтаксис (`-l log`), так как он не может быть определен в данном случае. +Заметьте, что мы отключаем пэйджинг чтобы это заработало. Мы так-же указываем синтаксис (`-l log`), так как он не может быть определен в данном случае. #### `git` @@ -145,7 +145,7 @@ man 2 select Возможно вам понадобится также установить `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) разрабатывается в этом репозитории, и все еще находится в разработке. @@ -170,17 +170,17 @@ man 2 select 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 mkdir -p ~/.local/bin ln -s /usr/bin/batcat ~/.local/bin/bat ``` -### Ubuntu (С помощью самоно нового `.deb` пакета) +### Ubuntu (С помощью самого нового `.deb` пакета) *... и другие дистрибутивы Linux основанные на Debian* -Если пакет еще не был предоставлен в вашем Ubuntu/Debian или вы хотите самую последнюю версия `bat`, вы можете скачать самый последний `deb` пакет отсюда: +Если пакет еще не был предоставлен в вашем Ubuntu/Debian дистрибутиве или вы хотите самую последнюю версия `bat`, вы можете скачать самый последний `deb` пакет отсюда: [release page](https://github.com/sharkdp/bat/releases) и установить так: ```bash @@ -273,7 +273,7 @@ port install bat ### Windows -Есть несколько способов установить `bat`. Как только вы установили его, посмотрите на секцию ["Using `bat` on Windows"](#using-bat-on-windows). +Есть несколько способов установить `bat`. Как только вы установили его, посмотрите на секцию ["Использование `bat` в Windows"](#using-bat-on-windows). #### С помощью Chocolatey @@ -340,7 +340,7 @@ ansible-galaxy install aeimer.install_bat ### Из исходников -Если вы желаете установить `bat` из исходников, вам понадобится Rust 1.40 или выше. Далее, вы должны использовать `cargo` чтобы все скомпилировать: +Если вы желаете установить `bat` из исходников, вам понадобится Rust 1.40 или выше. После этого, вы должны использовать `cargo` чтобы все скомпилировать: ```bash cargo install --locked bat @@ -353,13 +353,13 @@ cargo install --locked bat Используйте `bat --list-themes` чтобы вывести список всех доступных тем. Для выбора темы `TwoDark`, используйте `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 bat --list-themes | fzf --preview="bat --theme={} --color=always /путь/к/файлу" ``` -`bat` отлично смотрится на темном фоне. Однако, если ваш терминал использует светлую тему, такие темы как `GitHub` или `OneHalfLight` будут смотрется куда лучше! -Вы так-же можете использовать новую тему, для этого перейдите [в раздел добавления тем](https://github.com/sharkdp/bat#adding-new-themes). +`bat` отлично смотрится на темном фоне. Однако, если ваш терминал использует светлую тему, такие темы как `GitHub` или `OneHalfLight` будут смотреться куда лучше! +Вы так-же можете использовать новую тему, для этого перейдите [в раздел добавления тем](https://github.com/sharkdp/bat#добавление-новых-тем). ### Изменение внешнего вывода @@ -389,9 +389,9 @@ git clone https://github.com/tellnobody1/sublime-purescript-syntax bat cache --build ``` -Наконец, используйте `bat --list-languages` чтобы проверить, доступны ли новые языки. +Теперь, вы можете использовать `bat --list-languages` чтобы проверить, доступны ли новые языки. -Если когда-нибудь вы заходите вернутся к настройкам по умолчанию, введите +Если когда-нибудь вы заходите вернуться к настройкам по-умолчанию, введите ```bash bat cache --clear @@ -428,14 +428,14 @@ export BAT_PAGER="less -RF" Так-же вы можете использовать [файл конфигурации](https://github.com/sharkdp/bat#configuration-file) `bat` для изменения. (флаг `--pager`). -**Внимание**: По умолчанию, `less` является пейджером (без каких либо аргументов), +**Внимание**: По умолчанию, пейджером является`less` (без каких либо аргументов), `bat` задаст следующие флаги для пейджера: `-R`/`--RAW-CONTROL-CHARS`, `-F`/`--quit-if-one-screen` и `-X`/`--no-init`. Последний флаг(`-X`) используется только для `less`, чья версия раньше 530. Флаг `-R` нужен чтобы корректно воспроизвести ANSI цвета. Второй флаг (`-F`) говорит `less` чтобы тот сразу-же завершился, если размер вывода меньше чем вертикальный размер терминала. -Это удобно для небольших файлов, т.к вам не надо каждый раз нажимать `q` чтобы выйти из пейджера. Третий флаг (`-X`) нужен чтобы исправить баг с `--quit-if-one-screen` в старых версиях `less`. К сожалению, это так-же блокирует возможность использования там колеса мышки. +Это удобно для небольших файлов, т.к вам не надо каждый раз нажимать `q` чтобы выйти из пейджера. Третий флаг (`-X`) нужен чтобы исправить баг с `--quit-if-one-screen` в старых версиях `less`. К сожалению, это так-же блокирует возможность использования колеса мышки. Если вы хотите все же его включить, вы можете добавить флаг `-R`. Для `less` новее чем 530, оно должно работать из коробки. @@ -467,7 +467,7 @@ bat --generate-config-file ### Формат -Файл конфигурации - это всего лишь набор аргументов. Введите `bat --help` чтобы просмотреть список всех возможных флагов и аргументов. Так-же, вы можете заккоментировать строчку с помощью `#`. +Файл конфигурации - это всего лишь набор аргументов. Введите `bat --help` чтобы просмотреть список всех возможных флагов и аргументов. Так-же, вы можете закомментировать строчку с помощью `#`. Пример файла конфигурации: ```bash @@ -489,11 +489,11 @@ bat --generate-config-file ## Использование `bat` в Windows -`bat` в основном работает полностью из коробки, но несколько возможностей нуждаются в настройке. +`bat` в основном работает полностью из-коробки, но несколько возможностей нуждаются в настройке. ### Пейджинг -Windows поддерживает только очень простой пейджер `more`. Вы можете скачать установщик для `less` [с его сайта](http://www.greenwoodsoftware.com/less/download.html) или [через Chocolatey](https://chocolatey.org/packages/Less). Чтобы его использовать, скопируйте исполняемый файл в ваш `PATH` или [используйте переменную окружения](#using-a-different-pager). [Пакет из Chocolatey](#on-windows) установит все автоматически. +Windows поддерживает только очень простой пейджер `more`. Вы можете скачать установщик для `less` [с его сайта](http://www.greenwoodsoftware.com/less/download.html) или [через Chocolatey](https://chocolatey.org/packages/Less). Чтобы его использовать, скопируйте исполняемый файл в ваш `PATH` или [используйте переменную окружения](#Использование-другого-пейджера). [Пакет из Chocolatey](#windows) установит все автоматически. ### Цвета @@ -501,7 +501,7 @@ Windows 10 поддерживает цвета и в`conhost.exe` (Command Promp [v1511](https://ru.wikipedia.org/wiki/Windows_10#Обновления и поддержка), так-же как и в bash. На ранних версиях Windows, вы можете использовать [Cmder](http://cmder.net/), в котором есть [ConEmu](https://conemu.github.io/). -**Внимание:** Версия `less` в Git и MSYS2 воспроизводит цвета неккоректно. Если у вас нет других пейджеров, мы можете отключить испольщование пейджеров с помощью флага `--paging=never` +**Внимание:** Версия `less` в Git и MSYS2 воспроизводит цвета некорректно. Если у вас нет других пейджеров, мы можете отключить использование пейджеров с помощью флага `--paging=never` или установить `BAT_PAGER` равным пустой строке. ### Cygwin @@ -528,15 +528,15 @@ bat() { ### Терминалы и цвета -`bat` поддерживает терминалы *с* и *без* поддержки truecolor. Однако,цвета в выделении синтаксиса не оптимизированы к 8-ми битным цветам и рекоментуется использовать терминалы с поддержкой 24-ых битных цветов (`terminator`, `konsole`, `iTerm2`, ...). +`bat` поддерживает терминалы *с* и *без* поддержки truecolor. Однако,цвета в выделении синтаксиса не оптимизированы к 8-ми битным цветам и рекомендуется использовать терминалы с поддержкой 24-ых битных цветов (`terminator`, `konsole`, `iTerm2`, ...). Смотрите [эту статью](https://gist.github.com/XVilka/8346728) для полного списка терминалов. Удостовертесь, что переменная `COLORTERM` равна`truecolor` или -`24bit`. Иначе, `bat` не сможет определить поддержку 24 битных цветов(и будет использовать 8 битные). +`24bit`. Иначе, `bat` не сможет определить поддержку 24-битных цветов(и будет использовать 8-битные). ### Текст и номера строк плохо видны -Используйте другую тему (смотрите `bat --list-themes` чтобы увидеть все тмы). Темы `OneHalfDark` и +Используйте другую тему (смотрите `bat --list-themes` чтобы увидеть все темы). Темы `OneHalfDark` и `OneHalfLight` имеют более яркие номера строк и тексты. ### Кодировки файлов