कोड बेस खोजना

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

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

शुरू करना

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

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

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

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

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

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

किसी रिपॉज़िटरी को खोलना

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

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

रिपॉज़िटरी स्विच करना

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

किसी खास कमिट पर कोई रिपॉज़िटरी देखना

किसी खास कमिट पर कोई रिपॉज़िटरी देखने के लिए:

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

अब इंटरफ़ेस में, रिपॉज़िटरी को उस कमिट के हिसाब से दिखाया जाता है.

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

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

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

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

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

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

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

फ़ाइल खोलें

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• डेफ़िनिशन सेक्शन, जिसमें ऐसी फ़ाइल या फ़ाइलों की सूची होती है जो रेफ़रंस तय करती हैं
• संदर्भ सेक्शन, जिसमें उन फ़ाइलों की सूची होती है जिनमें संदर्भ भी दिखता है

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

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

कोड खोजा जा रहा है

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

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

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

foo\.java
"foo.java"

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

अन्य सहायता

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