วิกิพีเดีย:ข้อมูลแม่แบบ
 | เนื้อหาในบทความนี้ล้าสมัย โปรดปรับปรุงข้อมูลให้เป็นไปตามเหตุการณ์ปัจจุบันหรือล่าสุด ดูหน้าอภิปรายประกอบ |
- หน้าหลัก
- คำติชมที่มีเดียวิกิ
- กระบะทราย (ไม่จำเป็นต้องมีบัญชี)
- เอกสารประกอบ:
- การพัฒนา:
- แผนงาน จนถึงปี 2017
- รายงานสถานะรายสัปดาห์ (2015-2016)
ข้อมูลแม่แบบคืออะไร?
[แก้]ข้อมูลแม่แบบคือคำอธิบายมาตรฐานของแม่แบบ ซึ่งใช้โดย เริ่มต้นด้วยเครื่องมือแก้ไขแบบเห็นภาพ เสริมด้วยเครื่องมือแก้ไขข้อความวิกิ 2017 และเครื่องมืออื่นๆ เพื่อปรับปรุงประสบการณ์การแก้ไขแม่แบบสำหรับผู้ใช้ ทั้งเครื่องมือแก้ไขแบบเห็นภาพและเครื่องมือแก้ไขข้อความวิกิ 2017 ต่างก็มีตัวช่วยสำหรับแก้ไขแม่แบบ แต่เพื่อให้ตัวช่วยมีประโยชน์สูงสุด ตัวช่วยจะต้องแสดงข้อมูลเฉพาะเกี่ยวกับแม่แบบแต่ละแม่แบบแก่ผู้ใช้ เช่น คำอธิบายสั้นๆ เกี่ยวกับวัตถุประสงค์ของแม่แบบและพารามิเตอร์ของแม่แบบ ข้อมูลนี้จะถูกเข้ารหัสอย่างเป็นทางการ (โดยตัวแก้ไขวิกิใดๆ) โดยใช้ข้อมูลแม่แบบ
การแก้ไขโดยไม่ต้องใช้ข้อมูลแม่แบบ
[แก้]หากไม่มีข้อมูลแม่แบบ จะต้องเพิ่มพารามิเตอร์แต่ละรายการด้วยตนเองเมื่อแทรกแม่แบบใหม่
ไม่มีการให้ข้อมูลว่าค่าของพารามิเตอร์ควรเป็นเท่าใด
การแก้ไขด้วยข้อมูลแม่แบบ
[แก้]โดยมีข้อมูลแม่แบบ จะมีการแสดงรายการพารามิเตอร์ที่รองรับ (พร้อมคำอธิบาย) สำหรับแม่แบบ
ข้อมูลแม่แบบจะให้บริบทสำหรับแต่ละพารามิเตอร์ และช่วยให้ผู้ใช้ปรับเปลี่ยนแม่แบบได้ง่ายยิ่งขึ้น
การเพิ่มข้อมูลแม่แบบ
[แก้]ใครก็ตามสามารถช่วยเหลือได้โดยการเพิ่มข้อมูลแม่แบบลงในแม่แบบ (โดยเฉพาะอย่างยิ่งแม่แบบที่มีชื่อเสียง เช่น กล่องข้อมูล) เพื่อให้แก้ไขในเครื่องมือแก้ไขแบบเห็นภาพได้ง่ายขึ้น ต่อไปนี้เป็นตัวอย่างขั้นต่ำที่วางไว้ในหน้าเอกสารของแม่แบบเป็นส่วนใหม่:
==ข้อมูลแม่แบบ==
{{TemplateData header}}
<templatedata>{
"description": "insert description here",
"params": {
"first parameter": {
"label": "x",
"description": "x",
"type": "string",
"suggested": true,
"autovalue": "derived automatic value",
"default": "default value",
"required": false
}
}
}</templatedata>
คุณสามารถเพิ่มหรือแก้ไขข้อมูลแม่แบบโดยใช้ 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 เพื่อเพิ่มลงในรายการ
คุณสามารถดูตัวอย่างวิธีการเพิ่มค่าที่แนะนำในตัวแก้ไขข้อมูลแม่แบบได้ที่นี่
การนำเข้าข้อมูลแม่แบบ
[แก้]แม่แบบบางอย่างนำเข้าข้อมูลแม่แบบจาก วิกิพีเดีย:วิกิมีเดียคอมมอนส์ สามารถทำได้โดยใช้ {{#invoke:TNT|doc}} ตัวอย่างเช่น {{#invoke:TNT|doc|Uses TemplateStyles}} โหลดข้อมูลแม่แบบจาก c:Data:Templatedata/Uses_TemplateStyles.tab ซึ่งใช้ในแม่แบบ:Uses TemplateStyles/doc
แม่แบบที่ใช้แล้ว
[แก้]ดูเพิ่ม
[แก้]- วิกิพีเดีย:ข้อมูลแม่แบบ/List รายการของหน้าทั้งหมดพร้อมข้อมูลแม่แบบ