عن المشروع

يحتوي هذا المستودع على مصدر كتاب "The Rust Programming Language"، الكتاب التمهيدي الأساسي للغة Rust. يُنشر الكتاب المكتمل مطبوعًا عبر No Starch Press، وهو متاح أيضًا مجانًا عبر الإنترنت، ويُوزَّع مع إصدارات Rust المستقرة والبيتا والليلية (على الرغم من أن هذه النسخ المرفقة قد تتأخر عن الإصلاحات التي تُجرى هنا). توفر صفحة الإصدارات تعليمات برمجية قابلة للتنزيل لجميع القوائم الواردة في الكتاب. الكتاب مُؤلَّف بلغة Markdown ويُعرض باستخدام mdBook، وهو مولد المواقع الثابتة للكتب في مجتمع Rust. يتطلب البناء تثبيت إصدار معين من mdBook (مطابق للإصدار المثبت في أداة rustbook في rust-lang/rust) عبر `cargo install mdbook --locked --version <version_num>`، ثم تشغيل `mdbook build` لإنتاج موقع ثابت في المجلد الفرعي `book`، يمكن عرضه في أي متصفح. يوثق ملف README أوامر فتح المتصفح لكل من Firefox وChrome على لينكس و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، مع خط أنابيب بناء موثق جيدًا، ومنصة اختبار لأمثلة التعليمات البرمجية، وسير عمل منظم للمساهمة والترجمة.