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