ภาพรวมผลิตภัณฑ์
อินเทอร์เฟซการค้นหาโค้ดและการเรียกดูแหล่งที่มา ของ Bazel เป็นเครื่องมือบนเว็บสำหรับการเรียกดูที่เก็บซอร์สโค้ดของ Bazel คุณสามารถใช้ฟีเจอร์เหล่านี้เพื่อไปยังส่วนต่างๆ ของที่เก็บ สาขา และไฟล์ รวมถึงดูประวัติ การเปรียบเทียบ และข้อมูลการระบุผู้เขียนโค้ด
เริ่มต้นใช้งาน
หากต้องการเข้าถึงอินเทอร์เฟซการค้นหาโค้ดและการเรียกดูแหล่งที่มา ให้เปิด https://source.bazel.build ในเว็บเบราว์เซอร์
หน้าจอหลักจะปรากฏขึ้น ซึ่งประกอบด้วยคอมโพเนนต์ต่อไปนี้
แถบเครื่องมือเบรดครัมบ์ แถบเครื่องมือนี้จะแสดงตำแหน่งปัจจุบันของคุณในที่เก็บและช่วยให้คุณย้ายไปยังตำแหน่งอื่นได้อย่างรวดเร็ว เช่น ที่เก็บอื่น หรือตำแหน่งอื่นภายในที่เก็บ เช่น ไฟล์ Branch หรือคอมมิต
รายการที่เก็บที่คุณเรียกดูได้
ช่องค้นหาจะอยู่ที่ด้านบนของหน้าจอ คุณสามารถใช้ช่องนี้เพื่อค้นหาไฟล์และโค้ดที่เฉพาะเจาะจงได้
การทำงานกับที่เก็บ
การเปิดที่เก็บ
หากต้องการเปิดที่เก็บ ให้คลิกชื่อที่เก็บจากหน้าจอหลัก
หรือจะใช้แถบเครื่องมือเบรดครัมบ์เพื่อเรียกดูที่เก็บที่เฉพาะเจาะจงก็ได้ แถบเครื่องมือนี้จะแสดงตำแหน่งปัจจุบันของคุณในที่เก็บและช่วยให้คุณย้ายไปยังตำแหน่งอื่นได้อย่างรวดเร็ว เช่น ที่เก็บอื่น หรือตำแหน่งอื่นภายในที่เก็บ เช่น ไฟล์ Branch หรือคอมมิต
เปลี่ยนที่เก็บ
หากต้องการเปลี่ยนไปใช้ที่เก็บอื่น ให้เลือกที่เก็บจากแถบเครื่องมือเบรดครัมบ์
ดูที่เก็บที่การคอมมิตที่เฉพาะเจาะจง
วิธีดูที่เก็บที่การคอมมิตที่เฉพาะเจาะจง
- เลือกไฟล์จากมุมมองของที่เก็บ
- จากแถบเครื่องมือเบรดครัมบ์ เปิดเมนูสาขา
- คลิกการคอมมิต ในเมนูย่อยที่ปรากฏขึ้น
- เลือกการคอมมิตที่ต้องการดู
ตอนนี้อินเทอร์เฟซจะแสดงที่เก็บตามที่ปรากฏในการคอมมิตนั้น
เปิดสาขา การคอมมิต หรือแท็ก
โดยค่าเริ่มต้น อินเทอร์เฟซ Code Search และการเรียกดูแหล่งที่มาจะเปิดที่เก็บไปยังสาขาเริ่มต้น หากต้องการเปิด Branch อื่น ให้คลิกเมนูBranch/การคอมมิต/แท็ก จากแถบเครื่องมือเบรดครัมบ์ เมนูย่อยจะเปิดขึ้นเพื่อให้คุณเลือกสาขาโดยใช้ชื่อสาขา ชื่อแท็ก หรือผ่านช่องค้นหา
- หากต้องการเลือกสาขาโดยใช้ชื่อสาขา ให้เลือกสาขา แล้วคลิกชื่อสาขา
- หากต้องการเลือกสาขาโดยใช้ชื่อแท็ก ให้เลือกแท็ก แล้วคลิกชื่อแท็ก
- หากต้องการเลือก Branch โดยใช้รหัสคอมมิต ให้เลือกคอมมิต แล้วคลิกรหัสคอมมิต
- หากต้องการค้นหาสาขา การคอมมิต หรือแท็ก ให้เลือกรายการที่เกี่ยวข้องแล้วพิมพ์ข้อความค้นหาในช่องค้นหา
การทำงานกับไฟล์
เมื่อคุณเลือกที่เก็บจากหน้าจอหลัก หน้าจอจะเปลี่ยนไปแสดงมุมมองของที่เก็บนั้น หากมีไฟล์ README อยู่ เนื้อหาของไฟล์จะปรากฏในบานหน้าต่างไฟล์ที่อยู่ทางด้านขวาของหน้าจอ หากไม่มี รายการไฟล์และโฟลเดอร์ของที่เก็บจะปรากฏขึ้น ส่วนด้านซ้ายของหน้าจอจะเป็นมุมมองแบบต้นไม้ของไฟล์และโฟลเดอร์ของที่เก็บ คุณสามารถใช้มุมมองนี้เพื่อเรียกดูและเปิดไฟล์ที่เฉพาะเจาะจงได้
โปรดทราบว่าเมื่อคุณกำลังดูที่เก็บ แถบเครื่องมือเบรดครัมบ์จะมีคอมโพเนนต์ 3 รายการดังนี้
- เมนูที่เก็บ ซึ่งคุณสามารถเลือกที่เก็บต่างๆ ได้
- เมนูBranch/คอมมิต/แท็ก ซึ่งคุณสามารถเลือก Branch แท็ก หรือคอมมิตที่เฉพาะเจาะจงได้
- ช่องเส้นทางไฟล์ ซึ่งแสดงชื่อไฟล์หรือโฟลเดอร์ปัจจุบันและเส้นทางที่เกี่ยวข้อง
เปิดไฟล์
คุณสามารถเปิดไฟล์ได้โดยเรียกดูไดเรกทอรีของไฟล์แล้วเลือกไฟล์นั้น มุมมองของที่เก็บจะอัปเดตเพื่อแสดงเนื้อหาของไฟล์ในแผงไฟล์ และตำแหน่งของไฟล์ในที่เก็บในแผงแบบต้นไม้
ดูการเปลี่ยนแปลงไฟล์
วิธีดูการเปลี่ยนแปลงไฟล์
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิก BLAME ที่มุมขวาบน
บานหน้าต่างไฟล์จะอัปเดตเพื่อแสดงผู้ที่ทำการเปลี่ยนแปลงไฟล์และเวลาที่ทำการเปลี่ยนแปลง
ดูประวัติการเปลี่ยนแปลง
วิธีดูประวัติการเปลี่ยนแปลงของไฟล์
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิก HISTORY ที่มุมขวาบน บานหน้าต่างประวัติการเปลี่ยนแปลง จะปรากฏขึ้นเพื่อแสดงการคอมมิตของไฟล์นี้
ดูการตรวจสอบโค้ด
สำหรับการตรวจสอบโค้ด Gerrit คุณสามารถเปิดเครื่องมือได้โดยตรงจากบานหน้าต่างประวัติการเปลี่ยนแปลง
วิธีดูการตรวจสอบโค้ดของไฟล์
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิก HISTORY ที่มุมขวาบน บานหน้าต่างประวัติการเปลี่ยนแปลงจะปรากฏขึ้นเพื่อแสดงการคอมมิตของไฟล์นี้
- วางเมาส์เหนือการคอมมิต ปุ่มเพิ่มเติม (จุด 3 จุดแนวตั้ง) จะปรากฏขึ้น
- คลิกปุ่มเพิ่มเติม
- เลือกดูการตรวจสอบโค้ด
เครื่องมือการตรวจสอบโค้ด Gerrit จะเปิดขึ้นในหน้าต่างเบราว์เซอร์ใหม่
เปิดไฟล์ที่การคอมมิตที่เฉพาะเจาะจง
วิธีเปิดไฟล์ที่การคอมมิตที่เฉพาะเจาะจง
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิก HISTORY ที่มุมขวาบน บานหน้าต่างประวัติการเปลี่ยนแปลงจะปรากฏขึ้นเพื่อแสดงการคอมมิตของไฟล์นี้
- วางเมาส์เหนือการคอมมิต ปุ่มดู จะปรากฏขึ้น
- คลิกปุ่มดู
เปรียบเทียบไฟล์กับการคอมมิตอื่น
วิธีเปรียบเทียบไฟล์ที่การคอมมิตอื่น
- เลือกไฟล์จากมุมมองของที่เก็บ หากต้องการเปรียบเทียบจากการคอมมิต 2 รายการที่แตกต่างกัน ให้เปิดไฟล์ที่การคอมมิตนั้นก่อน
- วางเมาส์เหนือการคอมมิต ปุ่ม DIFF จะปรากฏขึ้น
- คลิกปุ่ม DIFF
บานหน้าต่างไฟล์จะอัปเดตเพื่อแสดงการเปรียบเทียบไฟล์ 2 ไฟล์แบบเคียงข้างกัน การคอมมิตที่เก่ากว่าจะอยู่ทางด้านซ้ายเสมอ
ในบานหน้าต่างประวัติการเปลี่ยนแปลง การคอมมิตทั้ง 2 รายการจะไฮไลต์ไว้ และป้ายกำกับจะระบุว่าการคอมมิตแสดงอยู่ทางด้านซ้ายหรือด้านขวา
หากต้องการเปลี่ยนไฟล์ใดไฟล์หนึ่ง ให้วางเมาส์เหนือการคอมมิตในบานหน้าต่างประวัติการเปลี่ยนแปลง จากนั้นคลิกปุ่มซ้าย หรือขวา เพื่อให้การคอมมิตเปิดขึ้นทางด้านซ้ายหรือด้านขวาของการเปรียบเทียบ
การเรียกดูการตรวจสอบแบบอ้างอิง
อีกวิธีหนึ่งในการเรียกดูที่เก็บแหล่งที่มาคือการใช้การตรวจสอบแบบอ้างอิง การอ้างอิงเหล่านี้จะปรากฏเป็นไฮเปอร์ลิงก์ภายในไฟล์แหล่งที่มาที่กำหนดโดยอัตโนมัติ
หากต้องการระบุการตรวจสอบแบบอ้างอิงได้ง่ายขึ้น ให้คลิก การตรวจสอบแบบอ้างอิง, ที่มุมขวาบน ตัวเลือกนี้จะแสดงเส้นใต้การตรวจสอบแบบอ้างอิงทั้งหมดในไฟล์
หมายเหตุ: หากการตรวจสอบแบบอ้างอิง เป็นสีเทา แสดงว่าการตรวจสอบแบบอ้างอิงไม่พร้อมใช้งานสำหรับไฟล์นั้น
คลิกการตรวจสอบแบบอ้างอิงเพื่อเปิดบานหน้าต่างการตรวจสอบแบบอ้างอิง บานหน้าต่างนี้มี 2 ส่วน ได้แก่
- ส่วนคำจำกัดความ ซึ่งแสดงรายการไฟล์ที่กำหนดการอ้างอิง
- ส่วนการอ้างอิง ซึ่งแสดงรายการไฟล์ที่การอ้างอิงปรากฏขึ้นด้วย
ทั้ง 2 ส่วนจะแสดงชื่อไฟล์ รวมถึงบรรทัดหรือบรรทัดที่มีการอ้างอิง หากต้องการเปิดไฟล์จากบานหน้าต่างการตรวจสอบแบบอ้างอิง ให้คลิกรายการหมายเลขบรรทัด ไฟล์จะปรากฏในส่วนใหม่ของบานหน้าต่าง ซึ่งช่วยให้คุณเรียกดูไฟล์ต่อไปได้ในขณะที่ยังคงแสดงไฟล์ต้นฉบับไว้
คุณสามารถเรียกดูการตรวจสอบแบบอ้างอิงต่อได้โดยใช้บานหน้าต่างการตรวจสอบแบบอ้างอิง เช่นเดียวกับในบานหน้าต่างไฟล์ เมื่อคุณทำเช่นนั้น บานหน้าต่างจะแสดงเส้นทางเบรดครัมบ์ ซึ่งคุณสามารถใช้เพื่อไปยังส่วนต่างๆ ของการตรวจสอบแบบอ้างอิง
การค้นหาโค้ด
คุณสามารถค้นหาไฟล์หรือข้อมูลโค้ดที่เฉพาะเจาะจงได้โดยใช้ช่องค้นหาที่ด้านบนของหน้าจอ การค้นหาจะดำเนินการกับสาขาเริ่มต้นเสมอ
การค้นหาทั้งหมดจะใช้ นิพจน์ทั่วไป RE2 โดยค่าเริ่มต้น หากไม่ต้องการใช้นิพจน์ทั่วไป ให้ใส่ข้อความค้นหาในเครื่องหมายคำพูดคู่ ( ")
หมายเหตุ: หากต้องการค้นหาไฟล์ที่เฉพาะเจาะจงอย่างรวดเร็ว ให้เพิ่มแบ็กสแลชไว้หน้าจุด หรือใส่ชื่อไฟล์ทั้งหมดในเครื่องหมายคำพูด
foo\.java
"foo.java"
คุณสามารถปรับแต่งการค้นหาได้โดยใช้ตัวกรองต่อไปนี้
| กรอง | ตัวเลือกอื่นๆ | คำอธิบาย | ตัวอย่าง |
|---|---|---|---|
| lang: | ภาษา: | ทำการค้นหาที่ตรงกันทุกประการตามภาษาของไฟล์ | lang:java test |
| ไฟล์: | filepath: path: f: |
||
| case:yes | ทำการค้นหาที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ โดยค่าเริ่มต้น การค้นหาจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ | case:yes Hello World | |
| class: | ค้นหาชื่อคลาส | class:MainClass | |
| function: | func: | ค้นหาชื่อฟังก์ชัน | function:print |
| - | ยกเลิกคำจากข้อความค้นหา | hello -world | |
| Example Source: This is a test Example Translation: Dies ist ein Test Source: This is a test with another placeholder Translation: Dies ist ein Test mit einem anderen Platzhalter | ไม่ใช้อักขระพิเศษ เช่น ., \ หรือ ( | run\(\) | |
| "[term]" | ทำการค้นหาแบบตรงตัว | "class:main" |
การสนับสนุนเพิ่มเติม
หากต้องการรายงานปัญหา ให้คลิกปุ่มความคิดเห็น ที่ปรากฏที่มุมขวาบนของหน้าจอ แล้วป้อนความคิดเห็นในแบบฟอร์มที่ให้ไว้