שימוש בתבניות

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

השימוש בתבנית דומה ליצירת קישור, אך במקום להוסיף שני זוגות של סוגריים מרובעים משני צידה המילה משתמשים בשני זוגות של סוגריים מסולסלים. כלומר לא ([[כך]]), המייצר קישור פנימי, אלא ({{כך}}).

ניתן להעתיק בצורה זו את תוכנו של כל דף ששמו מתחיל בתבנית:.

כך למשל הקוד {{יוחנן}} יציג בתוך העמוד את תוכנו של הדף שכותרתו תבנית: יוחנן.

יצירת תבנית פשוטה

כדי ליצור תבנית חדשה, כתבו במקום כלשהו, למשל, במקום שבו תהיה התבנית החדשה, את הטקסט הבא:

{{שם התבנית החדשה}}

או:

[[תבנית:שם התבנית החדשה]]

כאשר במקום "שם התבנית החדשה" יש לכתוב את שם התבנית. רצוי שלשם תהיה משמעות.

לאחר שעשיתם זאת, שמרו את הדף ותקבלו קישור אדום כזה:

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

מומלץ להוסיף בתחתית הדף את הטקסט: <noinclude> [[קטגוריה: תבניות]] </noinclude>

כדי להוסיף את התבנית החדשה לרשימת התבניות.

דוגמה

אם רוצים לכתוב תבנית תחת השם "יוחנן" יש לכתוב:

[[תבנית: יוחנן]]

לאחר הכתיבה מקבלים את התוצאה הבאה: תבנית: יוחנן

לחיצה על הקישור תפתח דף עריכה חדש. יש לערוך אותו כמו כל דף רגיל, ולשמור בסיום העריכה.

בכל מקום בו יש להוסיף את תבנית, יש לכתוב את הטקסט:

{{יוחנן}}

כדי לערוך את תוכנה של תבנית קיימת, אפשר לעשות זאת על ידי עריכת דף המכיל את התבנית: מתחת לאזור העריכה תופיע רשימה של תבניות המופיעות בדף. שימו לב כי קישור מהצורה {{שם התבנית החדשה}} ישתיל את תוכן התבנית בדף בעוד קישור מהצורה [[תבנית:שם התבנית החדשה]] יוביל לדף התבנית.

התייחסות לדף רגיל כאל תבנית

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

{{:שם הדף}}

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

{{:אמצעי חיכוך}}

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

יצירת תבנית פרמטרית

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

פרמטר שמי

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

{{{פרמטר1}}}

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

• שם התבנית
• תו מפריד (|)
• שם הפרמטר
• הסימן =
• ערך הפרמטר.

דוגמה

תחביר:

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

דוגמה מעשית:

{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}

ניתן לפרוס את הטקסט הנ"ל במאונך, אם ישנם פרמטרים רבים. תחביר:

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

פרמטר מספרי

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

{{{1}}}

בתבנית בה מופיעים הפרמטרים {{{1}}}, {{{2}}} ו־{{{3}}} צורת הכתיבה בדף היעד לא תהיה:

{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}

אלא:

{{שם תבנית|ערך1|ערך2|ערך3}}

לדוגמה:

{{חדש|פרפר.jpg|משפחת הפרפרים}}

החסרון בשימוש בתבנית כזו הוא שבריבוי פרמטרים, קשה לזכור מה יעודו של כל פרמטר, וקל להתבלבל בהם. מומלץ להשתמש בפרמטר זה רק כאשר יש שימוש בפרמטרים ספורים. חסרון נוסף בשימוש בפרמטרים מספריים הוא שלא ניתן להזין את הסימן שווה (=). לדוגמה, בתבנית {{חדש|פרפר.jpg|משפחת הפרפרים = butterfly family}} אין פרמטרים שמיים, ואולם, התבנית תתייחס ל-"משפחת הפרפרים" כאל שם של פרמטר, ול-"butterfly family" כאל המידע שמוזן לו. כדי לעקוף בעיה זו, ניתן להזין את הקוד הבא במקום סימני שווה:

=

לחלופין, ניתן מלכתחילה להגדיר את התבנית עם פרמטרים שמיים. כלומר, התבנית {{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים = butterfly family}} תעבוד מצוין.

ניתן "לערבב" בתבנית אחת את הפרמטרים מסוג שם ומסוג מספר ביחד.

שינויי פרמטרים בתבנית קיימת

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

כדאי לתת על כך את הדעת בזמן שמשנים את התבנית ובכך ניתן למנוע את הבעיה לפני שנוצרה.

הגדרת ברירת מחדל לפרמטר

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

{{{שם הסרט|טקסט ברירת מחדל}}}

דוגמה נפוצה לשימוש בברירת המחדל היא באמצעות שימוש בתבניות קבועות של המערכת, כגון {{שם הדף}} המחזיר את שם הדף. הקוד

{{{שם הסרט| {{שם הדף}} }}}

מאפשר לעורכים למלא את שם הסרט, ואם פרמטר זה נותר ריק, ישמש שם הדף במקומו של הפרמטר.

ס:

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

{{ס:@}}

במילים אחרות, מדובר בפעולה הזהה להעתקת תוכן התבנית בעזרת "העתק-הדבק".

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

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