ตัวสร้าง GitHub Issue Template
สร้าง issue template สำหรับ GitHub แบบเห็นภาพ: เลือกทำ bug report แบบ Markdown พร้อม YAML front matter หรือ Issue Forms ที่มี input, textarea, dropdown และ
Loading tool...
ตัวสร้าง GitHub Issue Template คืออะไร?
ตัวสร้าง GitHub Issue Template สร้างไฟล์ที่ GitHub ใช้เติมเนื้อหา issue ล่วงหน้า รองรับทั้งสองรูปแบบที่ repository ใช้กัน คือ Markdown template คลาสสิกพร้อม YAML front matter (name, about, title, labels, assignees) และ Issue Forms YAML ที่ field แบบ input, textarea, dropdown และ checkbox จะถูก render เป็นฟอร์มจริง ทุกอย่างสร้างในเบราว์เซอร์ของคุณผ่าน visual editor พร้อม live preview ของไฟล์ที่จะ commit ตรงตามจริง
ประโยชน์หลัก
- template ใช้งานได้ตั้งแต่ครั้งแรก เพราะ front matter และ YAML syntax ถูกต้องเสมอ
- ฟอร์มมีโครงสร้างพร้อม required fields ลดการถาม-ตอบกลับไปมาเรื่องข้อมูลไม่ครบ
- title, labels และหัวข้อสม่ำเสมอ ทำให้ค้นหาและ triage issue ง่ายขึ้น
- ไม่ต้องจำ YAML — field builder จัดการ id, ประเภท, options และการ escape ให้
- ฟรี เป็นส่วนตัว และทำงาน offline ไม่มีการ upload และไม่ต้อง login GitHub
กรณีการใช้งาน
- •ทำ bug report มาตรฐานสำหรับ open-source project พร้อมช่อง repro steps และ environment
- •เก็บ feature request ด้วย priority dropdown และ textarea สำหรับ acceptance criteria
- •ช่วย maintainer ใหม่เริ่มต้นง่าย ๆ ด้วย template สำเร็จรูปแทนเอกสารยาว ๆ
- •แก้ปัญหา repo ที่ issue เข้ามาไม่มีเวอร์ชัน log หรือพฤติกรรมที่คาดหวัง
- •ลองวาง layout ของ issue form ก่อน commit จริงลง .github/ISSUE_TEMPLATE
วิธีใช้ตัวสร้าง GitHub Issue Template
- เลือกชนิด template: เลือกระหว่าง Markdown template คลาสสิก (ใช้ได้กับทุก repository) หรือ Issue Forms YAML ที่มี field ระบุประเภทชัดเจน
- กรอกข้อมูล metadata: ตั้งชื่อ template คำอธิบาย title prefix เริ่มต้น labels และ assignees — รายการจะถูกแปลงเป็น YAML array ที่ถูกต้องให้อัตโนมัติ
- ประกอบฟอร์มหรือเนื้อหา: สำหรับ Issue Forms ให้เพิ่ม field แบบ input, textarea, dropdown และ checkbox พร้อม id, label และสถานะ required ส่วนโหมด Markdown แก้ไขเนื้อหาได้ตรง ๆ หรือกดโหลดตัวอย่าง bug report
- คัดลอกลง repository: ตรวจสอบ live preview แล้วคัดลอกหรือดาวน์โหลดไฟล์ไปเก็บไว้ที่ .github/ISSUE_TEMPLATE/ ใน repository — GitHub จะใช้งานทันที
คุณสมบัติหลัก
- สองโหมด: Markdown template คลาสสิก และ Issue Forms YAML แบบมีโครงสร้าง
- Field builder แบบ visual สำหรับ input, textarea, dropdown และ checkbox
- เติมเครื่องหมายคำพูดและ escape ใน YAML ให้อัตโนมัติสำหรับชื่อ label และ options
- แปลงรายการ labels และ assignees เป็น YAML array ที่ถูกต้อง
- คัดลอกหรือดาวน์โหลดเป็น bug_report.md / bug_report.yml ได้ในคลิกเดียว ทำงานในเบราว์เซอร์ล้วน
คำถามที่พบบ่อย
ต้องเอาไฟล์ template ที่สร้างไปวางไว้ที่ไหน?
commit ไว้ภายใต้ .github/ISSUE_TEMPLATE/ ใน default branch ของ repository เช่น .github/ISSUE_TEMPLATE/bug_report.md หรือ bug_report.yml — GitHub จะเริ่มแสดง template นี้ในหน้าสร้าง issue ทันทีที่ไฟล์ขึ้น branch หลัก
Markdown template กับ Issue Forms ต่างกันอย่างไร?
Markdown template จะเติมเนื้อหา issue ล่วงหน้าแบบข้อความอิสระที่ใครก็แก้ได้ ส่วน Issue Forms (YAML) จะ render ฟอร์มแบบมีโครงสร้าง เช่น input, dropdown, checkbox และบังคับ required fields ได้ ทำให้รายงานเข้ามาครบถ้วนสม่ำเสมอ
ทำไมบางค่าใน YAML ถูกใส่เครื่องหมายคำพูดไว้?
ค่าที่ขึ้นต้นด้วยอักขระพิเศษ (เช่น วงเล็บหรือ #) มี ": " ข้ามใน หรืออาจถูกตีความเป็นชนิดข้อมูลอื่นใน YAML จะถูกใส่เครื่องหมายคำพูดให้อัตโนมัติเพื่อให้ไฟล์ valid เสมอ เป็นเรื่องการแสดงผลเท่านั้น GitHub อ่านค่าทั้งสองแบบเหมือนกัน
ใส่หลาย template ใน repository เดียวได้ไหม?
ได้ สร้างไฟล์แยกตาม template ใน .github/ISSUE_TEMPLATE/ โดยแต่ละไฟล์มีชื่อและคำอธิบายของตัวเอง ผู้ใช้จะเลือกตอนเปิด issue และยังเพิ่ม config.yml ที่มี blank_issues_enabled และ contact links เพื่อควบคุมหน้าเลือกได้อีกด้วย