इस प्रोजेक्ट के बारे में

यह रिपॉजिटरी "द रस्ट प्रोग्रामिंग लैंग्वेज" का स्रोत रखती है, जो रस्ट भाषा के लिए प्रामाणिक परिचयात्मक पुस्तक है। तैयार पुस्तक No Starch Press द्वारा मुद्रित रूप में प्रकाशित होती है और स्थिर, बीटा और नाइटली रस्ट रिलीज़ों के साथ मुफ्त ऑनलाइन भी उपलब्ध है (हालाँकि ये बंडल की गई प्रतियाँ यहाँ किए गए सुधारों से पीछे हो सकती हैं)। एक रिलीज़ पृष्ठ पुस्तक में आने वाले सभी कोड सूचियों के लिए डाउनलोड करने योग्य कोड प्रदान करता है। पुस्तक Markdown में लिखी गई है और mdBook से प्रस्तुत की जाती है, जो रस्ट समुदाय का पुस्तकों के लिए स्टैटिक-साइट जनरेटर है। निर्माण के लिए `cargo install mdbook --locked --version <version_num>` के माध्यम से एक विशिष्ट 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 दिशानिर्देशों के माध्यम से स्वागत योग्य हैं, लेकिन क्योंकि पुस्तक मुद्रित होती है और अनुरक्षक ऑनलाइन संस्करण को मुद्रण संस्करण के करीब रखने का लक्ष्य रखते हैं, संशोधन रस्ट Editions रिलीज़ों के आसपास बैच किए जाते हैं। उन बड़े संशोधनों के बीच, केवल कड़ी त्रुटि सुधारों को मर्ज किया जाता है, इसलिए गैर-त्रुटि पुल अनुरोधों को महीनों या वर्षों तक इंतज़ार करना पड़ सकता है। अनुवाद Translations लेबल के माध्यम से ट्रैक किए जाते हैं और नई भाषा के प्रयास issue के रूप में खोले जा सकते हैं, हालाँकि विलय mdBook की बहु-भाषा समर्थन की प्रतीक्षा करता है। `ci/spellcheck.sh` स्क्रिप्ट और `ci/dictionary.txt` शब्दकोश वर्तनी जाँच का समर्थन करते हैं, जिसमें गलत सकारात्मक (जैसे `BTreeMap` जैसे पहचानकर्ता) क्रमबद्ध क्रम में शब्दकोश में जोड़े जाते हैं। कुल मिलाकर, यह रनटाइम टूल के बजाय एक दस्तावेज़ीकरण और शैक्षिक परियोजना है: उपयोगकर्ताओं के लिए इसका मूल्य रस्ट के लिए आधिकारिक सीखने के संसाधन के रूप में है, जिसमें एक सुपरिभाषित निर्माण पाइपलाइन, कोड नमूनों के लिए परीक्षण प्रणाली, और एक संरचित योगदान और अनुवाद कार्यप्रवाह है।