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