Использование китайской документации стандартной библиотеки Rust в IDE

В каталоге dist есть два файла, это готовые китайские документы. У одного из файлов расширение с припиской contrast. Эти два документа отличаются:

• Документ без расширения contrast — это чисто китайский документ, английский контент был заменён на китайский.

• Документ с расширением contrast — это сравнительный документ, где после английских предложений добавлены их переводы на китайский язык.

Установка китайских документов

Установка через скрипт

Windows

# Выполнить в Powershell
# Этот скрипт запросит и выполнит `bin/install.ps1` в текущем проекте

powershell.exe -encodedCommand ([Convert]::ToBase64String([System.Text.Encoding]::Unicode.GetBytes((Invoke-WebRequest -Uri "https://gitee.com/wtklbm/rust-library-chinese/raw/main/bin/install.ps1").Content)))

macOS или Linux

# Выполнить в терминале
# Этот скрипт запросит и выполнит `bin/install.sh` в текущем проекте

bash <(curl -fsSLk https://gitee.com/wtklbm/rust-library-chinese/raw/main/bin/install.sh)

Ручная установка

• При использовании китайских документов обратите внимание на версию, версия китайских документов должна соответствовать версии Rust.
• Используйте только стабильную версию, нельзя использовать бета-версии и nightly.
• В переведённых исходных кодах в конце некоторых документов есть пустые строки комментариев. Это сделано намеренно, не удаляйте их. Если вы удалите их, source-map перестанет работать, а это приведёт к серьёзным проблемам при отладке исходного кода.

Последние сборки находятся в каталоге dist, вы можете перейти туда и загрузить последнюю сборку.

Если вы новичок в Rust, убедитесь, что Rust установлен и работает. После установки Rust установите компонент rust-src с помощью команды rustup component add rust-src. После установки компонента rust-src выполните следующие шаги:

1. В терминале выполните команду rustup default stable, чтобы переключиться на стабильную версию и убедиться, что стабильная версия соответствует версии китайских документов.
2. В терминале выполните rustup show home, найдите соответствующий путь в выводе и откройте его в диспетчере файлов.
3. Откройте папку toolchains, найдите текущую цепочку инструментов Rust и откройте её, например, для платформы Windows это будет папка stable-x86_64-pc-windows-msvc.
4. Затем откройте каталог lib/rustlib/src/rust, здесь находится исходный код стандартной библиотеки Rust.
5. Скопируйте содержимое папки lib/rustlib/src/rust/library.
6. Загрузите исходный файл этого репозитория, переименуйте его в library и поместите в папку lib/rustlib/src/rust.
7. Убедитесь, что в вашей IDE установлены плагины для Rust, такие как:
   • Для Visual Studio Code — rust-analyzer (https://marketplace.visualstudio.com/items?itemName=matklad.rust-analyzer).
   • Для JetBrains — Rust (https://plugins.jetbrains.com/plugin/8182-rust).
8. Перезапустите IDE, и китайские документы начнут работать.
9. Наслаждайтесь кодированием!

Удаление китайских документов

# В терминале выполнить

rustup component remove rust-src
rustup component add rust-src