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