עריכת הדף "עזרה:תבניות" (פסקה)

===הגדרת פרמטרים לתבנית ===
ניתן ליצור תבניות פשוטות, הכוללות טקסט מוגדר קבוע וללא אפשרות של המשתמש להשפיע על תוכנן ואופן הצגתן. אפשרות מתקדמת יותר היא ליצור תבניות בעלות פרמטרים, לשימוש כללי יותר, שניתן להשפיע על תוכנן או עיצובן באופן שונה בכל דף בו מופיעה התבנית (ליתר דיוק – בכל 'מופע' של התבנית, מאחר שאותה תבנית יכולה לשמש ולהופיע מספר פעמים באותו הדף). אופן יצירת תבנית פרמטרית זהה ליצירת תבנית רגילה, ולפיכך, יש לבצע את כל השלבים המתוארים בסעיף "[[עזרה:תבניות#יצירת תבנית חדשה|יצירת תבנית חדשה]]". ישנם שני סוגי פרמטרים: פרמטר שמי ופרמטר מספרי.

====פרמטר שמי====
לאחר שנוצר דף התבנית, יש לכתוב בתוכה שם לפרמטר, כאשר הוא ממוקף ב'''שלושה''' סוגריים מסולסלים משני צדדיו {{קוד|{{{ }}}}}.

'''שימו לב''': הוספת '''שני''' סוגריים מסולסלים תוביל ליצירת תבנית חדשה נוספת, ועל כך יש להקפיד ולספור היטב את מספר הסוגריים). דוגמה לצורת כתיבת פרמטר:
:<code><nowiki>{{{שם הפרמטר}}}</nowiki></code>

השימוש בפרמטר בדף היעד ייעשה על פי הסדר הבא:

# שני סוגריים מסולסלים פותחים (ימניים) ({{קוד|<nowiki>}}</nowiki>}})
# שם התבנית
# תו מפריד - קו ניצב (<code>|</code>)
# שם הפרמטר
# הסימן שווה (<code>=</code>)
# ערך הפרמטר
# שני סוגריים מסולסלים סוגרים (שמאליים) ({{קוד|<nowiki>{{</nowiki>}})
עבור כל פרמטר נוסף, יש לחזור על השלבים 3–6.

תחביר לדוגמה של תבנית עם שלושה פרמטרים:
:<code><nowiki>{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}</nowiki></code>

דוגמה מעשית של תבנית עם שני פרמטרים:
:<code><nowiki>{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}</nowiki></code>

ניתן לפרוס את הטקסט הנ"ל גם במאונך, במקרה שישנם פרמטרים רבים או שערכיהם ארוכים, על מנת לשפר את קריאות הקוד ולהקל על ההתמצאות בה. אין לכך שום השפעה על התוצאה ואופן הצגתה הסופי של התבנית. מומלץ לדאוג שהקווים המפרידים (<code>|</code>) ימוקמו בתחילת כל שורה של פרמטר. תחביר לדוגמה:

<pre>
{{שם תבנית
|פרמטר1=ערך1
|פרמטר2=ערך2
|פרמטר3=ערך3
}}</pre>

====פרמטר מספרי====
ניתן לכתוב ולהוסיף לתבנית פרמטרים גם ללא שם. במקרה כזה, יש לתת לכל פרמטר מספר סידורי, שיופיע תחום בין שלושה סוגריים מסולסלים. לדוגמה:
:<code><nowiki>{{{1}}}</nowiki></code>

בתבנית בה מופיעים הפרמטרים <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code> ו-<code><nowiki>{{{3}}}</nowiki></code>, צורת הכתיבה הרגילה בדף היעד (להוציא מקרים מיוחדים (ראו בהמשך)) '''לא''' תהיה:

:<code><nowiki>{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}</nowiki></code>
אלא:
:<code><nowiki>{{שם תבנית|ערך1|ערך2|ערך3}}</nowiki></code>

לדוגמה:
:<code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים}}</nowiki></code>

החסרון בשימוש בתבנית כזו הוא שבריבוי פרמטרים, קשה לזכור מה ייעודו ומיקומו הנכון של כל פרמטר, וקל להתבלבל בסדר. מאידך, תבנית זו מהירה יותר לשימוש (יש פחות תווים להקלדה) וחוסכת "ביורוקרטיה" מיותרת. מומלץ להשתמש בצורה זו רק כאשר יש שימוש בפרמטרים ספורים. חסרון נוסף בשימוש בפרמטרים מספריים הוא שלא ניתן להזין את הסימן שווה (<code>=</code>). לדוגמה, בתבנית <code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים=butterfly family}}</nowiki></code> אין פרמטרים שמיים, ואולם, התבנית תתייחס ל-"משפחת הפרפרים" כאל שם של פרמטר, ול-"butterfly family" כאל הערך שמוזן לו, אך היא כמובן לא תמצא פרמטר בשם "משפחת הפרפרים" ותחזיר הודעת שגיאה. כדי לעקוף בעיה זו, ניתן להזין את הקוד הבא במקום סימני שווה:
:<code>&amp;#61;</code>
או להשתמש בתבנית ששמה "=":
:{{קוד|{{תב|{{=}}}}}}
לחלופין, ניתן להתייחס לפרמטר המספרי כאילו היה פרמטר שמי, ולציינו במפורש בעת השימוש בתבנית: <code><nowiki>{{חדש|פרפר.jpg|</nowiki>{{כ}}2<nowiki>=משפחת הפרפרים = butterfly family}}</nowiki></code>

ניתן לשלב בתבנית אחת פרמטרים שמיים ופרמטרים מספריים ביחד. לדוגמה:
:<code><nowiki>{{שם תבנית|חיה=חתול|2=שחור|מין=זכר|מבוית}}</nowiki></code>

====הגדרת ברירת מחדל לפרמטר====
ניתן להגדיר [[ברירת מחדל]] לפרמטר, כך שאם לא יוכנס ערך לפרמטר, יופיע טקסט ברירת המחדל. כדי להגדיר ברירת מחדל לפרמטר כלשהו, לדוגמה, ל-<code><nowiki>{{{שם הסרט}}}</nowiki></code>, יש להוסיף קו אנכי (<code>|</code>) אחרי שם הפרמטר ולאחריו את טקסט ברירת המחדל באופן הבא:
:<code><nowiki>{{{שם הסרט|טקסט ברירת מחדל}}}</nowiki></code>
דוגמה נפוצה לשימוש בברירת המחדל היא באמצעות שימוש בתבניות קבועות של המערכת, כגון <code><nowiki>{{שם הדף בלי הסוגריים|}}</nowiki></code> המחזיר את שם הדף. הקוד:
:<code><nowiki>{{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}</nowiki></code>
מאפשר לעורכים למלא את שם הסרט, ואם פרמטר זה נותר ריק, ישמש שם הדף (בלי הסוגריים) במקומו של הפרמטר.

====בדיקת קיום פרמטר====
{{הפניה לערך מורחב|עזרה:הוראות תנאי#תנאי}}

כדי לבדוק האם לתבנית הוזן פרמטר, ניתן לעשות בדיקה באמצעות [[עזרה:הוראות תנאי|הוראת התנאי]] הבא:
<div class="mw-content-ltr">
:<code><nowiki>{{#if: {{{param|}}} | Hooray...! | Darn...! }}</nowiki></code>
תוצאה: {{#if: {{{param|}}} | Hooray...! | Darn...! }}
</div>

או בעברית:
:<code><nowiki>{{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}</nowiki></code>תוצאה: {{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}

בפרמטר הראשון מקבלים את התוצאה כאשר יש ערך, ובפרמטר השני כאשר אין ערך.

==== שינוי פרמטרים בתבנית קיימת ====
{{מסגרת|'''שימו לב:''' במקרה שמשנים בתבנית קיימת את מספר הפרמטרים, או שמשנים את הסדר שלהם, השינוי יבוא לידי ביטוי בכל הדפים שבהם הוכנסה התבנית לפני השינוי, וזה עלול ליצור תוצאות לא צפויות ובלתי רצויות, כגון: הוצאת דברים מהקשרם, הופעת טקסט מיותר, הפרעות בפריסת התבנית והטקסט ואף שגיאה ואי-הצגה מוחלטת של התבנית.
כדאי לתת על כך את הדעת בכובד ראש בזמן שמשנים את התבנית, ובכך ניתן למנוע את הבעיה לפני שנוצרה. לפי [[עזרה:תפריט ראשי|כללי חב"דפדיה]], גם נדרש להתייעץ על כך ב[[חב"דפדיה:תבנית/אולם דיונים]].}}

====הגדרת תבנית כפרמטר====
במקרה שיש פרמטרים החוזרים על עצמם במספר תבניות, או בחלק מורכב טכנית (כגון מפת מיקום), ניתן ליצור תבנית חדשה שתשמש כפרמטר ובכך תקל על המשתמשים בתבנית. התבנית החדשה היא למעשה [[מודול (תוכנה)|מודול]], מעין "קופסה שחורה" שאפשר להכניס לה פרמטרים ולא מעניין את המשתמשים איך היא עובדת. התבנית המקבלת תבנית כפרמטר מכונה תבנית מודולרית (לדוגמה: התבנית המודולרית {{תב|משגר}} עם המודול {{תב|שלב במשגר}}).