nushell · mshalmanov · Feb 24, 2025 · Feb 24, 2025 · Mar 18, 2025 · Mar 19, 2025
diff --git a/.vuepress/configs/sidebar/ru.ts b/.vuepress/configs/sidebar/ru.ts
@@ -8,19 +8,25 @@ export const sidebarRU: SidebarConfig = {
       link: '/ru/book/README.md',
       collapsible: false,
     },
-    // {
-    //   text: 'Начало работы',
-    //   link: '/ru/book/getting_started.md',
-    //   collapsible: false,
-    //   children: [
-    //     '/ru/book/installation.md',
-    //     '/ru/book/default_shell.md',
-    //     '/ru/book/quick_tour.md',
-    //     '/ru/book/moving_around.md',
-    //     '/ru/book/thinking_in_nu.md',
-    //     '/ru/book/cheat_sheet.md',
-    //   ],
-    // },
+    {
+      text: 'Установка',
+      link: '/ru/book/installation.md',
+      collapsible: false,
+      children: ['default_shell.md'],
+    },
+    {
+      text: 'Начало работы',
+      link: '/ru/book/getting_started.md',
+      collapsible: false,
+      children: [
+        //     '/ru/book/installation.md',
+        //     '/ru/book/default_shell.md',
+        '/ru/book/quick_tour.md',
+        '/ru/book/moving_around.md',
+        //     '/ru/book/thinking_in_nu.md',
+        //     '/ru/book/cheat_sheet.md',
+      ],
+    },
     // {
     //   text: 'Основы Nu',
     //   link: '/nu_fundamentals.md',

diff --git a/ru/book/README.md b/ru/book/README.md
@@ -15,6 +15,7 @@ Nu берет пример со многих знакомых мест: трад
 Книга разделена на главы, которые далее разбиты на разделы.
 Вы можете нажать на заголовки глав, чтобы получить более подробную информацию о них.
 
+- [Установка](installation.md), конечно же, поможет вам установить Nushell на вашу систему.
 - [Начало работы (EN)](/book/getting_started.md) научит вас, как установить Nushell, и покажет вам, что к чему. В ней также объясняются некоторые принципы проектирования, по которым Nushell отличается от типичных оболочек, таких как bash.
 - [Основы Nu (EN)](/book/nu_fundamentals.md) объясняет основные понятия языка Nushell.
 - [Программирование в Nu (EN)](/book/programming_in_nu.md) более глубоко погружает в особенности языка и показывает несколько способов организации и структурирования вашего кода.

diff --git a/ru/book/default_shell.md b/ru/book/default_shell.md
@@ -0,0 +1,31 @@
+# Оболочка по умолчанию
+
+## Настройка Nu как оболочка по умолчанию в вашем терминале
+
+|     Терминал     | Платформа    |                                                                                                                                           Инструкции                                                                                                                                            |
+| :--------------: | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
+|  GNOME Terminal  | Linux & BSDs |                                     Открыть `Edit > Preferences`. В правой панели выберите вкладку `Command`, поставке галочку возле пункта `Run a custom command instead of my shell`, в поле `Custom command` укажите путь к расположению директории Nu.                                      |
+|  GNOME Console   | Linux & BSDs |          Введите команду `gsettings set org.gnome.Console shell "['/usr/bin/nu']"` (замените `/usr/bin/nu` на путь расположения директории Nu). Эквивалентно, используйте [dconf Editor](https://apps.gnome.org/DconfEditor/) чтобы отредактировать ключь `/org/gnome/Console/shell`.           |
+|      Kitty       | Linux & BSDs |                                                                 Нажмите `Ctrl`+`Shift`+`F2` чтобы открыть `kitty.conf`. Перейдите в раздел `shell`, расскоментируйте строку и замените `.` на путь расположения директории Nu.                                                                  |
+|     Konsole      | Linux & BSDs |                                                                                             Откройте `Settings > Edit Current Profile`. В поле `Command` укажите путь к расположению директории Nu.                                                                                             |
+|  XFCE Terminal   | Linux & BSDs |                                                                 Откройте `Edit > Preferences`. поставте галочку `Run a custom command instead of my shell`, в поле `Custom command` укажите путь к расположению директории Nu.                                                                  |
+|   Terminal.app   | macOS        | Откройте `Terminal > Preferences`. Убедитесь что вы находитесь на вкладке `Profiles`, которая должна быть выбрана по умолчанию. В правой панели выберите вкладку `Shell`. поставте галочку возде пункта `Run command`, введите путь к Nu в текстовое поле, и снемите влажок `Run inside shell`. |
+|      iTerm2      | macOS        |                                  Открой `iTerm > Preferences`. выбери вкладку `Profiles`. В правой части панели под текстом `Command`, в выпадающем меню измени `Login Shell` на `Custom Shell`, и вставь в текстовое поле путь к расположению директории Nu.                                   |
+| Windows Terminal | Windows      |        Нажми `Ctrl`+`,` для открытия `Settings`. Перейди `Add a new profile > New empty profile`. Заполни 'Name' и укажите путь к расположению директории Nu в текстовое поле 'Command line'. Перейди в настройки `Startup` и выбери Nu как 'профиль по умолчанию'. Нажми кнопку `Save`.        |
+
+## Настройка Nu как login shell (Linux, BSD и macOS)
+
+::: warning
+Nu не предназначен для обеспечения совместимости с POSIX.
+Имейте в виду, что некоторые программы в вашей системе (или из документация) могут предпологать что ваша оболочка входа в систему совместима с [POSIX](https://en.wikipedia.org/wiki/POSIX).
+Нарушение этого предположения может привести к неожыданным проблемам. Дополнительные сведения см. в разделе [Конфигурация - Login Shell](./configuration.md#configuring-nu-as-a-login-shell).
+:::
+
+Чтобы установить login shell вы можете воспользоваться командой [`chsh`](https://linux.die.net/man/1/chsh).
+Некоторые дистрибутивы Linux имеют список доступных оболочек, расположенных в `/etc/shells` и запрещают изменять оболочку пока Nu в белом списке (whitelist).
+Вы можете увидить ошибку, подобную приведенной ниже, если вы не обновили файл `shells`:
+
+@[code](@snippets/installation/chsh_invalid_shell_error.sh)
+
+Вы можете добавить Nu в список разрешенных оболочек, добавив свой бинарник Nu в файл `shells`.
+Путь к добавлению можно найти с помощью команды `which nu`, обычно это `$HOME/.cargo/bin/nu`.
diff --git a/ru/book/getting_started.md b/ru/book/getting_started.md
@@ -0,0 +1,7 @@
+# Начало работы
+
+Давайте начнем! :elephant:
+
+В следующих разделах вы получите [краткий обзор Nushell с примерами](quick_tour.md) (включая то, как получить помощь из Nushell) и узнаете, как [перемещаться по файловой системе](moving_around.md).
+
+Затем, поскольку Nushell принимает некоторые дизайнерские решения, которые довольно отличаются от типичных оболочек или динамических языков сценариев, обязательно ознакомьтесь с разделом [Думать в Nu](thinking_in_nu.md), где мы объясняем некоторые из этих концепций.
diff --git a/ru/book/installation.md b/ru/book/installation.md
@@ -0,0 +1,141 @@
+# Установка Nu
+
+Существует множество способов чтобы получить Nu и работать. Вы можете скачать предварительно собранный двоичные файлы с нашей [страница релиза](https://github.com/nushell/nushell/releases), [использовать ваш любимый менеджер пакетов](https://repology.org/project/nushell/versions), или собрать из исходника.
+
+Главный двоичный файл Nushell называется `nu` (или `nu.exe` в Windows). После установки, вы можете запустить его, набрав `nu`.
+
+@[code](@snippets/installation/run_nu.sh)
+
+[[toc]]
+
+## Предварительно собранные двоичные файлы
+
+[С каждым релизом на GitHub](https://github.com/nushell/nushell/releases) публикуются двличные файлы Nu для Linux, macOS, и Windows. Просто загрузите, распакуйте двоичный файл, а затем скопируйте путь в ваше переменное окружения PATH.
+
+## Менеджер пакетов
+
+Nu доступен через нескольких пакетных менеджеров:
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/nushell.svg)](https://repology.org/project/nushell/versions)
+
+Для macOS и Linux, [Homebrew](https://brew.sh/) популярный выбор (`brew install nushell`).
+
+Для Windows:
+
+- [Winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/) (`winget install nushell`)
+- [Chocolatey](https://chocolatey.org/) (`choco install nushell`)
+- [Scoop](https://scoop.sh/) (`scoop install nu`)
+
+Кросс-платформенная установка:
+
+- [npm](https://www.npmjs.com/) (`npm install -g nushell` Примечание. Плагин nu не входить в комплект, если вы устанавливает их таким образом)
+
+## Образ docker контейнера 
+
+Docker образ доступен из реестра контейнеров GitHub. Образ последней версии регулярно собирается 
+для Alpine и Debian. Вы можете запустить образ в интерактивном режиме, используя:
+
+```nu
+docker run -it --rm ghcr.io/nushell/nushell:<version>-<distro>
+```
+
+Где `<version>` - это версия Nushell, которую вы хотите запустить, а `<distro>` - это `alpine` или последний поддерживаемый выпуск Debian, например `bookworm`.
+
+Чтобы запустить определенную команду, используйте:
+
+```nu
+docker run --rm ghcr.io/nushell/nushell:latest-alpine -c "ls /usr/bin | where size > 10KiB"
+```
+
+Чтобы запустить скрипт из текущего каталога с помощью Bash, используйте:
+
+```nu
+docker run --rm \
+    -v $(pwd):/work \
+    ghcr.io/nushell/nushell:latest-alpine \
+    "/work/script.nu"
+```
+
+## Сборка из исходников
+
+Вы можете собрать Nu из исходников. Сначала, вам нужно установить инструментарий Rust и его зависимости.
+
+### Установка набора компиляторов
+
+Чтобы Rust работал правильно, в вашей системе должен быть совместимый набор комиляторов. Вот рекомендуемый набор компиляторов:
+
+- Linux: GCC или Clang
+- macOS: Clang (установить Xcode)
+- Windows: MSVC (установить [Visual Studio](https://visualstudio.microsoft.com/vs/community/) или [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022))
+  - Обязательно установитье "Desktop development with C++"
+  - Подойдет любая версия редактора Visual Studio (редакция Community).
+
+### Установка Rust
+
+Если у вас еще не нет Rust в вашей системе, лучший способ установить его через [rustup](https://rustup.rs/). Rustup - это способ управления установками Rust, включая управление использованием различных версий Rust.
+
+В настоящее время Nu требуется **latest stable (1.66.1 or later)** версию Rust. Лучший способ - позволить `rustup` найти правильную для вас верисю. Когда вы впервые откроете `rustup`, он спросит, какую версию Rust вы желаете установить:
+
+@[code](@snippets/installation/rustup_choose_rust_version.sh)
+
+Как только вы будете готовы, нажмите 1, а затем нажмите enter.
+
+Если вы не желаете устанавливать Rust через `rustup`, вы также можете установить you его другими способами (например из пакета дистрибутива Linux). Только убедитесь, что вы установили версию Rust 1.66.1 или последнюю.
+
+### Зависимости
+
+#### Debian/Ubuntu
+
+Вам потребуется установить пакеты "pkg-config", "build-essential" и "libssl-dev":
+
+@[code](@snippets/installation/install_pkg_config_libssl_dev.sh)
+
+#### Дистрибутивы на базе RHEL
+
+Вам потребуется установить "libxcb", "openssl-devel" и "libX11-devel":
+
+@[code](@snippets/installation/install_rhel_dependencies.sh)
+
+#### macOS
+
+##### Homebrew
+
+Используя [Homebrew](https://brew.sh/), вам нужно будет установить "openssl" и "cmake" используя команду:
+
+@[code](@snippets/installation/macos_deps.sh)
+
+##### Nix
+
+Если испольуете [Nix](https://nixos.org/download/#nix-install-macos) для менеджера пакетов на macOS, необходимы пакеты `openssl`, `cmake`, `pkg-config`, и `curl`. Их можно установить:
+
+- Глобально, используя `nix-env --install` (и другие).
+- Локально, используя [Home Manager](https://github.com/nix-community/home-manager) в конфигурации `home.nix`.
+- Временно, используя `nix-shell` (и другие).
+
+### Сборка из [crates.io](https://crates.io) с помощью Cargo
+
+Релизы Nushell публикуются в виде исходных текстов в популярном реестре пакетов Rust [crates.io](https://crates.io/). Это создает легкость сборки и установки последней версий Nu с помощью `cargo`:
+
+```nu
+cargo install nu --locked
+```
+
+Инструмент `cargo` выполнит работу по загрузке Nu и его исходных зависимостей, сборке и установке cargo по пути каталога bin.
+
+Примечание что плагины по умолчанию должны быть установлены отдельно при использовании `cargo`. Смотрите раздел [Установка плагинов](./plugins.html#core-plugins) в книге инструкций.
+
+### Сборка из GitHub репозитория
+
+Вы так же можете собрать Nu из последних исходников на GitHub. Это даст вам немедленный доступ к последним функциям и исправлениям. Сначала, склонируйте репозиторий:
+
+@[code](@snippets/installation/git_clone_nu.sh)
+
+После этого мы можем собрать и запустить Nu с помощью:
+
+@[code](@snippets/installation/build_nu_from_source.sh)
+
+Вы также можете собирать и запускать Nu в режиме релиза, что позволяет использовать больше оптимизаций:
+
+@[code](@snippets/installation/build_nu_from_source_release.sh)
+
+Люди, знакомые с Rust, могут удивиться, почему мы выполняем "build", и "run", если "run" по умолчанию выполняет сборку. Это делается для того, чтобы обойти недостаток новой опции `default-run` в Cargo и убедиться, что все плагины собраны, хотя в будущем это может и не понадобиться.