วิกิพีเดีย:ข้อมูลแม่แบบ

__TOC__

**ข้อมูลแม่แบบคืออะไร?**
ข้อมูลแม่แบบคือคำอธิบายมาตรฐานของแม่แบบ ซึ่งใช้โดย เริ่มต้นด้วยเครื่องมือแก้ไขแบบเห็นภาพ เสริมด้วยเครื่องมือแก้ไขข้อความวิกิ 2017 และเครื่องมืออื่นๆ เพื่อปรับปรุงประสบการณ์การแก้ไขแม่แบบสำหรับผู้ใช้ ทั้งเครื่องมือแก้ไขแบบเห็นภาพและเครื่องมือแก้ไขข้อความวิกิ 2017 ต่างก็มีตัวช่วยสำหรับแก้ไขแม่แบบ แต่เพื่อให้ตัวช่วยมีประโยชน์สูงสุด ตัวช่วยจะต้องแสดงข้อมูลเฉพาะเกี่ยวกับแม่แบบแต่ละแม่แบบแก่ผู้ใช้ เช่น คำอธิบายสั้นๆ เกี่ยวกับวัตถุประสงค์ของแม่แบบและพารามิเตอร์ของแม่แบบ ข้อมูลนี้จะถูกเข้ารหัสอย่างเป็นทางการ (โดยตัวแก้ไขวิกิใดๆ) โดยใช้ข้อมูลแม่แบบ

**การแก้ไขโดยไม่ต้องใช้ข้อมูลแม่แบบ**
หากไม่มีข้อมูลแม่แบบ จะต้องเพิ่มพารามิเตอร์แต่ละรายการด้วยตนเองเมื่อแทรกแม่แบบใหม่
500x500px
ไม่มีการให้ข้อมูลว่าค่าของพารามิเตอร์ควรเป็นเท่าใด
500x500px

**การแก้ไขด้วยข้อมูลแม่แบบ**
โดยมีข้อมูลแม่แบบ จะมีการแสดงรายการพารามิเตอร์ที่รองรับ (พร้อมคำอธิบาย) สำหรับแม่แบบ
500x500px
ข้อมูลแม่แบบจะให้บริบทสำหรับแต่ละพารามิเตอร์ และช่วยให้ผู้ใช้ปรับเปลี่ยนแม่แบบได้ง่ายยิ่งขึ้น
500x500px

**การเพิ่มข้อมูลแม่แบบ**
ใครก็ตามสามารถช่วยเหลือได้โดยการเพิ่มข้อมูลแม่แบบลงในแม่แบบ (โดยเฉพาะอย่างยิ่งแม่แบบที่มีชื่อเสียง เช่น กล่องข้อมูล) เพื่อให้แก้ไขในเครื่องมือแก้ไขแบบเห็นภาพได้ง่ายขึ้น ต่อไปนี้เป็นตัวอย่างขั้นต่ำที่วางไว้ในหน้าเอกสารของแม่แบบเป็นส่วนใหม่:

**ข้อมูลแม่แบบ**
{
"description": "insert description here",
"params": {
"first parameter": {
"label": "x",
"description": "x",
"type": "string",
"suggested": true,
"autovalue": "derived automatic value",
"default": "default value",
"required": false
}
}
}
คุณสามารถเพิ่มหรือแก้ไขข้อมูลแม่แบบโดยใช้ GUI ได้โดยการกดปุ่มต่อไปนี้ซึ่งปรากฏที่ด้านบนของหน้าแก้ไข: แก้ไขข้อมูลแม่แบบ
บทช่วยสอนเกี่ยวกับข้อมูลแม่แบบจะอธิบายอย่างละเอียดเกี่ยวกับวิธีการเพิ่มข้อมูลข้อมูลแม่แบบลงในแม่แบบ

**การเพิ่มค่าที่แนะนำสำหรับพารามิเตอร์**
คุณสมบัติพารามิเตอร์ suggestedvalues ช่วยให้คุณกำหนดรายการค่าพารามิเตอร์ที่จะแสดงต่อผู้ใช้เครื่องมือแก้ไขแบบเห็นภาพในรายการดรอปดาวน์เพื่อให้เลือกได้ง่าย สามารถทำได้โดยตรงใน JSON หรือใช้ตัวแก้ไขข้อมูลแม่แบบ โดยไม่ต้องเขียนโค้ด ทั้งสองวิธีมีคำอธิบายโดยละเอียดด้านล่าง
เมื่อเพิ่มค่าลงในข้อมูลแม่แบบแล้วเครื่องมือแก้ไขแบบเห็นภาพจะแสดงค่าเหล่านั้นในกล่องคอมโบ (เมนูแบบดร็อปดาวน์ที่ผู้ใช้ยังสามารถป้อนค่าที่กำหนดเองได้) ผู้ใช้เลือกค่าที่ต้องการโดยการคลิกที่ค่านั้น หากรายการค่ามีความยาวมาก เช่น รายชื่อรัฐของประเทศ ผู้ใช้สามารถเริ่มพิมพ์ในช่อง หลังจากนั้นรายการจะถูกกรองเพื่อแสดงเฉพาะค่าที่มีข้อความที่พิมพ์เท่านั้น หากต้องการเปลี่ยนค่าที่ป้อน ผู้ใช้เพียงล้างช่อง และรายการดรอปดาวน์ทั้งหมดจะปรากฏขึ้นอีกครั้ง หากผู้ใช้ต้องการค่าที่ไม่มีอยู่ในรายการ (เช่น "ข้อความในขวด") ก็สามารถพิมพ์ด้วยตนเองได้
สำหรับค่าที่แนะนำที่จะแสดงในเครื่องมือแก้ไขแบบเห็นภาพ ชนิดของพารามิเตอร์จะต้องตั้งค่าเป็นหนึ่งในตัวเลือกต่อไปนี้:- เนื้อหา- เส้น- สตริง- ตัวเลข- ไม่ทราบ- ข้อความวิกิที่ไม่สมดุล
ประเภทอื่นๆ (ไฟล์ เพจ แม่แบบ ผู้ใช้ วันที่ บูลีน URL) ยังไม่รองรับในปัจจุบัน เนื่องจากมีฟังก์ชันพิเศษในเครื่องมือแก้ไขแบบเห็นภาพอยู่แล้ว (เช่น การกรอกอัตโนมัติ) ซึ่งจะรบกวนการทำงานของเมนูแบบดรอปดาวน์สำหรับค่าที่แนะนำในเครื่องมือแก้ไขแบบเห็นภาพ

**การเพิ่มค่าที่แนะนำสำหรับพารามิเตอร์ในข้อความวิกิ**
หากต้องการเพิ่มค่าที่แนะนำให้กับประเภทพารามิเตอร์ใดๆ ให้เพิ่มคุณสมบัติใหม่ “ suggestedvalues ” ลงในพารามิเตอร์ใน JSON คุณลักษณะของ “ค่าที่แนะนำ” จะต้องเป็นรายการสตริง
ตัวอย่างอาจมีลักษณะเช่นนี้:"media_type": {
	"label": "Type of media",
	"example": "Newspaper",
	"type": "string",
	"description": "In what medium was the article published?",
	"suggestedvalues": 
	"Journal",
	"Book",
	"Newspaper",
	"Magazine"
	
}

**การเพิ่มค่าที่แนะนำสำหรับพารามิเตอร์ด้วยตัวแก้ไขข้อมูลแม่แบบ**
สำหรับประเภทพารามิเตอร์ที่แสดงไว้ด้านบน คุณสามารถเพิ่มค่าที่แนะนำได้โดยใช้ตัวแก้ไขข้อมูลแม่แบบ- ขั้นตอนที่ 1. คลิกที่ "จัดการข้อมูลแม่แบบ"- ขั้นตอนที่ 2. คลิกชื่อของพารามิเตอร์ที่คุณต้องการเพิ่มค่าที่แนะนำ- ขั้นตอนที่ 3. หากยังไม่ได้ตั้งค่า ให้ตั้งค่าประเภทของพารามิเตอร์เป็นหนึ่งในรายการต่อไปนี้: เนื้อหา บรรทัด สตริง ตัวเลข ข้อความวิกิที่ไม่รู้จัก หรือไม่สมดุล ช่องป้อนข้อมูลใหม่ "ค่าที่แนะนำ" จะปรากฏขึ้น หากตั้งค่าพารามิเตอร์เป็นประเภทใดประเภทหนึ่งแล้ว ช่องอินพุตจะมองเห็นได้แล้ว- ขั้นตอนที่ 4. พิมพ์ค่าที่แนะนำ รวมถึงช่องว่างและอักขระพิเศษ แล้วกด Enter เพื่อเพิ่มลงในรายการ
คุณสามารถดูตัวอย่างวิธีการเพิ่มค่าที่แนะนำในตัวแก้ไขข้อมูลแม่แบบได้ที่นี่

**การนำเข้าข้อมูลแม่แบบ**
แม่แบบบางอย่างนำเข้าข้อมูลแม่แบบจาก วิกิพีเดีย:วิกิมีเดียคอมมอนส์ สามารถทำได้โดยใช้ doc ตัวอย่างเช่น #invoke:TNT|doc|Uses TemplateStyles โหลดข้อมูลแม่แบบจาก c:Data:Templatedata/Uses_TemplateStyles.tab ซึ่งใช้ในแม่แบบ:Uses TemplateStyles/doc

**แม่แบบที่ใช้แล้ว**

**ดูเพิ่ม**
 วิกิพีเดีย:ข้อมูลแม่แบบ/List รายการของหน้าทั้งหมดพร้อมข้อมูลแม่แบบ
หมวดหมู่:วิชวลเอดิเตอร์
หมวดหมู่:ข้อมูลแม่แบบ