منصوبے کے بارے میں

یہ ریپوزٹری "The Rust Programming Language" کا ماخذ رکھتی ہے، جو Rust زبان کے لیے بنیادی تعارفی کتاب ہے۔ مکمل کتاب No Starch Press سے طباعت شدہ شائع ہوتی ہے اور مفت آن لائن بھی دستیاب ہے، جو stable، beta، اور nightly Rust ریلیزز کے ساتھ بھیجی جاتی ہے (حالانکہ یہ شامل شدہ کاپیاں یہاں کی گئی اصلاحات سے پیچھے رہ سکتی ہیں)۔ ایک ریلیزز صفحہ کتاب میں ظاہر ہونے والی تمام فہرستوں کے لیے ڈاؤن لوڈ قابل کوڈ فراہم کرتا ہے۔ کتاب مارک ڈاؤن میں لکھی گئی ہے اور mdBook سے تیار کی گئی ہے، جو Rust کمیونٹی کا کتابوں کے لیے جامد سائٹ جنریٹر ہے۔ تعمیر کے لیے ایک مخصوص mdBook ورژن انسٹال کرنا ضروری ہے (جو rust-lang/rust کے rustbook ٹولنگ میں پن کیا گیا ہے) `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 لیبل کے ذریعے ٹریک کیا جاتا ہے اور نئی زبان کی کوششیں مسائل کے طور پر کھولی جا سکتی ہیں، حالانکہ انضمام mdBook کی کثیر زبان کی حمایت کا انتظار کرتا ہے۔ ایک `ci/spellcheck.sh` اسکرپٹ اور `ci/dictionary.txt` لغت ہجے کی جانچ کی حمایت کرتے ہیں، جس میں جھوٹے مثبت (جیسے شناخت کنندگان جیسے `BTreeMap`) کو ترتیب شدہ ترتیب میں لغت میں شامل کیا جاتا ہے۔ مجموعی طور پر، یہ رن ٹائم ٹول کے بجائے ایک دستاویزات اور تعلیمی منصوبہ ہے: صارفین کے لیے اس کی قدر Rust کے لیے مستند سیکھنے کے وسیلے کے طور پر ہے، جس میں ایک اچھی طرح سے دستاویز شدہ تعمیر پائپ لائن، کوڈ نمونوں کے لیے جانچ کا نظام، اور ایک منظم شراکت اور ترجمہ کا کام کا بہاؤ ہے۔