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