ภาพรวมผลิตภัณฑ์
อินเทอร์เฟซการค้นหาโค้ดและการเรียกดูต้นฉบับของ Bazel เป็นเครื่องมือบนเว็บสำหรับเรียกดูที่เก็บซอร์สโค้ดของ Bazel คุณจะใช้ฟีเจอร์เหล่านี้เพื่อไปยังส่วนต่างๆ ของที่เก็บ สาขา และไฟล์ต่างๆ ได้ นอกจากนี้ คุณยังดูประวัติ ความแตกต่าง และข้อมูลโทษได้ด้วย
เริ่มต้นใช้งาน
หากต้องการเข้าถึงอินเทอร์เฟซการค้นหาโค้ดและการเรียกดูแหล่งที่มา ให้เปิด https://source.bazel.build ในเว็บเบราว์เซอร์
หน้าจอหลักจะปรากฏขึ้น หน้าจอนี้ประกอบด้วยองค์ประกอบต่อไปนี้
แถบเครื่องมือเบรดครัมบ์ แถบเครื่องมือนี้จะแสดงตำแหน่งปัจจุบันของคุณในที่เก็บและช่วยให้คุณย้ายไปยังตำแหน่งอื่นได้อย่างรวดเร็ว เช่น ที่เก็บอื่น หรือตำแหน่งอื่นภายในที่เก็บ เช่น ไฟล์ สาขา หรือคอมมิต
รายการที่เก็บที่คุณเรียกดูได้
ด้านบนของหน้าจอจะเป็นช่องค้นหา คุณสามารถใช้ช่องนี้เพื่อค้นหา ไฟล์และโค้ดที่ต้องการได้
การทำงานกับที่เก็บ
การเปิดที่เก็บ
หากต้องการเปิดที่เก็บ ให้คลิกชื่อที่เก็บจากหน้าจอหลัก
หรือจะใช้แถบเครื่องมือเบรดครัมบ์เพื่อเรียกดูที่เก็บเฉพาะก็ได้ แถบเครื่องมือนี้จะแสดงตำแหน่งปัจจุบันของคุณในที่เก็บและช่วยให้คุณย้ายไปยังตำแหน่งอื่นได้อย่างรวดเร็ว เช่น ที่เก็บอื่น หรือตำแหน่งอื่นภายในที่เก็บ เช่น ไฟล์ สาขา หรือคอมมิต
เปลี่ยนที่เก็บ
หากต้องการเปลี่ยนไปใช้ที่เก็บอื่น ให้เลือกที่เก็บจากแถบเครื่องมือเบรดครัมบ์
ดูที่เก็บที่คอมมิตที่เฉพาะเจาะจง
วิธีดูที่เก็บในคอมมิตที่เฉพาะเจาะจง
- เลือกไฟล์จากมุมมองของที่เก็บ
- จากแถบเครื่องมือเบรดครัมบ์ ให้เปิดเมนูสาขา
- ในเมนูย่อยที่ปรากฏขึ้น ให้คลิกคอมมิต
- เลือกคอมมิตที่ต้องการดู
ตอนนี้อินเทอร์เฟซจะแสดงที่เก็บตามที่มีอยู่ที่คอมมิตนั้น
เปิด Branch, คอมมิต หรือแท็ก
โดยค่าเริ่มต้น อินเทอร์เฟซการค้นหาโค้ดและการเรียกดูแหล่งที่มาจะเปิดที่เก็บเป็น Branch เริ่มต้น หากต้องการเปิดสาขาอื่น ให้คลิกเมนู Branch/Commit/Tag จากแถบเครื่องมือเบรดครัมบ์ เมนูย่อยจะเปิดขึ้น ซึ่งจะช่วยให้คุณสามารถเลือกสาขาโดยใช้ชื่อสาขา ชื่อแท็ก หรือผ่านช่องค้นหาได้
- หากต้องการเลือกสาขาโดยใช้ชื่อ Branch ให้เลือกสาขา แล้วคลิกชื่อของสาขา
- หากต้องการเลือกสาขาโดยใช้ชื่อแท็ก ให้เลือกแท็ก แล้วคลิกชื่อแท็ก
- หากต้องการเลือกสาขาโดยใช้คอมมิต ID ให้เลือก Commit แล้วคลิกรหัสคอมมิต
- หากต้องการค้นหาสาขา คอมมิต หรือแท็ก ให้เลือกรายการที่เกี่ยวข้องแล้วพิมพ์ข้อความค้นหาในช่องค้นหา
การทำงานกับไฟล์
เมื่อคุณเลือกที่เก็บจากหน้าจอหลัก หน้าจอจะเปลี่ยนไปแสดงมุมมองของที่เก็บนั้น หากมีไฟล์ README อยู่แล้ว เนื้อหาจะปรากฏในแผงไฟล์ทางด้านขวาของหน้าจอ มิฉะนั้น รายการไฟล์และโฟลเดอร์ของที่เก็บจะปรากฏขึ้น ทางด้านซ้ายของหน้าจอจะเป็นมุมมองแบบ ต้นไม้ของไฟล์และโฟลเดอร์ในที่เก็บ คุณสามารถใช้โครงสร้างนี้เพื่อเรียกดู และเปิดไฟล์ที่ต้องการ
โปรดสังเกตว่าเมื่อคุณดูที่เก็บ แถบเครื่องมือเบรดครัมบ์จะมีคอมโพเนนต์ 3 ส่วน ดังนี้
- เมนูที่เก็บ ซึ่งคุณสามารถเลือกที่เก็บอื่นได้
- เมนู Branch/Commit/Tag ซึ่งคุณสามารถเลือกสาขา แท็ก หรือคอมมิตที่ต้องการได้
- ช่องเส้นทางไฟล์ ซึ่งแสดงชื่อของไฟล์หรือโฟลเดอร์ปัจจุบัน รวมถึงเส้นทางที่เกี่ยวข้อง
เปิดไฟล์
คุณสามารถเปิดไฟล์โดยเรียกดูไดเรกทอรีและเลือกไฟล์นั้น มุมมองของที่เก็บจะอัปเดตเพื่อแสดงเนื้อหาของไฟล์ในแผงไฟล์ และตำแหน่งของไฟล์ในที่เก็บในแผงผังต้นไม้
ดูการเปลี่ยนแปลงไฟล์
วิธีดูการเปลี่ยนแปลงไฟล์
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิกเบลอที่มุมขวาบน
แผงไฟล์จะอัปเดตเพื่อแสดงว่าใครเปลี่ยนแปลงไฟล์อะไรและเมื่อใด
ดูประวัติการเปลี่ยนแปลง
วิธีดูประวัติการเปลี่ยนแปลงของไฟล์
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิกประวัติที่มุมขวาบน แผงประวัติการเปลี่ยนแปลงจะปรากฏขึ้น เพื่อแสดงคอมมิตสำหรับไฟล์นี้
ดูการตรวจสอบโค้ด
สำหรับการตรวจสอบโค้ด Gerrit คุณสามารถเปิดเครื่องมือได้โดยตรงจากแผงประวัติการเปลี่ยนแปลง
วิธีดูการตรวจสอบโค้ดของไฟล์มีดังนี้
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิกประวัติที่มุมขวาบน แผงประวัติการเปลี่ยนแปลง จะปรากฏขึ้นเพื่อแสดงคอมมิตสำหรับไฟล์นี้
- วางเมาส์เหนือคอมมิต ปุ่มเพิ่มเติม (จุดแนวตั้ง 3 จุด) จะปรากฏขึ้น
- คลิกปุ่มเพิ่มเติม
- เลือกดูการตรวจสอบโค้ด
เครื่องมือตรวจสอบโค้ด Gerrit จะเปิดในหน้าต่างเบราว์เซอร์ใหม่
เปิดไฟล์ที่คอมมิตที่ระบุ
วิธีเปิดไฟล์ในคอมมิตที่เฉพาะเจาะจง
- เลือกไฟล์จากมุมมองของที่เก็บ
- คลิกประวัติที่มุมขวาบน แผงประวัติการเปลี่ยนแปลง จะปรากฏขึ้นเพื่อแสดงคอมมิตสำหรับไฟล์นี้
- วางเมาส์เหนือคอมมิต ปุ่มดูจะปรากฏขึ้น
- คลิกปุ่มดู
เปรียบเทียบไฟล์กับคอมมิตอื่น
วิธีเปรียบเทียบไฟล์ในคอมมิตอื่น
- เลือกไฟล์จากมุมมองของที่เก็บ หากต้องการเปรียบเทียบจากคอมมิต 2 รายการ ให้เปิดไฟล์ที่คอมมิตนั้นก่อน
- วางเมาส์เหนือคอมมิต ปุ่ม DIFF จะปรากฏขึ้น
- คลิกปุ่ม DIFF
แผงไฟล์จะอัปเดตเพื่อแสดงการเปรียบเทียบ 2 ไฟล์คู่กัน คอมมิตที่เก่าที่สุดจาก 2 รายการจะอยู่ทางซ้ายเสมอ
ในแผงประวัติการเปลี่ยนแปลง ระบบจะไฮไลต์คอมมิตทั้ง 2 รายการ และป้ายกำกับจะระบุว่าคอมมิตนั้นแสดงอยู่ทางด้านซ้ายหรือด้านขวา
หากต้องการเปลี่ยนไฟล์ใดไฟล์หนึ่ง ให้วางเมาส์เหนือคอมมิตในแผงประวัติการเปลี่ยนแปลง จากนั้นคลิกปุ่มซ้ายหรือขวาเพื่อเปิดคอมมิตทางด้านซ้ายหรือขวาของความแตกต่าง
การเรียกดูตรวจสอบแบบอ้างอิง
อีกวิธีหนึ่งในการเรียกดูที่เก็บซอร์สคือการใช้ข้ามการอ้างอิง การอ้างอิงเหล่านี้จะปรากฏเป็นไฮเปอร์ลิงก์ภายในไฟล์แหล่งที่มาที่ระบุโดยอัตโนมัติ
เพื่อให้คุณระบุการตรวจสอบแบบอ้างอิงได้ง่ายขึ้น ให้คลิกการอ้างอิงแบบเปรียบเทียบ ซึ่งอยู่ที่มุมขวาบน ตัวเลือกนี้จะแสดงขีดเส้นใต้ด้านล่างการอ้างอิงแบบข้ามทั้งหมดในไฟล์
หมายเหตุ: หากการอ้างอิงเปรียบเทียบเป็นสีเทา แสดงว่าใช้การตรวจสอบแบบอ้างอิงกับไฟล์นั้นไม่ได้
คลิกการอ้างอิงไขว้เพื่อเปิดแผงการอ้างอิงแบบข้าม แผงนี้ประกอบด้วย 2 ส่วนดังนี้
- ส่วนคำจำกัดความซึ่งจะแสดงรายการของไฟล์หรือไฟล์ที่กำหนดข้อมูลอ้างอิง
- ส่วนข้อมูลอ้างอิงซึ่งจะแสดงรายการไฟล์ที่ข้อมูลอ้างอิงปรากฏอยู่ด้วย
โดยทั้ง 2 ส่วนจะแสดงชื่อไฟล์ รวมถึงบรรทัดที่มีข้อมูลอ้างอิง หากต้องการเปิดไฟล์จากแผงการอ้างอิงแบบข้ามรายการ ให้คลิกรายการหมายเลขบรรทัด ไฟล์จะปรากฏในส่วนใหม่ของแผง ซึ่งทำให้คุณเรียกดูไฟล์ต่อไปได้โดยที่เก็บไฟล์ต้นฉบับไว้ในมุมมอง
คุณยังเรียกดูการตรวจสอบแบบอ้างอิงต่อโดยใช้แผงการอ้างอิงแบบข้ามได้ เช่นเดียวกับที่แผง "ไฟล์" เมื่อทำเช่นนั้น แผงจะแสดงเส้นทางเบรดครัมบ์ ซึ่งคุณสามารถใช้เพื่อไปยังการตรวจสอบแบบอ้างอิงต่างๆ
กำลังค้นหารหัส
คุณสามารถค้นหาไฟล์หรือข้อมูลโค้ดที่ต้องการโดยใช้ช่องค้นหาที่ด้านบนของหน้าจอ การค้นหาจะขัดแย้งกับ Branch เริ่มต้นเสมอ
การค้นหาทั้งหมดจะใช้ นิพจน์ทั่วไป RE2 โดยค่าเริ่มต้น หากไม่ต้องการใช้นิพจน์ทั่วไป ให้ใส่เครื่องหมายอัญประกาศคู่ ( " ) คร่อมคำค้นหา
หมายเหตุ: หากต้องการค้นหาไฟล์ที่ต้องการอย่างรวดเร็ว ให้เพิ่มเครื่องหมายแบ็กสแลชไว้หน้าเครื่องหมายจุด หรือใส่ชื่อเต็มของไฟล์ไว้ในเครื่องหมายคำพูด
foo\.java
"foo.java"
คุณปรับแต่งการค้นหาได้โดยใช้ตัวกรองต่อไปนี้
| กรอง | ตัวเลือกอื่นๆ | คำอธิบาย | ตัวอย่าง |
|---|---|---|---|
| lang: | ภาษา: | จับคู่ข้อมูลที่ตรงกันตามภาษาของไฟล์ | lang:java ทดสอบ |
| ไฟล์: | เส้นทาง: เส้นทาง: f: |
||
| กรณี:ใช่ | ทําให้การค้นหาคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ โดยค่าเริ่มต้น การค้นหาจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ | case:yes สวัสดีชาวโลก | |
| ชั้นเรียน: | ค้นหาชื่อชั้นเรียน | คลาส:MainClass | |
| ฟังก์ชัน: | func: | ค้นหาชื่อฟังก์ชัน | ฟังก์ชัน:พิมพ์ |
| - | ลบคำจากการค้นหา | สวัสดี -โลก | |
| \ | ซ่อนอักขระพิเศษ เช่น ., \ หรือ (. | run\(\) | |
| "[คำ]" | ทำการค้นหาตามตัวอักษร | "class:main" |
การสนับสนุนเพิ่มเติม
หากต้องการรายงานปัญหา ให้คลิกปุ่มความคิดเห็นที่ปรากฏที่มุมขวาบนของหน้าจอ และป้อนความคิดเห็นลงในแบบฟอร์มที่มีให้