कोड बेस खोजना

प्रॉडक्ट की खास जानकारी

Bazel का कोड खोजने और सोर्स ब्राउज़ करने वाला इंटरफ़ेस Bazel के सोर्स कोड के डेटा स्टोर करने की जगहों को ब्राउज़ करने के लिए, वेब पर आधारित एक टूल है. इन सुविधाओं का इस्तेमाल करके, अलग-अलग डेटा स्टोर करने की जगहों, ब्रांच, और फ़ाइलों के बीच नेविगेट किया जा सकता है. इसके अलावा, इतिहास, अंतर, और गड़बड़ी की जानकारी भी देखी जा सकती है.

शुरू करना

कोड खोजने और सोर्स ब्राउज़ करने वाले इंटरफ़ेस को ऐक्सेस करने के लिए, अपने वेब ब्राउज़र में https://source.bazel.build खोलें.

मुख्य स्क्रीन दिखती है. इस स्क्रीन में ये कॉम्पोनेंट शामिल होते हैं:

1. ब्रेडक्रंब टूलबार. यह टूलबार, डेटा स्टोर करने की जगह में आपकी मौजूदा जगह दिखाता है. साथ ही, इसकी मदद से किसी दूसरी जगह पर तेज़ी से जाया जा सकता है. जैसे, किसी दूसरी डेटा स्टोर करने की जगह या डेटा स्टोर करने की जगह में मौजूद कोई दूसरी जगह. जैसे, कोई फ़ाइल, ब्रांच या कमिट.

2. उन डेटा स्टोर करने की जगहों की सूची जिन्हें ब्राउज़ किया जा सकता है.

स्क्रीन पर सबसे ऊपर, एक खोज बॉक्स होता है. इस बॉक्स का इस्तेमाल करके, खास फ़ाइलें और कोड खोजे जा सकते हैं.

डेटा स्टोर करने की जगहों के साथ काम करना

डेटा स्टोर करने की जगह खोलना

डेटा स्टोर करने की जगह खोलने के लिए, मुख्य स्क्रीन पर उसके नाम पर क्लिक करें.

इसके अलावा, किसी खास डेटा स्टोर करने की जगह को ब्राउज़ करने के लिए, ब्रेडक्रंब टूलबार का इस्तेमाल किया जा सकता है. यह टूलबार, डेटा स्टोर करने की जगह में आपकी मौजूदा जगह दिखाता है. साथ ही, इसकी मदद से किसी दूसरी जगह पर तेज़ी से जाया जा सकता है. जैसे, किसी दूसरी डेटा स्टोर करने की जगह या डेटा स्टोर करने की जगह में मौजूद कोई दूसरी जगह. जैसे, कोई फ़ाइल, ब्रांच या कमिट.

डेटा स्टोर करने की जगहें बदलना

किसी दूसरी डेटा स्टोर करने की जगह पर स्विच करने के लिए, ब्रेडक्रंब टूलबार से वह डेटा स्टोर करने की जगह चुनें.

किसी खास कमिट पर डेटा स्टोर करने की जगह देखना

किसी खास कमिट पर डेटा स्टोर करने की जगह देखने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें.
2. ब्रेडक्रंब टूलबार में जाकर, ब्रांच मेन्यू खोलें.
3. इसके बाद दिखने वाले सब-मेन्यू में, कमिट पर क्लिक करें.
4. वह कमिट चुनें जिसे आपको देखना है.

अब इंटरफ़ेस, डेटा स्टोर करने की जगह को उस कमिट के हिसाब से दिखाता है.

कोई ब्रांच, कमिट या टैग खोलना

डिफ़ॉल्ट रूप से, कोड खोजने और सोर्स ब्राउज़ करने वाला इंटरफ़ेस, डेटा स्टोर करने की जगह को डिफ़ॉल्ट ब्रांच में खोलता है. कोई दूसरी ब्रांच खोलने के लिए, ब्रेडक्रंब टूलबार में जाकर, ब्रांच/कमिट/टैग मेन्यू पर क्लिक करें. इसके बाद, एक सब-मेन्यू खुलता है. इसमें ब्रांच का नाम, टैग का नाम या खोज बॉक्स का इस्तेमाल करके, कोई ब्रांच चुनी जा सकती है.

• ब्रांच का नाम इस्तेमाल करके कोई ब्रांच चुनने के लिए, ब्रांच चुनें. इसके बाद, ब्रांच के नाम पर क्लिक करें.
• टैग का नाम इस्तेमाल करके कोई ब्रांच चुनने के लिए, टैग चुनें. इसके बाद, टैग के नाम पर क्लिक करें.
• कमिट आईडी इस्तेमाल करके कोई ब्रांच चुनने के लिए, कमिट चुनें. इसके बाद, कमिट आईडी पर क्लिक करें.
• कोई ब्रांच, कमिट या टैग खोजने के लिए, उससे जुड़ा आइटम चुनें. इसके बाद, खोज बॉक्स में कोई शब्द टाइप करें.

फ़ाइलों के साथ काम करना

मुख्य स्क्रीन से कोई डेटा स्टोर करने की जगह चुनने पर, स्क्रीन बदलकर उस डेटा स्टोर करने की जगह का व्यू दिखाती है. अगर कोई README फ़ाइल मौजूद है, तो उसका कॉन्टेंट, स्क्रीन की दाईं ओर मौजूद फ़ाइल पैन में दिखता है. इसके अलावा, डेटा स्टोर करने की जगह की फ़ाइलों और फ़ोल्डर की सूची दिखती है. स्क्रीन की बाईं ओर, डेटा स्टोर करने की जगह की फ़ाइलों और फ़ोल्डर का ट्री व्यू दिखता है. इस ट्री का इस्तेमाल करके, खास फ़ाइलें ब्राउज़ और खोली जा सकती हैं.

ध्यान दें कि डेटा स्टोर करने की जगह देखते समय, ब्रेडक्रंब टूलबार में अब तीन कॉम्पोनेंट होते हैं:

• एक डेटा स्टोर करने की जगह मेन्यू. इससे अलग-अलग डेटा स्टोर करने की जगहें चुनी जा सकती हैं
• एक ब्रांच/कमिट/टैग मेन्यू. इससे खास ब्रांच, टैग या कमिट चुने जा सकते हैं
• एक फ़ाइल पाथ बॉक्स. इसमें मौजूदा फ़ाइल या फ़ोल्डर का नाम और उसका पाथ दिखता है

फ़ाइल खोलें

फ़ाइल की डायरेक्ट्री पर जाकर और उसे चुनकर, कोई फ़ाइल खोली जा सकती है. डेटा स्टोर करने की जगह का व्यू अपडेट हो जाता है. इसमें फ़ाइल पैन में फ़ाइल का कॉन्टेंट और ट्री पैन में डेटा स्टोर करने की जगह में उसकी जगह दिखती है.

फ़ाइल में किए गए बदलाव देखना

फ़ाइल में किए गए बदलाव देखने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, BLAME पर क्लिक करें.

फ़ाइल पैन अपडेट हो जाता है. इसमें यह दिखता है कि फ़ाइल में किसने और कब बदलाव किए.

बदलाव का इतिहास देखना

किसी फ़ाइल का बदलाव का इतिहास देखने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, HISTORY पर क्लिक करें. इसके बाद, बदलाव का इतिहास पैन दिखता है. इसमें इस फ़ाइल के लिए कमिट दिखते हैं.

कोड की समीक्षाएं देखना

Gerrit में कोड की समीक्षाओं के लिए, बदलाव के इतिहास वाले पैन से सीधे टूल खोला जा सकता है.

किसी फ़ाइल के लिए कोड की समीक्षा देखने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, HISTORY पर क्लिक करें. इसके बाद, बदलाव के इतिहास वाला पैन दिखता है. इसमें इस फ़ाइल के लिए कमिट दिखते हैं.
3. किसी कमिट पर कर्सर घुमाएं. ज़्यादा बटन (तीन वर्टिकल बिंदु) दिखता है.
4. ज़्यादा बटन पर क्लिक करें.
5. कोड की समीक्षा देखें चुनें.

Gerrit में कोड की समीक्षा करने वाला टूल, ब्राउज़र की नई विंडो में खुलता है.

किसी खास कमिट पर फ़ाइल खोलना

किसी खास कमिट पर फ़ाइल खोलने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, HISTORY पर क्लिक करें. इसके बाद, बदलाव के इतिहास वाला पैन दिखता है. इसमें इस फ़ाइल के लिए कमिट दिखते हैं.
3. किसी कमिट पर कर्सर घुमाएं. VIEW बटन दिखता है.
4. VIEW बटन पर क्लिक करें.

किसी फ़ाइल की तुलना किसी दूसरे कमिट से करना

किसी फ़ाइल की तुलना किसी दूसरे कमिट से करने के लिए:

1. डेटा स्टोर करने की जगह के व्यू में जाकर, फ़ाइल चुनें. दो अलग-अलग कमिट से तुलना करने के लिए, पहले उस कमिट पर फ़ाइल खोलें.
2. किसी कमिट पर कर्सर घुमाएं. DIFF बटन दिखता है.
3. DIFF बटन पर क्लिक करें.

फ़ाइल पैन अपडेट हो जाता है. इसमें दोनों फ़ाइलों की साइड-बाइ-साइड तुलना दिखती है. दोनों कमिट में से पुराना कमिट हमेशा बाईं ओर दिखता है.

बदलाव के इतिहास वाले पैन में, दोनों कमिट हाइलाइट किए जाते हैं. साथ ही, एक लेबल से यह पता चलता है कि कमिट बाईं ओर दिख रहा है या दाईं ओर.

किसी भी फ़ाइल को बदलने के लिए, बदलाव के इतिहास वाले पैन में कमिट पर कर्सर घुमाएं. इसके बाद, बाईं ओर या दाईं ओर बटन पर क्लिक करें. इससे कमिट, अंतर के बाईं या दाईं ओर खुलेगा.

क्रॉस रेफ़रंस ब्राउज़ करना

सोर्स के डेटा स्टोर करने की जगहों को ब्राउज़ करने का एक और तरीका है, क्रॉस रेफ़रंस का इस्तेमाल करना. ये रेफ़रंस, दिए गए सोर्स फ़ाइल में हाइपरलिंक के तौर पर अपने-आप दिखते हैं.

क्रॉस रेफ़रंस को आसानी से पहचानने के लिए, सबसे ऊपर दाएं कोने में मौजूद, क्रॉस रेफ़रंस, पर क्लिक करें. इस विकल्प से, किसी फ़ाइल में मौजूद सभी क्रॉस रेफ़रंस के नीचे एक अंडरलाइन दिखती है.

ध्यान दें: अगर क्रॉस रेफ़रंस विकल्प धुंधला दिखता है, तो इसका मतलब है कि उस फ़ाइल के लिए क्रॉस रेफ़रंस उपलब्ध नहीं हैं.

क्रॉस रेफ़रंस वाला पैन खोलने के लिए, किसी क्रॉस रेफ़रंस पर क्लिक करें. इस पैन में दो सेक्शन होते हैं:

• एक डेफ़िनिशन सेक्शन. इसमें वह फ़ाइल या वे फ़ाइलें दिखती हैं जिनमें रेफ़रंस की डेफ़िनिशन दी गई है
• एक रेफ़रंस सेक्शन. इसमें वे फ़ाइलें दिखती हैं जिनमें रेफ़रंस भी दिखता है

दोनों सेक्शन में, फ़ाइल का नाम और वह लाइन या वे लाइनें दिखती हैं जिनमें रेफ़रंस मौजूद है. क्रॉस रेफ़रंस वाले पैन से कोई फ़ाइल खोलने के लिए, लाइन नंबर वाली एंट्री पर क्लिक करें. फ़ाइल, पैन के नए सेक्शन में दिखती है. इससे ओरिजनल फ़ाइल को व्यू में रखते हुए, फ़ाइल को ब्राउज़ किया जा सकता है.

क्रॉस रेफ़रंस वाले पैन का इस्तेमाल करके, क्रॉस रेफ़रंस ब्राउज़ किए जा सकते हैं. ठीक उसी तरह जैसे फ़ाइल पैन में किए जाते हैं. ऐसा करने पर, पैन में ब्रेडक्रंब ट्रेल दिखता है. इसका इस्तेमाल करके, अलग-अलग क्रॉस रेफ़रंस के बीच नेविगेट किया जा सकता है.

कोड खोजना

स्क्रीन पर सबसे ऊपर मौजूद खोज बॉक्स का इस्तेमाल करके, खास फ़ाइलें या कोड स्निपेट खोजे जा सकते हैं. खोजें हमेशा डिफ़ॉल्ट ब्रांच के हिसाब से होती हैं.

सभी खोजों में, RE2 रेगुलर एक्सप्रेशन का इस्तेमाल डिफ़ॉल्ट रूप से किया जाता है. अगर रेगुलर एक्सप्रेशन का इस्तेमाल नहीं करना है, तो खोज के लिए शब्द को डबल कोट ( " ) में डालें.

ध्यान दें: किसी खास फ़ाइल को तेज़ी से खोजने के लिए, या तो पीरियड से पहले बैकस्लैश जोड़ें या फ़ाइल के पूरे नाम को कोट में डालें.

foo\.java
"foo.java"

अपनी खोज को सटीक बनाने के लिए, ये फ़िल्टर इस्तेमाल किए जा सकते हैं.

अन्य सहायता

किसी समस्या की शिकायत करने के लिए, स्क्रीन के सबसे ऊपर दाएं कोने में दिखने वाले सुझाव/राय दें या शिकायत करें बटन पर क्लिक करें. इसके बाद, दिए गए फ़ॉर्म में अपनी राय या शिकायत दर्ज करें.