עריכת הדף "איך ליצור תבנית" (פסקה)

==עריכת תבנית==
ניתן לערוך תבנית קיימת על ידי איתור דף התבנית ולחיצה על "עריכת קוד מקור" בראש הדף, כמו כל דף הפתוח לעריכה בוויקיפדיה.

דרך נוספת לעריכת תבנית היא על ידי עריכת דף המכיל את התבנית: מתחת לאזור העריכה (מתחת לכפתורי השמירה והתצוגה המקדימה), לחיצה על הכותרת "'''תבניות המופיעות בדף זה:'''" תפתח רשימה של כל התבניות המופיעות בדף (גם אלו שלא כלולות וכתובות מפורשות בדף!; דהיינו, תבניות שנמצאות בתוך הקוד של תבניות שכתובות בדף).

{{מסגרת|'''שימו לב:''' יש לקחת בחשבון שהכנסת שינוי בתבנית קיימת תשפיע על דפים רבים, ולכן, יש לוודא היטב שהשינוי לא פוגע בהצגת התבנית או בתפקודה!}}<!-- רעיון-הוספת התבנית בדף התבנית, תחת noninclude ובדיקה בתצוגה מקדימה, כולל עם פרמטרים שונים -->

===סימנים מיוחדים===
סימנים אחדים יש צורך לכתוב בצורה מיוחדת כדי שיופיעו בתוכן תבנית: 

{| class="wikitable"
|-
! הסימן !! אופן כתיבתו בתבנית
|-
| : || <div class="mw-content-ltr"><code>&amp;#58;</code></div>
|-
| ; || <div class="mw-content-ltr"><code>&amp;#59;</code></div>
|-
| * || <div class="mw-content-ltr"><code>&amp;#42;</code></div>
|-
| # || <div class="mw-content-ltr"><code>&amp;#35;</code></div>
|}

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

דרך נוספת היא לעשות שימוש ב[[שפת תגיות|תגית]] {{קוד|<nowiki><nowiki></nowiki>}}.{{דרושה הבהרה|סיבה = נדרשת הרחבה בנושא (או קישור לדף מתאים).}}

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

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

'''שימו לב''': הוספת '''שני''' סוגריים מסולסלים תוביל ליצירת תבנית חדשה נוספת, ועל כך יש להקפיד ולספור היטב את מספר הסוגריים). דוגמה לצורת כתיבת פרמטר:
:<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>{{שם תבנית|חיה=חתול|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>תוצאה: {{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}

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

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

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

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

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

'''המלצה:''' ככלל, מאחר שאת דף התבנית נהוג לפתוח ישר עם קוד התבנית (לפני התיעוד והוראות השימוש), מומלץ לפתוח כל כתיבת תבנית בתגית <code><nowiki>‎<includeonly>‎</nowiki></code>.

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

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

הכלי הראשון מאוד פשוט לשימוש: בעת עריכת תבנית, מתחת לכפתורי השמירה בתחתית העמוד תופיע תיבה נוספת תחת הכותרת "תצוגה מקדימה של הדף עם התבנית הזאת". בתיבה זו יש שדה יחיד – "כותרת הדף", שבו ניתן להזין שם של ערך או דף בו התבנית נמצאת בשימוש ולראות כיצד השינוי שנעשה בה משתקף ומשפיע על הדף.

:למידע נוסף והוראות שימוש גם בכלי השני, ראו בדף הערך המורחב: "[[עזרה:ארגז חול לתבניות]]".

===טבלאות===
{{להשלים|סיבה=הדוגמאות המובאות מסובכות מידי. יש להוסיף בכל שורה הסבר על מרכיביה ותפקידם}}
{{הפניה לערך מורחב|עזרה:טבלאות}}

פעמים רבות, יש צורך ליצור טבלה בתוך תבנית, אך לעתים, יש גם צורך להסתיר את התאים שאינם בשימוש. לפני קריאת פרק זה, מומלץ להכיר כיצד לבנות [[עזרה:טבלאות|טבלאות]] בשפת ויקי.

{| class="wikitable" align="left"
! colspan="2" | {{{שם הסרט}}}
|-
| ז'אנר || {{{ז'אנר}}}
|-
| אורך || {{{אורך}}}
|-
| תאריך השקה || {{{תאריך השקה}}}
|-
| colspan="2" style="text-align: center;" | {{{אתר אינטרנט}}}
|}
הטבלה משתמשת בשני אמצעים עיקריים: בתבנית <code><nowiki>{{!}}</nowiki></code>, שמציגה קו אנכי (<code><nowiki>|</nowiki></code>) ובמשפט תנאי מסוג <code><nowiki>{{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}}</nowiki></code> (ראו סעיף "[[עזרה:תבניות|בדיקת קיום פרמטר]]").

נמחיש כיצד לבנות טבלה מסודרת באמצעות דוגמה: אנו מעוניינים ליצור את הטבלה שמשמאל עבור ערכי סרטים. כפי שניתן לראות, כל התאים בטבלה זו מוצגים. כעת נשנה את כל הפרמטרים, מלבד הפרמטר "שם הסרט", כך שאם יהיו ריקים, לא תוצג השורה שלהם כלל.

{{*}}עבור כל שורה שבה שתי עמודות, יש להשתמש בקוד הבא:
:<code><nowiki>{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |</nowiki></code>
:<code><nowiki>{{!}} פרמטר</nowiki></code>
:<code><nowiki>{{!}} {{{פרמטר}}}</nowiki></code>
:<code><nowiki>{{!}}-</nowiki></code>
:<code><nowiki>}}</nowiki></code>
כאשר את הכיתוב "פרמטר" יש לשנות לשם הפרמטר.

{{*}}בשורה האחרונה, עם הפרמטר "אתר אינטרנט", ישנה עמודה אחת בלבד, שתוכנה מיושר לאמצע. עבור שורות מסוג זה, נשתמש בקוד הבא:
:<code><nowiki>{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |</nowiki></code>
:<code><nowiki>{{!}} colspan="2" סגנון {{!}} {{{פרמטר}}}</nowiki></code>
:<code><nowiki>{{!}}-</nowiki></code>
:<code><nowiki>}}</nowiki></code>
כאשר את הכיתוב "פרמטר" יש לשנות לשם הפרמטר, ואת הכיתוב "סגנון" יש להחליף ב[[עזרה:טבלאות|סגנון]] הרצוי; במקרה שלנו - יישור לאמצע.

{{*}}לבסוף, לגבי הפרמטר הראשון, נשתמש בברירת המחדל, כך שאם לא ניתן שם הסרט, נשתמש בשם הערך במקום. הקוד המלא לדוגמה זו ותוצאותו, להלן:
{| border="1" align="left"
|
:<code><nowiki>{| class="wikitable" align="left"</nowiki></code>
:<code>! colspan="2" | <nowiki>{{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}</nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} ז'אנר</nowiki></code>
:<code><nowiki>{{!}} {{{ז'אנר}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} אורך</nowiki></code>
:<code><nowiki>{{!}} {{{אורך}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} תאריך השקה</nowiki></code>
:<code><nowiki>{{!}} {{{תאריך השקה}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}} </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>|}</nowiki></code>
|
{| class="wikitable" align="left"
! colspan="2" | {{{שם הסרט| {{שם הדף}} }}}
{{!}}- 
{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} | 
{{!}} ז'אנר
{{!}} {{{ז'אנר}}} 
{{!}}- 
}}
{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} | 
{{!}} אורך
{{!}} {{{אורך}}} 
{{!}}- 
}}
{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} |  
{{!}} תאריך השקה
{{!}} {{{תאריך השקה}}} 
{{!}}- 
}}
{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} | 
{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}} 
}}
|}
|}

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