ผลต่างระหว่างรุ่นของ "วิธีใช้:แม่แบบ"

เนื้อหาที่ลบ เนื้อหาที่เพิ่ม
Wedjet (คุย | ส่วนร่วม)
Wedjet (คุย | ส่วนร่วม)
ไม่มีความย่อการแก้ไข
บรรทัด 104:
สามารถเสนอให้ลบหรือรวมแม่แบบได้เช่นเดียวกับหน้าอื่น
 
=== วิธีการใช้การจัดการตัวแปรต่างๆเสริม ===
ค่าของตัวแปรเสริมซึ่งสามารถป้อนเข้าสู่แม่แบบจะปรากฏในรหัสแม่แบบเป็นไอเท็มที่อยู่ระหว่างวงเล็บ{{em|สามตัว}} ดังนี้
เพิ่มความสามารถของแม่แบบด้วยตัวแปร โดยการแสดงผลของแม่แบบแต่ละแม่แบบ จะเปลี่ยนตามค่าตัวแปรที่ใส่ให้กับแม่แบบ
* รหัส <code><nowiki>{{{xxx}}}</nowiki></code> จะถูกแทนด้วยค่าของตัวแปรเสริมชื่อ <code>xxx</code> ตัวแปรเสริมเหล่านี้เรียก "ตัวแปรเสริมมีชื่อ"
=== ตัวแปรแบบกำหนดค่า ===
* รหัส <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code> เป็นต้น จะถูกทแนที่ด้วย "ตัวแปรเสริมไม่มีชื่อ" ลำดับแรก ลำดับสอง เป็นต้น (หรือค่าของตัวแปรเสริมชื่อ <code>1</code>, <code>2</code> เป็นต้น)
การกำหนดตัวแปรในแม่แบบ ใช้ชื่อตัวแปรภายในเครื่องหมายปีกกา 3 ชั้น ในลักษณะ <nowiki>{{{__ชื่อตัวแปร__}}}</nowiki> เช่นถ้าต้องการกำหนดตัวแปร ชื่อ ชื่อหนังสือ และ ชื่อผู้แต่ง ให้ใส่ <nowiki>{{{ชื่อหนังสือ}}} และ {{{ชื่อผู้แต่ง}}}</nowiki> ในตำแหน่งที่ต้องการให้ตัวแปรนั้นปรากฏออกมา เวลาเรียกใช้ให้แทนค่า ตัวแปร ด้วยข้อความนั้นๆ ตามด้วยเครื่องหมายเท่ากับ = และแบ่งแยกตัวแปรแต่ละตัวด้วย เครื่องหมายขีดตั้ง |
 
 
'''ตัวอย่างเช่น''' แม่แบบสมมุติ ชื่อ ''Template:ป้ายผู้แต่ง1''
โดยมีข้อความภายในแม่แบบนั้นว่า
<nowiki>{{{ชื่อหนังสือ}}}เล่มนี้ แต่งโดย {{{ชื่อผู้แต่ง}}} สำหรับใช้ในการเรียนการสอน</nowiki>
 
เมื่อทำการเรียกใช้ ใช้คำสั่งว่า
<nowiki>{{ป้ายผู้แต่ง1|ชื่อหนังสือ=คลินิกหมอบ้าน|ชื่อผู้แต่ง=ยอดเยี่ยม เทพธรานนท์}}</nowiki>
 
ข้อความแสดง
::''คลินิกหมอบ้านเล่มนี้ แต่งโดย ยอดเยี่ยม เทพธรานนท์ สำหรับใช้ในการเรียนการสอน''
 
หรือ ใช้คำสั่งว่า
<nowiki>{{ป้ายผู้แต่ง1|ชื่อหนังสือ=สถาปัตยกรรม กัมปนาทแห่งความสงัด|ชื่อผู้แต่ง=ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์}}</nowiki>
 
ข้อความแสดง
::''สถาปัตยกรรม กัมปนาทแห่งความสงัดเล่มนี้ แต่งโดย ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์ สำหรับใช้ในการเรียนการสอน''
 
=== ตัวแปรอัตโนมัติ ===
นอกจากกำหนดตัวแปรให้กับแม่แบบ โปรแกรม[[มีเดียวิกิ]] มีตัวแปรที่มาพร้อมกับซอฟต์แวร์ที่เรียกค่าต่างๆ มาใช้ ดังตารางด้านล่าง
 
{|class="wikitable"
! รหัส
! แสดงผล
! ความหมาย
|-
| <nowiki>{{{1}}}</nowiki> || {{{1}}} ||แสดงค่าตัวแปรอับดับ 1 ถ้าไม่ได้กำหนดตัวแปรเฉพาะ
|-
| <nowiki>{{{2}}}</nowiki> || {{{2}}} ||แสดงค่าตัวแปรอันดับ 2 ถ้าไม่ได้กำหนดตัวแปรเฉพาะ
|-
| <nowiki>{{PAGENAME}}</nowiki> || {{PAGENAME}} ||แสดงชื่อหน้านั้นๆ
|-
| <nowiki>{{NAMESPACE}}</nowiki> || {{NAMESPACE}} || แสดงชื่อ[[WP:NS|เนมสเปซ]]
|-
| <nowiki>{{SERVER}}</nowiki> || {{SERVER}} || แสดงชื่อเซิร์ฟเวอร์
|-
| <nowiki>{{SITENAME}}</nowiki> || {{SITENAME}} || แสดงชื่อไซท์
|-
| <nowiki>{{CURRENTYEAR}}</nowiki> || {{CURRENTYEAR}} || แสดงปีปัจจุบัน
|}
<small>ดูตัวแปรทั้งหมดที่</small> วิกิพีเดีย:การแก้ไขหน้า#ตัวแปร
วิธีการเรียกใช้ทำเช่นเดียวกับการเรียกใช้ปกติ โดยใส่ชื่อตัวแปรนั้น เช่น <nowiki>{{PAGENAME}}</nowiki> โดยใช้ตัวพิมพ์ใหญ่ทั้งหมด และสำหรับ ตัวแปรตามลำดับเรียกใช้โดย ใส่ตัวแปรนั้นตามหลังชื่อแม่แบบ โดยแบ่งตามเครื่องหมายขีดตั้ง ในรูปแบบ {{__ชื่อแม่แบบ__|__ตัวแปรอันดับ1__|__ตัวแปรอันดับ2__}
 
 
'''ตัวอย่างเช่น''' แม่แบบสมมุติ ชื่อ ''Template:ป้ายผู้แต่ง2''
โดยมีข้อความภายในแม่แบบนั้นว่า
<nowiki>{{{1}}}เล่มนี้ แต่งโดย {{{2}}} สำหรับใช้ในการเรียนการสอนในปี {{CURRENTYEAR}}</nowiki>
 
เมื่อทำการเรียกใช้ ใช้คำสั่งว่า
<nowiki>{{ป้ายผู้แต่ง2|คลินิกหมอบ้าน|ยอดเยี่ยม เทพธรานนท์}}</nowiki>
 
ข้อความแสดง
::''คลินิกหมอบ้านเล่มนี้ แต่งโดย ยอดเยี่ยม เทพธรานนท์ สำหรับใช้ในการเรียนการสอนในปี {{CURRENTYEAR}}''
 
หรือ ใช้คำสั่งว่า
<nowiki>{{ป้ายผู้แต่ง2|สถาปัตยกรรม กัมปนาทแห่งความสงัด|ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์}}</nowiki>
 
ข้อความแสดง
::''สถาปัตยกรรม กัมปนาทแห่งความสงัดเล่มนี้ แต่งโดย ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์ สำหรับใช้ในการเรียนการสอนในปี {{CURRENTYEAR}}
''
 
ถ้าใช้คำสั่งสลับเป็น
หรือ ใช้คำสั่งว่า
<nowiki>{{ป้ายผู้แต่ง2|ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์|สถาปัตยกรรม กัมปนาทแห่งความสงัด}}</nowiki>
 
ข้อความจะแสดงสลับเป็น
::''ร.ศ.ดร.ทิพย์สุดา ปทุมานนท์เล่มนี้ แต่งโดย สถาปัตยกรรม กัมปนาทแห่งความสงัดสำหรับใช้ในการเรียนการสอนในปี {{CURRENTYEAR}}
''
 
จะเห็นได้ว่า การเรียกใช้ตัวแปรแบบไม่กำหนดค่า จะสะดวกในการเรียกใช้ แต่ในขณะเดียวกันทำให้เกิดความสับสนในเรื่องลำดับของการเรียกใช้ โดยถ้ามีหลายตัวแปร ควรทำการเรียกใช้ตัวแปรแบบกำหนดค่า
 
หากตัวแปรเสริมไม่ได้รับกำหนดค่า ก็จะไม่มีการแทนที่เกิดขึ้น หมายความว่าถ้าไม่มีค่าถูกส่งผ่านสำหรับตัวแปรเสริม {{para|xxx}} ค่าของนิพจน์ <code><nowiki>{{{xxx}}}</nowiki></code> ในแม่แบบจะเป็น "<nowiki>{{{xxx}}}</nowiki>" ตามอักษร ไม่ใช่ 'ว่าง' อย่างที่คุณคาดไว้ คุณสามารถแก้ไขพฤติกรรมแบบนี้ได้โดยการกำหนดค่าตัวแปรเสริมโดยปริยาย ซึ่งทำได้โดยใช้ "วากยสัมพันธ์ไพป์" โดย <code><nowiki>{{{xxx|dflt}}}</nowiki></code> เจาะจงค่าโดยปริยาย <code>dflt</code> สำหรับตัวแปรเสริมมีชื่อ {{para|xxx}} และ <code><nowiki>{{{1|dflt}}}</nowiki></code> เจาะจงค่าโดยปริยาย <code>dflt</code> สำหรับตัวแปรเสริมตัวแรก บ่อยครั้งวากยสัมพันธ์ไพป์ใช้กำหนดค่าโดยปริยายว่าง เช่น <code><nowiki>{{{1|}}}</nowiki></code> หรือ <code><nowiki>{{{xxx|}}}</nowiki></code>
 
[[หมวดหมู่:แม่แบบวิกิพีเดีย|วิธีการสร้างแม่แบบ]]