Dannex Download Manager
  1. होम
  2. योगदान देना

Dannex Download Manager में योगदान दें

बग रिपोर्ट, विचार, अनुवाद सुधार और पुल रिक्वेस्ट सभी का स्वागत है। सब कुछ GitHub पर खुले में होता है।

सेटअप करना

आपको Windows 10 या 11 और Rust stable 1.98 या बाद का संस्करण (MSVC टूलचेन), और BoringSSL के लिए CMake, LLVM और NASM की आवश्यकता होगी, जिसे इंजन का ब्राउज़र-जैसा कनेक्शन स्रोत से बनाता है (winget install Kitware.CMake LLVM.LLVM NASM.NASM)।

cargo build
cargo run -p mdm-app

अपने खुद के डाउनलोड को छुए बिना बदलावों को आज़माने के लिए, ऐप को एक अलग डेटा फ़ोल्डर दें:

set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app

cargo run -p mdm-labserver -- --faults "rate=2M"एक स्थानीय टेस्ट सर्वर शुरू करता है, जो आपके बताए अनुसार समस्याओं वाली जनरेट की गई फ़ाइलें उपलब्ध कराता है (धीमे कनेक्शन, कनेक्शन कटना, व्यस्त जवाब, रेंज का न होना; GET / इनकी सूची दिखाता है), ताकि इंटरनेट के बिना डाउनलोड की जाँच की जा सके।

पुल रिक्वेस्ट खोलने से पहले

CI ये जाँचें चलाता है; हर जाँच एक नए क्लोन पर काम करती है:

cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
python tools/i18n/extract.py      # then: git diff --exit-code i18n/en.tsv
node tools/extension/test.mjs

बदलावों को केंद्रित रखें और उनके आसपास के कोड से मेल खाएं। कुछ नियम हर जगह लागू होते हैं:

अनुवाद

इंटरफ़ेस हर उस भाषा में है जो Windows 11 प्रदान करता है। i18n/ में कैटलॉग मशीन अनुवाद द्वारा बनाए गए थे, और #, machine के रूप में चिह्नित प्रत्येक पंक्ति एक मूल वक्ता का इंतजार कर रही है:

  1. i18n/<code>.tsv खोलें (कोड i18n/languages.tsv में हैं)।
  2. पंक्ति के तीसरे कॉलम में अनुवाद को ठीक करें और उसकी #, machine लाइन को हटा दें।
  3. {placeholders} और एक & (कीबोर्ड शॉर्टकट अक्षर) को वैसे ही रखें जैसे वे हैं।

एक पंक्ति जिसमें #, machine लाइन नहीं है, वह तब से आपकी है: tools/i18n/translate.py इसे फिर कभी मशीन अनुवाद पर नहीं भेजता है, और CI (tools/i18n/reviewed_guard.py) किसी भी पुल अनुरोध को विफल कर देता है जो इसे हटाता है या इसे फिर से #, machine चिह्नित करता है।

cargo test -p mdm-app every_catalogहर कैटलॉग की जाँच करता है। यह देखने के लिए कि आपके टेक्स्ट फिट होते हैं या नहीं, MDM_FIT_AUDIT को एक फ़ाइल पर सेट करें और अपनी भाषा में स्क्रीनशॉट लें (tools\lab\docs-shots.ps1 ... -Lang <code>): हर टेक्स्ट जो अपनी विंडो से आगे या दूसरे पर चलता है, वहाँ सूचीबद्ध होता है। भाषा सूची, इंस्टॉलर और दाएं से बाएं लेआउट कैसे एक साथ फिट होते हैं, इसके लिए भाषाएँ देखें।

यह वेबसाइट भी 21 भाषाओं में है, जो मशीन-अनुवादित भी है। इसके टेक्स्ट i18n/site/<code>.json में हैं, प्रति वाक्य एक पंक्ति: एक पंक्ति के "text" को ठीक करें (टैग जैसे <g1>…</g1> और <x2/> को वैसे ही रखें, वे लिंक और आइकन हैं)। python tools/website/translate_site.py --status दिखाता है कि प्रत्येक भाषा में अभी भी क्या कमी है, और --langs <code> के साथ वही टूल केवल उसी का अनुवाद करता है।

समस्याओं की रिपोर्ट करना

ऐप में सहायता → एक समस्या की रिपोर्ट करें का उपयोग करें: यह आपके संस्करण, सिस्टम, DDM कैसे स्थापित किया गया था और उसकी भाषा भरी हुई बग रिपोर्ट फ़ॉर्म खोलता है। जब आप इसे स्वयं खोलते हैं तो फ़ॉर्म वही पूछता है। सुरक्षा समस्याएँ: SECURITY.md देखें।

पुल रिक्वेस्ट प्रोजेक्ट के लाइसेंस, GNU GPL, संस्करण 3 या बाद के के तहत स्वीकार किए जाते हैं।