วิธีใช้:กล่องข้อมูล
หน้าคำอธิบายนี้เป็นคู่มือบอกวิธี ซึ่งบอกรายละเอียดกระบวนการหรือกระบวนวิธีของบางส่วนของบรรทัดฐานและวัตรของวิกิพีเดีย ไม่ใช่ส่วนหนึ่งของนโยบายและแนวปฏิบัติของวิกิพีเดีย |
กล่องข้อมูลเป็นตารางรูปแบบตายตัวซึ่งปกติเพิ่มเข้ามุมขวาบนสุดของบทความเพื่อนำเสนอบทสรุปบางแง่มุมซึ่งบทความหลายบทความมีร่วมกันในรูปแบบเดียวกัน และบางทีใช้เพื่อปรับปรุงการนำทางไปบทความที่มีความเกี่ยวโยงกันอื่น กล่องข้อมูลจำนวนมากยังจ่ายข้อมูลอภิพันธุ์เชิงโครงสร้าง ซึ่งดีบีพีเดียและผู้ใช้ซ้ำภายนอกอื่นอ้างอิง คุณลักษณะกล่องข้อมูลวางนัยทั่วไปเติบโตจากตารางจำแนกพันธุ์เดิมซึ่งผู้เขียนพัฒนาขึ้นเพื่อแสดงการจำแนกทางวิทยาศาสตร์ของสิ่งมีชีวิต
การใช้กล่องข้อมูลไม่ใช่ข้อกำหนดหรือถูกห้ามสำหรับทุกบทความ การใส่อะไรลงในกล่องข้อมูล จะใส่กล่องข้อมูลใด หรือจะใส่ส่วนใดของกล่องข้อมูล ตัดสินจากการอภิปรายและความเห็นพ้องในหมู่ผู้เขียนในแต่ละบทความ
ประโยชน์
แม่แบบกล่องข้อมูลมีข้อเท็จจริงและสถิติที่สำคัญสำหรับประเภทซึ่งพบบ่อยในบทความที่เกี่ยวข้องกัน ตัวอย่างเช่น สัตว์ทุกชนิดมีการจำแนกทางวิทยาศาสตร์ (ชนิด สกุล เป็นต้น) ตลอดจนสถานะการอนุรักษ์ การเพิ่ม {{taxobox}} ในบทความเกี่ยวกับสัตว์จะทำให้ผู้อ่านสามารถค้นหาสารสนเทศดังกล่าวได้อย่างรวดเร็วและเปรียบเทียบบทความนั้นกับบทความอื่นได้ง่ายขึ้นด้วย
แม่แบบกล่องข้อมูลเหมือนกับแฟกต์ชีต หรือแถบข้างในบทความนิตยสาร ซึ่งสรุปจุดสำคัญในรูปแบบที่อ่านง่าย ทว่า แม่แบบกล่องข้อมูลต่างจากตาราง "สถิติ" ซึ่ง (โดยทั่วไป) สรุปเนื้อความจากบทความเท่านั้น คือ สารสนเทศยังควรใส่อยู่ในข้อความหลักด้วย ส่วนหนึ่งเพราะผู้อ่านบางคนอาจเข้าถึงเนื้อหาของกล่องข้อมูลไม่ได้ โดยเฉพาะอย่างยิ่ง หากแม่แบบกล่องข้อมูลซ่อนข้อมูลขนาดยาวในตารางยุบได้ ในกรณีนั้นผู้อ่านที่ใช้เทคโนโลยีช่วยอ่านอาจข้ามข้อมูลนั้นไปอย่างสิ้นเชิง
สิ่งที่ควรบรรจุในกล่องข้อมูล
โดยทั่วไป ข้อมูลในแม่แบบกล่องข้อมูลควรมีลักษณะดังนี้
- เปรียบเทียบได้ ถ้าบทความหลายเรื่องมีลักษณะประจำร่วมกัน (เช่น ชื่อบุคคลและวันเกิด) กล่องข้อมูลจะมีประโยชน์ในการสามารถเปรียบเทียบลักษณะประจำนี้ได้ นอกจากนี้ยังสื่อเป็นนัยว่า ถ้าเป็นไปได้ เนื้อหาควรนำเสนอในรูปแบบมาตรฐานด้วย
- กระชับ แม่แบบกล่องข้อมูลมีไว้ "กวาดตามอง" และใช้ตรวจสอบข้อเท็จจริงอย่างรวดเร็ว
- มีเนื้อหาสัมพันธ์กับเรื่อง
- มีอ้างอิงที่อื่นในบทความแล้ว กล่องข้อมูล เช่นเดียวกับบทนำของบทความ ควรบรรจุเนื้อหาที่มีการขยายความและมีการอ้างอิงแหล่งข้อมูลที่น่าเชื่อถือรองรับในที่อื่นของบทความแล้ว ทว่า หากจำเป็น (เช่น บทความยังไม่เสร็จสมบูรณ์) ก็ใส่เชิงอรรถในกล่องข้อมูลได้
สิ่งที่ไม่ควรบรรจุในกล่องข้อมูล
โดยทั่วไป ข้อมูลในแม่แบบกล่องข้อมูลไม่ควรมี
- ความยาวมากเกิน ข้อความยาว ๆ หรือสถิติที่ละเอียดมาก ควรอยู่ในส่วนบทความมากกว่า
- รายละเอียดเกร็ด ปัญหาพบบ่อยได้แก่การใส่เนื้อหาในกล่องข้อมูลที่เป็นเกร็ดและหาที่ลงในตัวบทความไม่ได้ ตัวอย่างเช่น หมู่โหลิตของตัวละครในบันเทิงคดีที่อาจมีอ้างอิงในผลงาน แต่ไม่มีประโยชน์ใดในการทำความเข้าใจกับสิ่งที่เป็นหัวเรื่อง แม่แบบกล่องข้อมูลไม่ควรใช้สำหรับรายละเอียดที่เป็นเรื่องเล็กน้อยเกินไปที่จะรวมอยู่ในตัวบทความ (มีข้อยกเว้นบางประการ เช่น คุณสมบัติทางเคมี)
- ธง โดยทั่วไปควรเลี่ยงการใส่ไอคอนธงในกล่องข้อมูล แม้มีเขตข้อมูล "ประเทศ" หรือ "สัญชาติ" ทั้งนี้ เพราะทำให้ไขว้เขวโดยไม่จำเป็นและทำให้เขตข้อมูลหนึ่งดูเด่นกว่าเขตข้อมูลอื่น
การเพิ่มกล่องข้อมูลในบทความ
การเพิ่มกล่องข้อมูลในบทความมีสองขั้นตอน
- การค้นหากล่องข้อมูล
- การแก้ไขบทความ
การค้นหากล่องข้อมูล
ในการใช้กล่องข้อมูลในบทความ ผู้เขียนต้องทราบชื่อ ตัวแปรเสริม และวิธีที่ตั้งใจให้ใช้ตัวแปรเสริมเหล่านั้น เนื่องจากกล่องข้อมูลเก็บไว้ในเนมสเปซแยกจากบทความ จึงอาจต้องใช้ความพยายามเสียหน่อยในการระบุกล่องข้อมูลจากชื่อ ทว่า เมื่อผู้เขียนได้ชื่อมาแล้ว การมองหาเอกสารประกอบกล่องข้อมูล
คุณสามารถหากล่องข้อมูลที่ต้องการใช้โดยการดูจากชื่อกล่องข้อมูลที่ใช้ในบทความคล้ายกัน
ตัวอย่างเช่น บทความ D-Terminal มีกล่องข้อมูล ในการดูว่ากล่องข้อมูลที่ใช้ชื่ออะไร ให้กดแก้ไขบทความ
{{Infobox connector ... }} รหัส "{{Infobox connector" ระบุมาร์กอัพระหว่างวงเล็บปิดว่าเป็นการใช้กล่องข้อมูล "connector" ผู้เขียนสามารถดูเอกสารประกอบแม่แบบ รวมทั้งรายการตัวแปรเสริม ในเนมสเปซแม่แบบภายใต้ Template:Infobox connector
การแก้ไขบทความเป้าหมาย
กล่องข้อมูลควรวางอยู่บนสุดของหน้าตามหลังลิงก์แก้ความกำกวม และป้ายระบุบำรุงรักษาบทความ
เอกสารประกอบแม่แบบปกติมีแม่แบบ "ว่าง" เพื่อความสะดวกซึ่งสามารถคัดลอกลงบทความเป้าหมายได้โดยตรง แม่แบบประกอบด้วยวงเล็บคู่เปิด ({{) และปิด (}}) ซึ่งมีชื่อกล่องข้อมูล และรายการตัวแปรเสริมที่ยังไม่กำหนดค่า จากนั้นผู้เขียนกรอกค่าสำหรับตัวแปรเสริมแต่ละตัวที่อยู่ฝั่งขวามือของเครื่องหมายเท่ากับ
ตัวอย่างเช่น
{{Infobox person |name = |image = |caption = ... |website = }} อาจกรอกได้แบบนี้
{{Infobox person |name = Casanova |image = Casanova_self_portrait.jpg |caption = A self portrait of Casanova ... |website = }} ในตัวอย่างนี้ ชื่อของตัวแปรเสริม ("name", "image", "caption", "website") ถูกตรึงไว้ในการออกแบบกล่องข้อมูลและมีอธิบายในเอกสารประกอบ ตัวแปรเสริมที่สะกดผิด ใช้อักษรใหญ่เล็กไม่ตรง หรือแม่แบบไม่รองรับจะไม่แสดงผลโดยสิ้นเชิง หากต้องการมองหาว่าตัวแปรเสริมใช้งานอย่างไร ให้ดูที่หน้าแม่แบบของกล่องข้อมูล ตัวแปรเสริมที่นอกเหนือจากนั้นจะถูกละเลย แม้ว่าตัวแปรเสริมนั้นจะใช้ได้ในแม่แบบอื่น หากคุณเชื่อว่าควรเพิ่มตัวแปรเสริมเข้าแม่แบบกล่องข้อมูลหนึ่ง ให้เสนอแนะในหน้าคุยของกล่องข้อมูลนั้น
เอกสารประกอบแม่แบบจะอธิบายว่าตัวแปรเสริมใดจำเป็นหรือไม่จำเป็น ตัวแปรเสริมที่จำเป็นจะแสดงผลระหว่างวงเล็บสาม (ตัวอย่างเช่น {{{requiredparametername}}}) เมื่อดูตัวอย่างหรือเผยแพร่ ตัวแปรเสริมที่ไม่จำเป็นสามารถปล่อยว่างไว้หรือไม่เขียนในหน้าบทความเลยก็ได้
การแก้ปัญหา
หากคุณเพิ่มกล่องข้อมูลแล้วกล่องนั้นแสดงผลไม่ถูกต้อง ด้านล่างเป็นข้อผิดพลาดทั่วไป
- คุณใช้ตัวแปรเสริมที่ไม่ถูกต้องหรือแม่แบบไม่รองรับ คุณสามารถใช้เฉพาะตัวแปรเสริมที่มีการเขียนโปรแกรมล่วงหน้าในแม่แบบกล่องข้อมูล "นี้" เท่านั้น
- คุณสะกดชื่อตัวแปรเสริมผิดหรือไม่ได้ใส่เครื่องหมายวรรคตอนที่จะเป็น (เช่น ไม่ได้ใส่เส้นใต้อักขระใน
birth_place) - คุณใช้อักษรใหญ่เล็กผิดกับชื่อแม่แบบ กล่องข้อมูลแทบทั้งหมดใช้ป้ายตัวแปรเสริมตัวเล็ก
- เรื่องการใส่ภาพ บางทีแม่แบบกำหนดรูปแบบการใส่ภาพต่างกัน แล้วคุณใส่คำขึ้นต้น
ไฟล์:ก่อนชื่อภาพซึ่งผิดไปจากที่แม่แบบกำหนด (ดูส่วนข้างล่าง) - ถ้าคุณใช้ชื่อตัวแปรเสริมมากกว่าหนึ่งครั้ง จะแสดงผลเฉพาะรอบที่ใช้สุดท้ายเท่านั้น
การเพิ่มภาพในกล่องข้อมูล
ปกติภาพกำหนดโดยใช้ตัวแปรเสริม ภาพ และ คำบรรยาย ทว่า แม่แบบอาจใช้ชื่อต่างกันสำหรับตัวแปรเสริมนี้ ตัวอย่างเช่น แม่แบบ:Tp ใช้ "Cover" แทน "image" และ "Caption" แทน "caption"
บางทีตัวแปรเสริม image บางทีต้องการวากยสัมพันธ์ภาพแบบขยาย แต่บางทีก็ต้องการเพียงชื่อไฟล์ภาพขึ้นอยู่กับข้อกำหนดของผู้สร้างกล่องข้อมูล คุณสามารถดูได้ด้วยทดลอง (โดยใช้ฟังก์ชัน "แสดงตัวอย่าง") หรือดูเอกสารประกอบแม่แบบกล่องข้อมูล