Об этом проекте

Этот репозиторий содержит исходный код книги «Язык программирования Rust» — канонического вводного руководства по языку Rust. Готовая книга публикуется в печатном виде издательством No Starch Press, а также доступна бесплатно онлайн и поставляется вместе со стабильными, бета- и ночными сборками Rust (хотя эти встроенные копии могут отставать от исправлений, внесённых здесь). На странице релизов доступен загружаемый код для всех листингов, приведённых в книге. Книга написана в формате Markdown и обрабатывается с помощью mdBook — генератора статических сайтов для книг из экосистемы Rust. Для сборки требуется установить конкретную версию mdBook (соответствующую версии, закреплённой в инструментарии rustbook в rust-lang/rust) через `cargo install mdbook --locked --version <номер_версии>`, затем выполнить `mdbook build` для создания статического сайта в подкаталоге `book`, который можно просмотреть в любом браузере. В README описаны команды запуска браузера для Firefox и Chrome в Linux, macOS и Windows (как PowerShell, так и Cmd). Тесты для примеров кода находятся в `packages/trpl` и запускаются с помощью `mdbook test --library-path packages/trpl/target/debug/deps`. Вклад приветствуется в соответствии с рекомендациями CONTRIBUTING.md, но поскольку книга печатается, а сопровождающие стремятся поддерживать онлайн-версию близкой к печатному изданию, правки группируются вокруг выпусков редакций Rust. Между этими крупными ревизиями принимаются только строгие исправления ошибок, поэтому запросы на изменения, не связанные с ошибками, могут ждать месяцы или годы. Переводы отслеживаются через метку Translations, а новые языковые инициативы можно открывать как issues, хотя их объединение ожидает поддержки многоязычности в mdBook. Скрипт `ci/spellcheck.sh` вместе со словарём `ci/dictionary.txt` поддерживают проверку орфографии, при этом ложные срабатывания (например, идентификаторы вроде `BTreeMap`) добавляются в словарь в отсортированном порядке. В целом это документационный и образовательный проект, а не инструмент времени выполнения: его ценность для пользователей заключается в том, что он является авторитетным учебным ресурсом по Rust, с хорошо документированным конвейером сборки, тестовой средой для примеров кода и структурированным процессом внесения вклада и перевода.