book

このリポジトリは、Rust言語の標準的な入門書である『The Rust Programming Language』のソースを管理しています。完成した書籍はNo Starch Pressから紙版が刊行されているほか、安定版・ベータ版・ナイトリー版のRustリリースに同梱される形で無料のオンライン版も提供されています（ただし、同梱版はここでの修正が反映されていない場合があります）。リリースページでは、書籍に登場するすべてのコード一覧をダウンロードできます。 本書はMarkdownで執筆され、Rustコミュニティの書籍向け静的サイトジェネレータであるmdBookでレンダリングされています。ビルドするには、`cargo install mdbook --locked --version <バージョン番号>` で特定のmdBookバージョン（rust-lang/rustのrustbookツールで固定されているものと一致）をインストールし、その後 `mdbook build` を実行して `book` サブディレクトリに静的サイトを生成します。これは任意のブラウザで閲覧できます。READMEには、Linux、macOS、Windows（PowerShellとCmdの両方）でFirefoxとChromeを起動するコマンドが記載されています。コード例のテストは `packages/trpl` にあり、`mdbook test --library-path packages/trpl/target/debug/deps` で実行します。 CONTRIBUTING.mdのガイドラインに従って貢献を受け付けていますが、書籍が印刷されていることと、メンテナがオンライン版を印刷版に近づけたいと考えているため、改訂はRust Editionのリリースに合わせて一括で行われます。その大きな改訂の合間には、厳密なエラー修正のみがマージされるため、エラーではないプルリクエストは数か月から数年間待つ場合があります。翻訳はTranslationsラベルで追跡され、新しい言語の取り組みはIssueとして開始できますが、マージにはmdBookの多言語サポートが待たれます。`ci/spellcheck.sh` スクリプトと `ci/dictionary.txt` 辞書でスペルチェックをサポートしており、誤検出（`BTreeMap` のような識別子）は辞書にソート順で追加されます。 全体として、これは実行時ツールではなく、ドキュメントおよび教育プロジェクトです。ユーザーにとっての価値は、Rustの権威ある学習リソースとしての役割にあり、文書化されたビルドパイプライン、コードサンプルのテストハーネス、構造化されたコントリビューションおよび翻訳のワークフローを備えています。