दस्तावेज़ीकरण और सहायता मॉड्यूल

कुछ मॉड्यूल वास्तव में आपको कुछ भी करने की आवश्यकता नहीं रखते — वे केवल बैकग्राउंड में वही करते हैं, जो उन्हें करना होता है। हालांकि, ऐसे मॉड्यूल आमतौर पर किसी भी कॉन्फ़िगरेशन विकल्प के साथ नहीं आते, या केवल उन मॉड्यूलों के लिए आवश्यक होते हैं जो उन पर निर्भर हैं।

अक्सर, वह मॉड्यूल जिसमें आपकी रुचि होती है, वह होता है जिसके लिए आप अनुमतियाँ और सेटिंग्स कॉन्फ़िगर कर सकते हैं। कुछ प्रोजेक्ट इतने सहज होते हैं कि उनका उपयोग “इंट्यूटिव” होता है — यानी आपको तुरंत समझ में आ जाएगा कि आप क्या बदल सकते हैं और कैसे उपयोग कर सकते हैं।

यदि आप यह जानना चाहते हैं कि आपने जो नया मॉड्यूल इंस्टॉल किया है उसका बुद्धिमत्तापूर्ण उपयोग कैसे करें, तो मैं कुछ स्थानों या संसाधनों की सिफारिश कर सकता हूँ जहाँ आप देख सकते हैं।

निम्नलिखित सुझाव उपयोग में सरलता के क्रम में व्यवस्थित हैं।

दुर्भाग्य से, हमारे जैसे शुरुआती उपयोगकर्ताओं के लिए Drupal लगातार विकसित हो रहा है। हमें डेवलपर्स के विशाल परिश्रम का लाभ निःशुल्क मिलता है, लेकिन उनका समय सीमित होता है। और यह कहना उचित है कि सर्वश्रेष्ठ डेवलपर्स आमतौर पर शुरुआती लोगों के लिए दस्तावेज़ लिखने में बहुत परिश्रमी नहीं होते — अन्यथा, आप और मैं यहाँ नहीं होते।

मैं आपको सलाह दूँगा कि जब आप Drupal सीख रहे हों, तो अपने अनुभवों और कठिनाइयों को दस्तावेज़ करें और साझा करें — ताकि आने वाले दिनों, महीनों और वर्षों में हजारों अन्य लोगों को इसका लाभ मिल सके।

मैं इस दस्तावेज़ीकरण को बनाने की चुनौती को स्वीकार करता हूँ, भले ही इसमें अंतहीन झुंझलाहट और निराशा शामिल हो — क्योंकि नए Drupal दस्तावेज़ अनुभाग का उपयोग करना आसान नहीं है। फिर भी, मुझे खुशी है कि आप, मेरे मित्र, इससे लाभान्वित होंगे।

आपको (और मुझे भी) “डेवलपमेंट” या प्रोग्रामिंग के बारे में कुछ भी जानने की आवश्यकता नहीं है ताकि आप जो कुछ भी सीखे हैं, उसे साझा कर सकें।

प्रयोग और त्रुटि की विधि

आप सीधे मॉड्यूल का उपयोग शुरू कर सकते हैं या उसकी सेटिंग्स से खेल सकते हैं।

यदि किसी विकल्प का कार्य स्पष्ट नहीं है या उसके परिणाम समझ में नहीं आते, तो आप अपने अनुभव और समझ के आधार पर उसे आज़मा सकते हैं।

किसी भी समय जब कोई मॉड्यूल अनुमान पर निर्भर करता है, तो चिंता न करें — क्योंकि आपकी साइट का बैकअप हमेशा आपको पुराने संस्करण पर लौटने में मदद करेगा। (आप अपनी साइट का बैकअप लेते हैं, है ना?)

कभी-कभी किसी मॉड्यूल या उसकी किसी विशेष सेटिंग का प्रभाव तुरंत स्पष्ट नहीं होता। इसलिए मैं सलाह देता हूँ कि एक समय में केवल एक ही मॉड्यूल इंस्टॉल करें और अपनी साइट के सभी हिस्सों का परीक्षण करें — नई पेज बनाकर और विभिन्न कॉन्फ़िगरेशन आज़माकर — इससे पहले कि आप अगला contrib मॉड्यूल जोड़ें।

अन्यथा, यदि आप एक से अधिक नए मॉड्यूल सक्षम करते हैं और किसी समस्या या अजीब व्यवहार का सामना करते हैं, तो आपको पता नहीं चलेगा कि कौन सा मॉड्यूल इसका कारण है।

प्रोजेक्ट पेज की सामग्री

प्रत्येक मॉड्यूल का प्रोजेक्ट पेज drupal.org पर उसका होमपेज होता है। जब मैं किसी मॉड्यूल को आज़माने या समस्या हल करने के बारे में सोचता हूँ, तो सबसे पहले मैं इसी पेज पर जाता हूँ।

यदि आप प्रोजेक्ट पेज को ध्यानपूर्वक पढ़ते हैं, तो आपको वह सारी आवश्यक जानकारी मिल जाएगी जो आपको चाहिए। उदाहरण के लिए, यदि किसी मॉड्यूल को अन्य मॉड्यूलों की आवश्यकता है, तो वे आमतौर पर प्रोजेक्ट पेज पर सूचीबद्ध होते हैं।

प्रोजेक्ट पेज पर उस मॉड्यूल से संबंधित अन्य उपयोगी लिंक भी हो सकते हैं।

प्रोजेक्ट पेज की सामग्री कभी शुरुआती उपयोगकर्ताओं के लिए होती है, तो कभी उन्नत उपयोगकर्ताओं या डेवलपर्स के लिए।

“दस्तावेज़ पढ़ें” लिंक (यदि उपलब्ध हो)

दाएँ कॉलम में (या मोबाइल पर पेज के निचले हिस्से में), आपको “संसाधन” शीर्षक मिलेगा, जिसके तहत कभी-कभी “दस्तावेज़ पढ़ें” लिंक होता है।

हालांकि, सभी प्रोजेक्ट पेजों में यह लिंक नहीं होता। ऐसे मामलों में उम्मीद है कि मुख्य पृष्ठ पर अन्य उपयोगी दस्तावेज़ लिंक उपलब्ध होंगे।

जब “दस्तावेज़ पढ़ें” लिंक होता है, तो यह वही संसाधन होता है जिसे डेवलपर्स ने अनुशंसित किया है।

प्रोजेक्ट पेज की सामग्री इसके निर्माता या उन व्यक्तियों द्वारा नियंत्रित होती है जिन्हें निर्माता ने अनुमति दी है।

अन्य drupal.org उपयोगकर्ता भी उपयोगी पृष्ठ बनाते हैं, लेकिन वे आमतौर पर प्रोजेक्ट पेज पर लिंक नहीं किए जाते।

उन अतिरिक्त पृष्ठों को खोजने के लिए, नीचे बताए गए drupal.org तक सीमित Google खोज विधि का उपयोग करें।

मॉड्यूल की “README.txt” फ़ाइल

“README.txt” ऐतिहासिक रूप से वह स्थान है जहाँ किसी मॉड्यूल (या थीम) से संबंधित सभी महत्वपूर्ण जानकारी दर्ज होती है — जैसे अपडेट निर्देश और आवश्यक निर्भरताएँ।

README.txt फ़ाइल किसी contrib मॉड्यूल (या थीम) की रूट डायरेक्टरी में होती है, यदि वह मौजूद है।

README.txt देखने के लिए (कुछ डाउनलोड किए बिना), इस लिंक का उपयोग करें:

http://cgit.drupalcode.org/project/PROJECT_MACHINE_NAME.git/blob/HEAD:/README.txt

ऊपर दिए गए URL में PROJECT_MACHINE_NAME को संबंधित प्रोजेक्ट के मशीन नाम से बदलें।

“मशीन नाम” आप प्रोजेक्ट पेज के URL में देख सकते हैं, उदाहरण के लिए:

https://www.drupal.org/project/PROJECT_MACHINE_NAME

यदि README.txt मौजूद नहीं है, तो इसका अर्थ है कि मॉड्यूल बैकग्राउंड में चलता है और किसी कॉन्फ़िगरेशन की आवश्यकता नहीं होती।

यदि README.txt उपलब्ध नहीं है या आप अधिक दस्तावेज़ देखना चाहते हैं, तो यह URL उपयोग करें:

http://cgit.drupalcode.org/PROJECT_MACHINE_NAME/tree/?id=HEAD

पृष्ठ के ऊपरी दाएँ कोने में, आप अपनी Drupal कोर वर्ज़न चुन सकते हैं।

drupal.org तक सीमित Google खोज

यदि आप केवल drupal.org साइट पर खोज करना चाहते हैं, तो Google में इस तरह टाइप करें:

site:drupal.org

ध्यान दें — “:” के बाद कोई स्पेस नहीं होना चाहिए, और “www.” का उपयोग न करें।

इसके बाद स्पेस दें और मॉड्यूल का नाम या संबंधित कीवर्ड टाइप करें।

केवल Drupal 8 से संबंधित परिणाम प्राप्त करने के लिए, “Drupal 8” को उद्धरण चिह्नों (“”) में लिखें। इससे Google केवल उन्हीं पृष्ठों को दिखाएगा जिनमें सटीक वाक्यांश होगा।

यदि आप drupal.org के बाहर भी जानकारी खोजना चाहते हैं, तो site:drupal.org हटा दें।

एक पेज पर 100 Google परिणाम प्राप्त करने के लिए, किसी भी परिणाम पेज पर दाएँ ऊपर गियर आइकन पर क्लिक करें → “सर्च सेटिंग्स” खोलें → “Google Instant” को बंद करें और “Results per page” स्लाइडर को सबसे दाएँ खींचें।

आप सोच सकते हैं कि drupal.org की अपनी सर्च बार उपयोगी होगी, लेकिन व्यावहारिक रूप से वह उतनी प्रभावी नहीं है — आप स्वयं आज़मा सकते हैं।

आपकी साइट के “एक्सटेंड” पेज पर “सहायता” लिंक (यदि उपलब्ध हों)