תבניות

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

  • תבניות הדבקה/תוכן הן כמו Templates ב-Microsoft Word, לדוגמא - הן מיועדות לאפשר יצירה מהירה של מסמך חדש לפי תבנית קיימת, וניתן לשנות כל פרט בהן.
  • תבניות פרמטריות הן שדות באותו Word - התוכן עשוי להשתנות, אבל התבנית (=עיצוב) תמיד נשארת כפי שהיא.

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

תבניות הדבקה

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

נדגים יצירת דף חדש באמצעות תבנית:זכות

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

חשוב לדעת

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

דוגמאות לתבניות הדבקה

ניתן לראות בתבניות תוכן

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

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

טקסט זה מקורו בוויקיפדיה העברית.

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

טקסט זה מקורו בוויקיפדיה העברית.

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

חשוב לדעת

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

דוגמאות לתבניות פרמטריות

ניתן לראות בקטגוריה:תבניות_פרמטריות

לא זה ולא זה

ישנן תבניות מסוימות שמיועדות לתקן באגים קטנים, או להסתיר התנהגויות מאחורי חזות יפה יותר. לדוגמה, התבנית <br> בסה"כ מבצעת ירידת שורה, אולם קוד ה-HTML מוחבא בתבנית וניתן לשינוי.